Test, mock, benchmark, and document APIs from one workspace.

Layang is a workspace-based API workbench for REST, WebSocket, gRPC, and gRPC-Web. Build requests, run local mocks, inspect responses, benchmark latency, generate docs, and automate checks from one portable workspace.

Download release Star on GitHub 5

layang run ./workspace --env dev --reporter junit

Layang desktop app screenshot showing the protobuf and request workbench

Workspace Portable project folder

Proto files, requests, docs, mocks, environments, and history stay together.

API workbench Test, mock, and document APIs

Send REST, WebSocket, gRPC, and gRPC-Web requests, create mock scenarios, save examples, and generate docs from one workspace.

Feature set

Built around REST, WebSocket, and gRPC workflows.

Import proto files, create REST and WebSocket requests, save examples, benchmark latency, generate docs, and keep everything in a workspace folder.

Native gRPC and gRPC-Web

Run unary and server-streaming calls with request bodies, metadata, response history, trailers, and test assertions.

target: localhost:50051
method: demo.v1.GreeterService/SayHello
transport: native-grpc

REST

Build REST requests with params, headers, auth, body modes, local mocks, scenario matching, response templates, logs, docs, and examples.

WebSocket

Create WebSocket requests, connect to ws/wss endpoints, send messages, inspect events, mock responses, benchmark latency, and publish docs.

Proto registry

Browse imported `.proto` files, services, methods, request messages, and response messages.

Benchmarks

Run latency samples and export benchmark JSON reports for active methods.

Generated docs

Create Markdown or HTML documentation from proto files, examples, mocks, and latest responses.

CI automation

Validate workspaces, list saved requests, check mocks, and run native gRPC requests from the CLI.

WebSocket

WebSocket workflows live beside REST and gRPC.

WebSocket collections support live client testing, desktop-managed mock responses, benchmark exports, and generated docs as part of the official 1.0.4 release.

Layang WebSocket screenshot showing request and live event workflow — WebSocket workbench with connection controls, live events, request messaging, and workspace-backed testing flow.

Area Status What is included

Client Ready Open ws/wss connections, send payloads, and inspect live events.

Mocking Ready Run a local desktop WebSocket mock server and send responses to connected clients.

Docs and reports Ready Publish WebSocket docs and export benchmark data from the active workspace.

REST

REST requests, mocks, docs, and examples are first-class.

Build REST collections with params, headers, auth, body modes, local mock scenarios, request matching, response templates, logs, generated docs, and saved examples.

Request builder

Compose methods, URLs, path params, query params, headers, auth, JSON, text, and form bodies from the workspace.

Mock scenarios

Match by path, query, headers, body text, or JSON path, then return templated responses with delays and priority.

Docs and logs

Save REST examples, publish generated docs, and review recent matched or missed mock requests.

Workspace folder

Your API project is stored as readable files.

The desktop app can create or open a workspace folder. A workspace stores a snapshot plus Git-friendly files under folders such as `protos/`, `requests/`, `examples/`, `docs/`, `environments/`, `history/`, and `mocks/`.

One workspace folder Per-method mock scenarios Portable workspace export CLI-ready project files

Documents/Layang/Workspace

protos/
 demo/v1/greeter.proto
requests/
 tabs.json
 items/
examples/
 examples.json
docs/
 published-docs.json
 saved-results.json
mocks/
 mock-server.json
 scenarios/
environments/
 environments.json
history/
 history.json

Mocking and streaming

Edit streaming mock scenarios visually.

Enable mock behavior per method, choose active scenarios, and tune stream intervals, loop mode, and response sequences from the app.

Layang mock streaming editor screenshot — Mock streaming editor with per-method scenarios, selected active response, and stream controls.

01Per-method scenarios

Keep mock behavior focused by storing scenario files per RPC method.

02Streaming controls

Set interval, loop behavior, and max loops for server-streaming responses.

03Local mock server

Run a desktop-managed mock server for local clients and integration work.

04Workspace files

Scenario JSON/YAML stays in the same portable workspace as requests and docs.

Documentation

Generate docs from the work you already saved.

Layang can generate Markdown or HTML docs using proto metadata, saved examples, mock scenarios, and the latest saved responses.

Proto reference Service, method, request, response, and source `.proto` information.

Examples and responses Saved request examples and latest responses become readable docs sections.

Static publishing Export docs for a static site or keep them inside the workspace folder.

Layang generated documentation preview screenshot — Generated documentation preview for a selected method.

CLI

Run the same workspace in automation.

Keep desktop exploration and CI checks aligned. The CLI reads the same workspace files that the app writes.

layang validate ./workspace --json
layang list ./workspace
layang run ./workspace \
 --env dev \
 --reporter junit \
 --output reports/layang-junit.xml
layang mock:check ./workspace

Validate Check workspace structure, request files, proto availability, and mock scenario files.

Run Execute saved native gRPC requests with clear exit codes for CI/CD.

Report Output spec, JSON, or JUnit reports for build pipelines.

Start with a proto file

Build a complete API workspace in Layang.

Create REST, WebSocket, gRPC, and gRPC-Web requests, run local mocks, generate docs, benchmark methods, and automate checks in CI.

Download release Star on GitHub 5