Rockets Starter

A full-stack monorepo boilerplate built with Turborepo, featuring NestJS 11 backend and Next.js frontend.

🚀 Quick Start

# Install dependencies
yarn install

# Configure environment
cp apps/api/.env.example apps/api/.env

# Run development servers
yarn dev

# Build all applications
yarn build

📦 What's Inside

This monorepo includes the following packages and applications:

Applications

• api: NestJS 11 backend server with TypeORM and PostgreSQL (runs on port 3001)
• web: Next.js frontend application with TypeScript and Tailwind CSS (runs on port 3000)

Packages

• typescript-config: Shared TypeScript configurations for different environments
• eslint-config: Shared ESLint configurations for Next.js and NestJS

🏗️ Project Structure

rockets-starter/
├── apps/
│   ├── api/          # NestJS backend
│   └── web/          # Next.js frontend
├── development-guides/     # README only — guides, skills, agents: btwld/skills
├── packages/
│   ├── typescript-config/  # Shared TypeScript configs
│   └── eslint-config/      # Shared ESLint configs
├── package.json
└── turbo.json

🛠️ Available Scripts

• yarn dev - Start all applications in development mode
• yarn dev:api - Start only the API
• yarn dev:web - Start only the Web app
• yarn build - Build all applications for production
• yarn lint - Lint all applications
• yarn type-check - Run TypeScript type checking
• yarn clean - Clean all build artifacts

🔧 Technology Stack

Backend (API)

• NestJS 11: Progressive Node.js framework
• TypeORM: Object-relational mapping
• PostgreSQL: Relational database for development
• Swagger: API documentation

Frontend (Web)

• Next.js 16: React framework with App Router
• TypeScript: Type safety
• Tailwind CSS: Utility-first CSS framework
• ESLint: Code linting

Development Tools

• Turborepo: Monorepo build system
• Yarn Workspaces: Package management
• TypeScript: Shared type definitions
• ESLint: Code quality

AI & programmability

For better AI-assisted development (Claude Code, Cursor), we recommend:

Type	Tool	Purpose
MCP	Context7	Up-to-date framework docs (NestJS, Next.js, TypeORM) in context
Plugin	Frontend Design	Production-grade UI generation for apps/web
Plugin	Code Review, GitHub	PR review and repo management (Claude Code marketplace)

Full setup: see AI_PLUGINS_AND_MCP.md in btwld/skills. For AI task routing, see AGENTS.md. Guides, skills, commands and agents live in btwld/skills — install the plugin or clone and copy; development-guides/README.md in this repo has the link and copy instructions.

🚀 Getting Started

1. Clone and install

   git clone <repository-url>
   cd rockets-starter
   yarn install

2. Start development

   yarn dev

3. Access applications

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:3001

🏭 Production Build

# Build all applications
yarn build

# Start production servers
cd apps/api && yarn start:prod
cd apps/web && yarn start

📝 Next Steps

Rockets Starter already includes authentication (Rockets Auth), ACL, and user/role modules. Consider:

• Adding new feature modules (see AGENTS.md and btwld/skills for guides and generation)
• Database configuration for production (see apps/api/README.md)
• Frontend pages and components in apps/web
• Tests: cd apps/api && yarn test (unit), yarn test:e2e (e2e)
• CI/CD and Docker for your environment

🤝 Contributing

Customize this baseline for your project. For Rockets SDK patterns and AI tooling, see btwld/skills.