BananaJSAI-first, DDD-ready Node.js framework

DX · Express · Plugins · CLI · Type-safe APIs

AI-first CLI & codegen

Turn specs and prompts into working endpoints and modules—generate code, improve docs, and review quality from the CLI so routine API work does not eat your week.

AI docs

✨

DX — calm and productive

Developer experience matters—one consistent way to declare routes, validate input, shape responses, and surface errors: less boilerplate, fewer surprises, faster iteration on real product logic.

Core concepts

🧱

DDD as a destination

Keep business rules and use cases understandable and testable—structure grows with your product instead of turning into a flat pile of handlers.

Architecture guide

🔌

Deeply extendable

Add databases, realtime, observability, and other integrations when you need them—the core stays lean while you opt into heavier pieces.

Plugin docs

🤖

MCP server

`bjs mcp start` exposes the full BananaJS CLI as a Model Context Protocol server—9 typed tools available natively in Cursor, Claude Desktop, and any MCP-compatible IDE. No copy-pasting terminal commands, no context switching.

MCP docs

📄

Automatic Swagger docs

Your decorators are the spec. The OpenAPI doc your consumers read is built live from the same code your server runs—so the contract never drifts, and you never write YAML.

OpenAPI docs

Exceptional DX on Express — structure and automation for teams that want clear APIs and a path to domain-driven design, with a CLI that fits how modern teams work—without dragging in a heavyweight runtime.

Why BananaJS

Not a thin wrapper around Express — a deliberate stack for teams who want great DX, structure, automation, and maintainable domains without adopting a monolithic platform. Invest in tooling so you spend time on product behavior, not repetitive files. Plugins let capabilities grow without bloating the core.

Philosophy · Layered architecture · Recipes

Learning path

🐣 New to BananaJS

Ship something in your first session.

Quickstart — a running API in 5 min
Full setup & CLI — scaffold and project layout
Core concepts — controllers, validation, responses
Error types — the typed error toolkit

🔨 Building a real feature

Make it production-shaped.

Modules & DI — createModule, scoped containers
Authentication — guards, @Auth, @Roles
Caching — @Cache, @CacheEvict, custom store
Security — rate limiting, ABAC, sanitization
Recipes — runnable example apps

🏗️ Going deep

Architecture, performance, plugin authoring.

Advanced concepts — full BananaAppOptions surface
Layered architecture — DDD modules, CLI scaffold
Domain & persistence — ports, adapters, ORMs
Testing — BananaTestApp, testOverrides
Multi-tenancy — tenant isolation patterns
Writing a plugin — async lifecycle, DI integration

🤖 AI & MCP

Let your IDE agent do the heavy lifting.

AI overview — bjs ai commands and the PRPAV pipeline
AI codegen — generate modules and endpoints from text
AI review — structured findings for CI
MCP server — bjs mcp start, 9 tools in Cursor and Claude Desktop
AI context — publish conventions to every teammate's agent