Quick Start

# Modo interativo (8 steps organizados)
npx plazercli

# Preset rapido
npx plazercli --preset saas-starter

# Zero perguntas com defaults inteligentes
npx plazercli --yes --name meu-saas

Ou instale globalmente:

npm install -g plazercli
plazercli

A Liz vai te perguntar sobre o projeto e configurar tudo automaticamente.

O que a Liz faz por voce

Ao rodar o plazercli, a Liz:

1. Pergunta o nome do projeto e o que ele faz
2. Pergunta qual stack voce quer (frontend, backend, banco, auth, billing, etc.)
3. Cria o monorepo completo com apps/web + apps/api
4. Configura banco de dados, autenticacao, RBAC, billing
5. Conecta todos os modulos automaticamente (auto-wiring)
6. Gera docker-compose.yml, .env, README, CI/CD, Dockerfiles
7. Instala as dependencias
8. Inicializa o git com commit inicial
9. Configura a si mesma (Liz) como AI agent no projeto

Resultado: projeto pronto pra rodar com docker compose up -d && pnpm dev

Features

SaaS Core

| Feature | O que configura | |---------|----------------| | RBAC | Roles (Admin/User/Owner), CASL abilities, guards por framework | | Organizations | Workspaces com CRUD, convites por email, gestao de membros | | Stripe Billing | Planos Free/Pro/Enterprise, checkout, portal, webhooks |

Autenticacao (6 providers + 3 services)

| Metodo | O que configura | |--------|----------------| | JWT | Login/register com bcrypt, guards/middleware, strategy | | Magic Link | Token por email, verificacao, auto-habilita SMTP | | Google OAuth | Strategy Passport, rotas de callback, env vars | | GitHub OAuth | Login com GitHub, essencial pra dev tools | | Apple Sign-In | Verificacao de identity tokens Apple | | Discord OAuth | Login com Discord, popular em comunidades | | Clerk | Auth completo com UI pronto, muito popular com Next.js | | NextAuth/Auth.js | Auth nativo do Next.js com Prisma adapter | | 2FA/TOTP | Autenticacao de dois fatores com QR code |

Todos adaptados automaticamente ao backend escolhido (Express/Fastify/NestJS).

API Quality

| Feature | O que configura | |---------|----------------| | Zod | Schemas de validacao prontos, pipes (NestJS) ou middleware | | Rate Limiting | Limites globais e por rota, configuraveis por framework | | Pino Logging | Logging estruturado com request ID, pretty-print em dev | | Swagger/OpenAPI | Documentacao automatica da API em /api/docs | | tRPC | API typesafe end-to-end, integrado com Next.js | | Health Checks | Endpoint /api/health com status de DB, Redis, memoria |

AI/ML (v3.0)

| Integracao | O que configura | |------------|----------------| | OpenAI | Chat completions, embeddings, assistants | | Vercel AI SDK | SDK unificado, generateText, streamText |

Monitoring & Analytics (v3.0)

| Feature | O que configura | |---------|----------------| | Sentry | Error tracking + performance monitoring | | Google Analytics 4 | Analytics no frontend com GA4 |

Pagamentos (5 gateways)

| Integracao | O que configura | |------------|----------------| | Stripe | Checkout, PaymentIntent, webhooks | | PayPal | Orders, captures, checkout | | Mercado Pago | Preferences, pagamentos PIX | | AbacatePay | Pagamentos, PIX |

Comunicacao (3 canais)

| Integracao | O que configura | |------------|----------------| | WhatsApp | Service para API Meta WhatsApp Business | | Twilio SMS | Envio de SMS e verificacao por telefone | | Telegram Bot | Bot para notificacoes de sistema |

Storage (3 opcoes)

| Opcao | O que configura | |-------|----------------| | MinIO | S3-compatible local, docker service | | AWS S3 | Upload, download, presigned URLs | | Cloudflare R2 | S3-compatible sem egress fees |

Email (2 opcoes)

| Opcao | O que configura | |-------|----------------| | SMTP | Nodemailer com templates HTML | | Resend | API moderna com React Email |

Search (v3.0)

| Opcao | O que configura | |-------|----------------| | Meilisearch | Busca full-text, indexacao, docker service |

Testing (v3.0)

| Opcao | O que configura | |-------|----------------| | Vitest + Supertest | Unit tests + HTTP tests, config pronta |

Extras

| Feature | O que configura | |---------|----------------| | WebSockets | Socket.IO com rooms, broadcast e notificacoes | | Tailwind CSS | Config + paginas SaaS prontas (landing, login, dashboard) | | CI/CD | GitHub Actions + Dockerfiles multi-stage | | i18n | Internacionalizacao pt-BR + en | | Cron Jobs | Tarefas agendadas com node-cron | | PDFKit | Gerar PDFs (notas fiscais, relatorios) | | ViaCEP | Consulta de CEP | | Google Maps | Maps, Places, Geocoding |

