Generate beautiful, interactive API playgrounds from OpenAPI specifications.

DEMO

Prerequisites:

• Node.js 18+

Generate a playground instantly:

npx madrasly <spec-file> <output-directory>

Example:

npx madrasly examples/coingecko-spec.json my-playground
cd my-playground
pnpm install
pnpm dev

You can install the CLI globally for repeated use:

npm install -g madrasly

madrasly <spec-path> <output-path> [options]

Available Aliases:

• madrasly
• madras

Options:

• --force: Force overwrite of existing output directory
• --api-key KEY: Pre-configure API key (stores in .env, hides auth field from users)
• --theme THEME: Set default theme (light, dark, or coffee)
• --workspace-image URL|FILE: Workspace logo/image
• --no-interactive: Skip interactive prompts
• --popular-endpoints ENDPOINTS: Comma-separated list of endpoints to display prominently

See CONTRIBUTING.md for guidelines.

MIT