create-bro-framework

Scaffold production-ready bro.js applications in seconds.

create-bro-framework is an interactive CLI for generating either a lightweight Node.js backend or a full-stack Next.js App Router application with bro.js configured and ready to run.

Quick Start

npx create-bro-framework bro-app

The CLI asks you to choose:

1. Standard Node.js Backend
2. Next.js App Router

You can also choose JavaScript or TypeScript during setup.

Then start your project:

cd my-app
npm run dev

What You Get

Standard Backend

• File-based routing in routes/
• Zod-powered request validation
• Authentication, rate limiting, and optional Redis support
• Localization with locale/
• Background cron examples in tasks/
• Socket.IO support through ctx.io
• An environment-specific agent.md for Cursor, Claude, Antigravity, and other coding agents

Next.js App Router

• NextJS App with ESLint, Tailwind, src/, and App Router
• bro-framework/next factory in src/lib/
• Sample API route with caching and rate limiting
• Native Web File upload support
• Localization in src/locale/
• Serverless-friendly configuration
• An environment-specific agent.md with AI coding rules

Requirements

• Node.js 18 or newer
• npm

Options

Pass the target directory as the first argument. If omitted, the CLI uses my-bro-api.

npx create-bro-framework                    # creates ./my-bro-api
npx create-bro-framework services-api       # creates ./services-api

The CLI also exposes the create-bro-app command when installed globally:

npm install --global create-bro-framework
create-bro-app my-app

Learn More

• bro.js documentation
• bro.js repository