Frontend

| Framework | Descricao | |-----------|----------| | Next.js | React SSR/SSG com App Router | | React (Vite) | SPA com Vite + React | | Vue | SPA com Vite + Vue 3 | | Angular | SPA com Angular standalone |

Backend

| Framework | Descricao | |-----------|----------| | NestJS | Enterprise, modular, decorators | | Express | Minimalista, flexivel | | Fastify | Alta performance, plugins |

Banco de Dados

| Banco | ORM/ODM | Auto-config | |-------|---------|-------------| | PostgreSQL | Prisma | Schema com User model, docker service, DATABASE_URL | | MySQL | Prisma | Schema com User model, docker service, DATABASE_URL | | MongoDB | Mongoose | Models, conexao, docker service, MONGODB_URI |

Infraestrutura

| Feature | O que configura | |---------|----------------| | Redis | Service com ioredis, docker service | | BullMQ | Queue config, worker de exemplo, auto-habilita Redis | | RabbitMQ | Producer/consumer, docker service | | PM2 | ecosystem.config.cjs, cluster mode, zero-downtime | | Multi-tenant | Middleware de isolamento por header/subdomain |

Presets

Use --preset <nome> pra criar projetos com configuracoes prontas:

| Preset | Stack | Descricao | |--------|-------|-----------| | saas-starter | NestJS + Next.js + PostgreSQL | Stack completa: auth, billing, RBAC, dashboard | | saas-multi-tenant | NestJS + Next.js + PostgreSQL | SaaS B2B com isolamento por tenant | | ecommerce | NestJS + Next.js + PostgreSQL | Loja online com pagamentos e storage | | api-platform | Fastify + Next.js + PostgreSQL | API robusta com docs e monitoramento | | realtime-app | NestJS + Next.js + PostgreSQL | App com comunicacao em tempo real | | minimal | Express + Next.js + PostgreSQL | Minimo necessario pra comecar | | ai-saas | NestJS + Next.js + PostgreSQL | SaaS com IA: OpenAI, Vercel AI SDK, Clerk | | devtool | NestJS + Next.js + PostgreSQL | Dev tool: GitHub Auth, tRPC, Sentry, testes | | brazil-saas | NestJS + Next.js + PostgreSQL | SaaS BR: Mercado Pago, ViaCEP, WhatsApp | | marketplace | NestJS + Next.js + PostgreSQL | Marketplace: busca, storage, pagamentos | | mobile-backend | Fastify + Next.js + PostgreSQL | Backend mobile: push, SMS, Apple Auth, 2FA | | content-platform | NestJS + Next.js + PostgreSQL | Plataforma de conteudo com busca e analytics |

# Exemplo
npx plazercli --preset ai-saas --name minha-plataforma

Stack Suportada

Runtimes

• pnpm (recomendado)
• bun
• npm

Estrutura

Monorepo com workspaces nativos do runtime escolhido.

meu-saas/
├── apps/
│   ├── api/                    # Backend
│   │   ├── src/
│   │   │   ├── auth/           # JWT, Magic Link, OAuth, Clerk, 2FA
│   │   │   ├── rbac/           # Roles + CASL
│   │   │   ├── organizations/  # Workspaces + convites
│   │   │   ├── billing/        # Stripe subscriptions
│   │   │   ├── database/       # Prisma/Mongoose
│   │   │   ├── infra/          # Redis, Email, Storage, Sentry, PDF
│   │   │   ├── queue/          # Workers e jobs
│   │   │   ├── jobs/           # Cron jobs
│   │   │   ├── health/         # Health checks
│   │   │   ├── trpc/           # tRPC router (se habilitado)
│   │   │   ├── websockets/     # Socket.IO
│   │   │   ├── common/         # Validation, Logging
│   │   │   ├── integrations/   # APIs externas (OpenAI, Stripe, Twilio, etc.)
│   │   │   ├── routes/
│   │   │   └── config/
│   │   ├── prisma/
│   │   └── .env
│   └── web/                    # Frontend
│       └── src/
├── docker-compose.yml
├── .github/workflows/          # CI/CD
├── CLAUDE.md                   # Liz (Claude Code)
├── AGENTS.md                   # Liz (geral)
├── .cursor/rules/              # Liz (Cursor)
└── README.md

CLI Flags

plazercli --version                    # Mostra versao
plazercli --name meu-app               # Pre-define nome
plazercli --yes                        # Defaults inteligentes, sem perguntas
plazercli --preset saas-starter        # Usa preset pronto
plazercli --dry-run                    # Mostra o que seria gerado
plazercli --save-config config.json    # Salva config pra reutilizar
plazercli --config config.json         # Carrega config salva

Valores padrao (--yes)

