create-perfect-template/README.md

Create a modern Next.js SaaS template with progressive feature activation

# create-perfect-template

Create a modern Next.js SaaS template with progressive feature activation.

## Usage

```bash
# With npx (recommended)
npx create-perfect-template@latest my-app

# With npm
npm create perfect-template@latest my-app

# With yarn
yarn create perfect-template my-app

# With pnpm
pnpm create perfect-template my-app
```

## Interactive Setup

The CLI will guide you through setting up your project:

```
🚀 Welcome to Perfect Template!

? What is your project name? my-saas-app
? Which features would you like to include?
 ◉ 🔐 Authentication (Clerk)
 ◉ 🗄️ Database (Convex)
 ◯ 💳 Billing (Autumn)
 ◉ 🤖 AI Integration (OpenAI/Anthropic)
 ◯ 📧 Email (Resend)
```

## Features

- **Next.js 15** - Latest Next.js with App Router
- **TypeScript** - Full type safety
- **Tailwind CSS** - Utility-first CSS
- **shadcn/ui** - Beautiful components
- **Progressive Setup** - Add features as you need them

### Optional Features

- 🔐 **Authentication** - Clerk integration
- 🗄️ **Database** - Convex real-time database
- 💳 **Billing** - Autumn subscription management
- 🤖 **AI** - OpenAI & Anthropic integration
- 📧 **Email** - Resend transactional emails

## Options

```bash
# Skip dependency installation
npx create-perfect-template my-app --skip-install

# Use specific package manager
npx create-perfect-template my-app --use-yarn
npx create-perfect-template my-app --use-pnpm
```

## After Installation

1. Navigate to your project directory
2. Add your API keys to `.env.local`
3. Run `npm run dev` to start development

## License

MIT