Creative OS

Plataforma SaaS interna de geração criativa automatizada para agências de marketing.

Stack

• Next.js 15 (App Router)
• TypeScript
• Tailwind CSS v4 + shadcn/ui
• Supabase (Auth, Database, Storage)
• Anthropic Claude API (Creative Brain / Brand DNA)
• Zod + React Hook Form + Server Actions

Estrutura

app/                 # Rotas (App Router)
components/          # UI (layout, auth, clients, ui)
lib/                 # Utilitários, Supabase, IA, schemas
types/               # Tipagens TypeScript
hooks/               # React hooks (futuro)
actions/             # Server Actions
services/            # Camada de dados (queries)
supabase/migrations/ # Schema SQL + RLS

Setup local

1. Variáveis de ambiente

cp .env.local.example .env.local

Preencha:

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• ANTHROPIC_API_KEY (para geração de Creative Brain com Claude)
• ANTHROPIC_MODEL (opcional — padrão: claude-haiku-4-5-20251001)

2. Supabase

1. Crie um projeto em supabase.com

2. Aplique o schema (obrigatório — sem isso aparece erro public.clients):

   Opção A — SQL Editor (mais rápido): abra SQL Editor, cole todo o conteúdo de supabase/setup.sql e clique Run.

   Opção B — CLI local: adicione SUPABASE_DB_PASSWORD no .env.local (Dashboard → Settings → Database → Database password) e rode:

   npm run db:setup
   

3. Em Authentication → URL Configuration, adicione:

   • Site URL: http://localhost:3000
   • Redirect URLs: http://localhost:3000/auth/callback

4. (Opcional) Desative confirmação de e-mail em dev: Authentication → Providers → Email

5. Execute também supabase/migrations/20250527100000_user_roles.sql (roles admin/member)

Admin de teste

No .env.local, configure as variáveis DEV_ADMIN_EMAIL, DEV_ADMIN_PASSWORD e DEV_ADMIN_NAME e a SUPABASE_SERVICE_ROLE_KEY (Settings → API → service_role — nunca commite).

npm run seed:admin

Login em http://localhost:3000/login.

3. Rodar o projeto

npm install
npm run dev

Acesse http://localhost:3000.

Fluxo MVP

• Login / cadastro (Supabase Auth)
• Dashboard com métricas
• CRUD de clientes
• Onboarding criativo (/clients/[id]/onboarding) — auto-save
• Upload de referências (/clients/[id]/references)
• Geração Creative Brain com Claude (/clients/[id]/brain)
• Revisão, aprovação e reprocessar Brand DNA
• Geração de criativos (fase 3)

Deploy (Vercel)

1. Conecte o repositório à Vercel
2. Configure as mesmas variáveis de ambiente
3. Atualize redirect URLs no Supabase para o domínio de produção

Arquitetura

Camada	Responsabilidade
app/	Rotas, layouts, composição de páginas
components/	UI pura e formulários client
actions/	Server Actions (mutations, auth)
services/	Queries e regras de leitura
lib/ai/	Prompts, Claude (Anthropic), validação Zod
lib/supabase/	Clients SSR/browser
lib/schemas/	Validação Zod compartilhada
types/	Contratos TypeScript
"# creativeos"