monorepo-generator

# Monorepo Generator

Generate scalable monorepo structures for full-stack applications with shared packages.

## Quick Start

```bash
mkdir my-monorepo && cd my-monorepo
bun init -y  # or: pnpm init / npm init -y
```

---

## Workflow

### Step 1: Gather Requirements

Ask user what project types they need:

| Type | Examples | Common Stack |
|------|----------|--------------|
| **Frontend** | Web app, admin dashboard, docs site | Next.js 15, React 19, Tailwind |
| **API** | REST API, GraphQL server | Hono, Express, Fastify |
| **Pipeline** | ETL jobs, cron tasks, workers | Node scripts, Python |
| **CLI** | Developer tools, automation | Commander, Yargs |
| **Mobile** | React Native app | Expo, React Native |

### Step 2: Choose Package Manager

- **Bun** (recommended): Fastest, built-in workspaces
- **PNPM**: Efficient disk usage, strict dependencies
- **Yarn**: Mature ecosystem, plug'n'play option

See [Package Manager Guide](./references/package-managers.md) for configs.

### Step 3: Create Directory Structure

```
/monorepo/
├── apps/                       # Deployable applications
│   ├── web/                    # Next.js frontend
│   ├── api/                    # Hono/Express API
│   ├── admin/                  # Admin dashboard
│   └── docs/                   # Documentation site
│
├── services/                   # Backend services & workers
│   ├── jobs/                   # Scheduled jobs/cron
│   ├── workers/                # Background workers
│   └── pipelines/              # Data pipelines
│
├── packages/                   # Shared libraries
│   ├── ui/                     # React components (shadcn/ui)
│   ├── utils/                  # Shared utilities
│   ├── db/                     # Database client & schemas
│   ├── api-client/             # Generated API client
│   ├── config/                 # Shared configuration
│   ├── eslint-config/          # Shared ESLint
│   └── typescript-config/      # Shared TS configs
│
├── package.json                #