Quick Start

Crie seu primeiro projeto em 3 minutos com os 3 modos de uso.

Modo 1: Interativo (padrao)

O modo interativo guia voce por cada escolha com um wizard no terminal:

plazercli

O wizard vai perguntar:

  1. Nome do projeto
  2. Descricao
  3. Runtime (npm, pnpm ou bun)
  4. Framework frontend (Next.js, React/Vite, Vue, Angular)
  5. Framework backend (NestJS, Express, Fastify)
  6. Banco de dados (PostgreSQL, MySQL, MongoDB, nenhum)
  7. Metodos de autenticacao
  8. Features SaaS (RBAC, Organizations, Billing)
  9. API quality (Zod, Rate Limiting, Logging, Swagger)
  10. Infra (Redis, filas, SMTP, MinIO, WebSockets)
  11. Integracoes (Stripe, Mercado Pago, WhatsApp, etc.)

Modo 2: Preset (rapido)

Use um preset pre-configurado para pular o wizard:

# SaaS completo com todas as features
plazercli --preset saas-starter --name meu-saas

# E-commerce com pagamentos
plazercli --preset ecommerce --name minha-loja

# API robusta com Fastify
plazercli --preset api-platform --name minha-api

# App com WebSockets em tempo real
plazercli --preset realtime-app --name meu-chat

# Minimo necessario
plazercli --preset minimal --name meu-app

Veja todos os presets disponiveis na pagina Presets.

Modo 3: --yes (defaults)

O modo --yes usa valores padrao para tudo (Next.js + Express + PostgreSQL):

plazercli --yes --name meu-projeto

Isso gera um projeto com a stack mais simples possivel, sem features extras.

Rodando o projeto

Apos gerar o projeto, siga estes passos:

# 1. Entrar no diretorio
cd meu-projeto

# 2. Subir a infra (PostgreSQL, Redis, etc.)
docker compose up -d

# 3. Instalar dependencias (se nao foram instaladas automaticamente)
pnpm install

# 4. Configurar o banco de dados (se usar Prisma)
cd apps/api && npx prisma db push && cd ../..

# 5. Iniciar o desenvolvimento
pnpm run dev

Seu projeto estara disponivel em:

  • Frontend: http://localhost:3000
  • Backend API: http://localhost:3001
  • Health check: http://localhost:3001/api/health
  • Swagger docs: http://localhost:3001/api/docs (se habilitado)