OpenAPI Playground Generator
Generate beautiful, interactive API playgrounds from OpenAPI specifications.
DEMO
Quick Start
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 devUsage
Installation (Optional)
You can install the CLI globally for repeated use:
Generate Playground
madrasly <spec-path> <output-path> [options]
Available Aliases:
madraslymadras
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, orcoffee)--workspace-image URL|FILE: Workspace logo/image--no-interactive: Skip interactive prompts--popular-endpoints ENDPOINTS: Comma-separated list of endpoints to display prominently
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT