Playground

The Playground mode provides an in-browser IDL editor with multi-language code generation. Write IDL definitions and instantly generate client and server code—no installation required.

Overview

Playground Default View

The Playground offers:

Getting Started

1. Start the Web UI

./target/pulserpc -ui -ui-port 8080

Open your browser to http://localhost:8080 and click the Playground button.

2. Write Your IDL

The playground starts with a sample IDL. Edit it directly in the editor:

IDL Editor

The editor features:

3. Validate Your IDL

Click Validate to check your IDL for errors. Validation issues are displayed in a panel below the editor:

Validation Error

Generating Code

1. Select a Runtime

Choose your target language from the dropdown:

Language Selector

Supported runtimes:

2. Generate Code

Click Generate Code to create your server and client files.

3. Browse Generated Files

The file tree on the left shows all generated files:

File Tree

Each runtime generates:

4. View Generated Code

Click any file in the tree to view its contents:

Code Viewer

The code viewer provides:

Downloading Code

Download Individual Files

Right-click any file in the tree and select Save Link As to download individual files.

Download Complete Project

Click the Download ZIP button to get a complete archive:

Download Button

The ZIP includes all generated files plus the runtime library, ready to use immediately.

Session Management

The playground automatically manages sessions:

Use Cases

Prototyping APIs

Quickly sketch out service interfaces without leaving your browser:

namespace example

service Calculator {
    float add(float a, float b)
    float multiply(float a, float b)
}

Learning PulseRPC

Experiment with IDL syntax and see how it translates to code in different languages.

Code Generation Without Installation

Generate PulseRPC code even when you don’t have the CLI installed locally.

Sharing Examples

Create a playground session and share the URL with your team for collaboration.

Tips

Next Steps