Umbral Playground

A mini-Postman baked right into your app. Umbral Playground lets anyone browse your REST resources, build a request, send it, and read the response — no external tool, no copy-pasting curl commands into a terminal. It's the fastest way to hand an API to a frontend teammate: point them at a URL and they're exploring live endpoints in seconds, against the real running server.

Install

cargo add umbral-playground   # sits alongside umbral-rest / umbral-openapi

Wire it up

Give it a title and the path to mount at.

use umbral::prelude::*;
use umbral_playground::PlaygroundPlugin;

let app = App::builder()
    .database("default", pool)
    .plugin(RestPlugin::default().resource(/* ... */))
    .plugin(OpenApiPlugin::new())
    .plugin(PlaygroundPlugin::new("Acme API").at("/api/playground/"))
    .build()?;

Target: onboard a frontend dev in one link

Instead of maintaining a Postman collection, send the playground URL — it discovers resources from the running server, so it's never stale.

What you get

• Browse resources, build and send requests in the browser
• Read live responses against the real server
• Auth auto-detected from the published OpenAPI securitySchemes
• Mount anywhere with .at("/path/")
• Zero external tooling to install or keep in sync