Skip to main content

Ecosystem

BurgerAPI keeps a small core and ships optional packages under ecosystem/:

ecosystem/
├── hooks/ # Request lifecycle factories (CORS, logger, rate-limiter, ...)
├── plugins/ # Application extensions (JWT, session, env, ...)
└── skills/ # AI agent skills
FolderRole
hooks/Compose in src/hooks.ts or route hooks.ts
plugins/Register in src/plugins.ts
skills/Help AI tools understand BurgerAPI projects

Hooks control the request lifecycle. Plugins extend the application. They are separate concepts.

CLI​

burger-api list
burger-api add cors
burger-api add logger
burger-api skills install

Packages install into ecosystem/hooks/ or ecosystem/plugins/ as appropriate.

Authentication​

Authentication is implemented through official ecosystem plugins that integrate with BurgerAPI's hook system and route config.ts. The framework core stays auth-agnostic.

Agent skills​

burger-api skills install
burger-api skills list
burger-api skills available

Skills install to .agents/skills/<name>/ and .claude/skills/<name>/. Claude Code reads .claude/skills/; agents that support the Agent Skills standard (OpenCode, Codex, and others) read .agents/skills/. See AI Agent Skills.