madrasly Code
Auto-generate interactive API playgrounds from OpenAPI specs.
Brought to you by:
realfishsam
Menu
▾
▴
Tree [d26d3c] main / History
GitHub Action
Samuel EF. Tinnerholm
Read Me
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 dev
Usage
Installation (Optional)
You can install the CLI globally for repeated use:
npm install -g madrasly
Generate Playground
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
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT
