GitHub - madrasly/madrasly: Auto-generate interactive API playgrounds from OpenAPI specs. Get developers calling your API in seconds.

1 min read Original article ↗

npm downloads npm version GitHub stars GitHub forks License

OpenAPI Playground Generator

Generate beautiful, interactive API playgrounds from OpenAPI specifications.

DEMO

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:

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