npm package: @kenkaiiii/queen-saas
Description: Complete SaaS foundation with authentication, billing, multi-tenancy, and deployment - ready for AI agents to build features
Author: Queen Claude Development Team
Latest version: 2.0.0

# @kenkaiiii/queen-saas

Complete SaaS foundation template with authentication, billing, multi-tenancy, and deployment - optimized for AI-powered development.

## 🚀 Features

- **Authentication** - NextAuth v5 with email/password + OAuth (Google, GitHub)
- **Multi-Tenancy** - Organizations with member roles (Owner, Admin, Member)
- **Billing** - Stripe subscriptions with webhooks
- **Database** - Prisma ORM (SQLite dev / PostgreSQL prod)
- **Email** - Resend integration with React Email templates
- **UI Components** - Shadcn + Tailwind CSS
- **Error Tracking** - Sentry integration (optional)
- **Deployment** - Vercel-ready with configuration

## 📦 Installation

```bash
npx queen-saas my-saas-app
```

Or install globally:

```bash
npm install -g @kenkaiiii/queen-saas
queen-saas my-saas-app
```

## 🎯 What You Get

A complete SaaS foundation with:

- Landing page with placeholder content (just fill in your copy)
- Working authentication system
- Multi-tenant organization structure
- Stripe billing integration
- Email system configured
- Database schema with migrations
- Shadcn UI components
- TypeScript configured
- ESLint + Prettier
- Vercel deployment config

## 🤖 AI-First Development

This template is designed for AI-powered development with:

- **Saasking Agent** - SaaS development specialist
- **Clear Patterns** - Consistent code structure for AI to follow
- **Documentation** - CLAUDE.md with development guidelines
- **Type Safety** - Full TypeScript support

## 🏗️ Architecture

Built on modern SaaS best practices:

- Next.js 15 (App Router)
- Server Components by default
- Multi-tenant data isolation
- Webhook-driven subscription updates
- Role-based access control

## 📚 Stack

- **Framework**: Next.js 15
- **Language**: TypeScript
- **Styling**: Tailwind CSS
- **UI**: Shadcn
- **Database**: Prisma (SQLite/PostgreSQL)
- **Auth**: NextAuth v5
- **Payments**: Stripe
- **Email**: Resend
- **Deployment**: Vercel

## 🔧 Post-Installation

After creating your project:

```bash
cd my-saas-app

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your keys

# Initialize database
npx prisma generate
npx prisma db push

# Start development
npm run dev
```

## 📖 Documentation

Check the generated project for:

- `README.md` - Complete setup guide
- `CLAUDE.md` - Development guidelines for AI agents
- `.claude/agents/saasking.md` - SaaS specialist agent

## 🌟 Perfect For

- SaaS MVPs
- B2B applications
- Team collaboration tools
- Subscription-based services
- Multi-tenant platforms

## 💡 Template Philosophy

This template provides **infrastructure, not features**:

- ✅ Authentication system (working)
- ✅ Billing system (working)
- ✅ Multi-tenancy (working)
- ✅ Landing page (with placeholders)
- ❌ No demo features
- ❌ No sample CRUD operations

You build the features that make your SaaS unique. Everything else is ready.

## 🤝 Part of Queen Claude

Queen Claude is a collection of production-ready templates optimized for AI-powered development.

Other templates:
- `@kenkaiiii/queen-nextjs` - Next.js foundation
- `@kenkaiiii/queen-tauri` - Desktop apps
- `@kenkaiiii/queen-chrome-ext` - Chrome extensions
- `@kenkaiiii/queen-mcp` - MCP servers
- `@kenkaiiii/queen-rag` - RAG applications

## 📄 License

MIT

## 🔗 Links

- [GitHub](https://github.com/kenkaiiii/queen-claude)
- [Documentation](https://github.com/kenkaiiii/queen-claude/tree/main/queen-saas)
- [Report Issues](https://github.com/kenkaiiii/queen-claude/issues)