| Opcao | Default | |-------|---------| | Runtime | pnpm | | Database | PostgreSQL (Prisma) | | Frontend | Next.js | | Backend | NestJS | | Auth | JWT | | Queue | BullMQ | | RBAC / Zod / Rate Limiting / Pino / Swagger / Health Checks | Sim | | Tailwind / CI/CD | Sim | | Redis / SMTP / PM2 | Sim |

Liz - AI Agent

Todo projeto gerado vem com a Liz, uma agente de IA configurada pra conhecer a arquitetura do projeto.

O que a Liz sabe

• Toda a stack escolhida
• Estrutura de diretorios
• Convencoes de codigo
• Como criar novas features seguindo os patterns
• Como adicionar endpoints, models, workers e integracoes

Integracao com editores

| Editor | Arquivo | Como funciona | |--------|---------|--------------| | Claude Code | CLAUDE.md | Carrega automaticamente | | Cursor | .cursor/rules/liz.mdc | Regras contextuais | | Copilot / Outros | AGENTS.md | Referencia completa |

Exemplo de uso

"Liz, cria um endpoint de listagem de produtos"
"Liz, adiciona um model de Order no Prisma"
"Liz, cria um job para enviar email de boas-vindas"
"Liz, integra o webhook do Stripe"

Como Funciona

Fluxo interativo (8 steps)

Step 1/8 — Stack Principal
 1. Modo (Custom ou Preset)
 2. Nome do projeto              (validado como pacote npm)
 3. Descricao                    (texto)
 4. Runtime                      pnpm | bun | npm
 5. Banco de dados               PostgreSQL | MySQL | MongoDB | None
 6. Frontend                     Next.js | React | Vue | Angular
 7. Backend                      NestJS | Express | Fastify

Step 2/8 — Autenticacao
 8. Auth methods                 JWT | Magic Link | Google | GitHub | Apple | Discord
 9. Auth services                Clerk | NextAuth | 2FA/TOTP

Step 3/8 — SaaS Features
10. SaaS                         RBAC | Organizations | Stripe Billing

Step 4/8 — API Quality & Patterns
11. API                          Zod | Rate Limiting | Pino | Swagger | tRPC | Health

Step 5/8 — Infraestrutura
12. Multi-tenant                 sim | nao
13. Email                        SMTP | Resend | None
14. Redis                        sim | nao
15. Filas/Jobs                   BullMQ | RabbitMQ | None
16. Storage                      MinIO | AWS S3 | Cloudflare R2 | None
17. Meilisearch                  sim | nao
18. Cron Jobs                    sim | nao

Step 6/8 — Integracoes
19. Pagamentos                   Stripe | PayPal | Mercado Pago | AbacatePay
20. Comunicacao                  WhatsApp | Twilio SMS | Telegram Bot
21. AI                           OpenAI | Vercel AI SDK
22. Outras                       ViaCEP | Google Maps

Step 7/8 — Monitoring & Analytics
23. Sentry                       sim | nao
24. Google Analytics             sim | nao

Step 8/8 — Extras
25. Testes                       sim | nao (Vitest + Supertest)
26. PDFKit                       sim | nao
27. Extras                       Tailwind | CI/CD | WebSockets | i18n
28. PM2                          sim | nao

Dependencias implicitas

| Voce escolhe | Liz habilita | |-------------|-------------| | BullMQ | Redis | | Magic Link | SMTP | | Stripe Billing | Integracao Stripe |

Auto-wiring

A Liz reescreve o arquivo principal do backend pra importar e conectar todos os modulos:

• NestJS: Todos os modules importados no app.module.ts
• Express: Todas as rotas registradas no app.ts, conexoes no index.ts
• Fastify: Todos os plugins registrados no app.ts, conexoes no index.ts

Documentacao

O PlazerCLI tem um site de documentacao completo com 39 paginas cobrindo todas as features:

• Documentacao Online — Site completo com Next.js

Rodar localmente

cd docs
npm install
npm run dev

O que tem na documentacao

| Categoria | Paginas | |-----------|---------| | Comecando | Introducao, Instalacao, Quick Start, CLI Flags, Presets, Arquitetura | | Stack | Frontend, Backend, Banco de Dados | | Autenticacao | Visao Geral, JWT, Magic Link, Google OAuth | | SaaS Features | RBAC, Organizations, Stripe Billing | | API Quality | Zod, Rate Limiting, Pino Logging, Swagger | | Infraestrutura | Redis, SMTP, MinIO, WebSockets, Filas, Multi-tenant, PM2 | | Extras | Tailwind CSS, CI/CD, i18n | | Integracoes | Visao Geral, ViaCEP, WhatsApp, Stripe, Mercado Pago, AbacatePay | | IA | Liz AI Agent | | Avancado | Docker, Variaveis de Ambiente |

Desenvolvimento

git clone https://github.com/pablocarss/plazercli.git
cd plazercli
npm install
npm run dev      # Watch mode
npm run build    # Build para dist/
node dist/index.js

Licenca

MIT

Feito por @pablocarss