@kenkaiiii/queen-nextjs/README.md

Create a modern Next.js application with Queen Claude foundation, Claude Code configuration, and Queen Styles design system enforcement

# create-nextjs-queen

A modern Next.js scaffold with Queen Claude foundation - clean, opinionated, and ready to build.

## Features

- ⚡ **Next.js 15** with App Router
- 🔒 **TypeScript** in strict mode  
- 🎨 **Tailwind CSS** with dark mode
- 🛠️ **ESLint & Prettier** configured
- 📦 **Latest dependencies** at install time
- 🚀 **Zero configuration** needed

## Quick Start

```bash
npx create-nextjs-queen my-app
cd my-app
npm install
npm run dev
```

Open [http://localhost:3000](http://localhost:3000) - your app is ready!

## What You Get

### Perfect Foundation
- Modern Next.js setup with App Router
- TypeScript with strict configuration
- Tailwind CSS with sensible defaults
- Professional ESLint and Prettier setup

### Clean Structure
```
src/
├── app/          # Next.js App Router
├── components/   # React components (ready to use)
├── lib/          # Utilities and helpers
└── types/        # TypeScript definitions
```

### Ready-to-Use Scripts
- `npm run dev` - Development server
- `npm run build` - Production build
- `npm run lint` - Code linting
- `npm run format` - Code formatting
- `npm run type-check` - TypeScript validation

## Philosophy

**Bare-bones but complete** - Everything you need to start building, nothing you don't.

- ✅ **Infrastructure included**: All tooling configured perfectly
- ❌ **Opinions excluded**: No auth, database, or deployment assumptions
- 🎯 **Latest everything**: Dependencies fetched fresh at install time

## Part of Queen Claude System

This scaffold is Phase 1 of the Queen Claude spec-driven development system. Future phases will add:
- MCP integration for AI collaboration
- Database-driven project management  
- Constitutional development principles
- Real-time development dashboards

For now, enjoy the cleanest Next.js foundation available.

---

Built with ❤️ for developers who want to start building immediately.