Ferramentas de IA hoje entregam a resposta pronta. Você cola, funciona, e não aprendeu nada. Na entrevista — ou no trabalho de verdade — a cola não está lá.

socratic.dev inverte isso. A IA tem uma única regra inquebrável: nunca revelar a solução. Ela pergunta, provoca, aponta o próximo passo — e te força a pensar. O aprendizado acontece no esforço, não na resposta.

Do nível iniciante ao nível big-tech — a dificuldade escala com o seu perfil.

Onboarding  →  escolhe trilha + stack + nível
            →  a IA GERA (ou reaproveita) um desafio sob medida

Workspace   →  você resolve (código no Monaco / arquitetura no Excalidraw)
            →  conversa com o tutor: ele só faz perguntas
            →  pede um hint quando trava (custa do seu saldo)

Submit      →  Código:  roda os testes escondidos → passou/falhou real
            →  Design:  exporta o PNG → Claude analisa a imagem → feedback
            →  métricas: independência, hints usados, tempo

Tire a IA e o produto deixa de existir. Ela não é um enfeite — ela gera os desafios, conduz o diálogo socrático, analisa o diagrama de arquitetura por visão e mede sua independência. Não há fallback estático: sem IA, não há desafio, não há tutor, não há avaliação.

• Tutor socrático — claude-sonnet-4-6 com prompts que proíbem revelar a solução; modos separados para código e design.
• Editor Monaco + runner real — testes JS/TS rodam num Web Worker isolado (transpilação via sucrase), com timeout. Nada é hardcoded; o verde só aparece se os testes passam.
• Canvas Excalidraw + Claude Vision — o diagrama vira PNG e é analisado por visão; o chat usa um resumo de texto dos elementos pra economizar tokens, e a visão só é chamada no submit.
• Geração inteligente de desafios — a dificuldade depende fortemente do nível; avançado mira testes estilo FAANG.
• Biblioteca reaproveitável — todo desafio gerado vira pool compartilhado: a próxima pessoa recebe na hora, sem regenerar (menos espera, menos custo). Deduplicação para não repetir.
• Economia de hints (SaaS) — saldo diário grátis + compra de mais hints + "Resolver pra mim" como último recurso (caro), que aplica a solução direto no editor / canvas.
• Resolver pra mim — não devolve texto: escreve o código no Monaco, ou monta o diagrama no Excalidraw (layout em camadas, didático, com legendas nas setas).
• Dashboard — heatmap de atividade estilo GitHub, anel de independência, histórico paginado com retomar de onde parou.
• Drafts persistentes — código + chat sobrevivem a um F5 (localStorage).

Pré-requisitos: Node 20+, uma conta Supabase e uma chave da Anthropic.

# 1. Instalar dependências (peer-deps do Excalidraw exigem a flag)
npm install --legacy-peer-deps

# 2. Configurar variáveis de ambiente
cp .env.example .env.local   # e preencha os valores

# 3. Aplicar as migrations no seu projeto Supabase
supabase link --project-ref <seu-ref>
supabase db push

# 4. Subir o dev server
npm run dev

Abra http://localhost:3000.

NEXT_PUBLIC_SUPABASE_URL=        # URL do projeto Supabase
NEXT_PUBLIC_SUPABASE_ANON_KEY=   # chave anon (pública)
SUPABASE_SERVICE_ROLE_KEY=       # chave service-role (servidor — nunca exponha no client)
ANTHROPIC_API_KEY=               # chave da API da Anthropic

.env.local está no .gitignore. Nunca commite chaves. Em produção, configure no painel da Vercel.

O projeto foi reorganizado para uma estrutura feature-based, separando melhor responsabilidades de UI, domínio, integrações e lógica de aplicação.

src/
├─ app/                 Rotas do App Router e entrypoints mínimos
│  ├─ api/              Apenas rotas HTTP ainda expostas
│  ├─ challenge/
│  ├─ challenges/
│  ├─ dashboard/
│  ├─ design/
│  ├─ login/
│  ├─ onboarding/
│  ├─ profile/
│  └─ page.tsx
├─ components/          Componentes compartilhados
│  └─ ui/
├─ domain/              Constantes e regras de domínio
├─ features/            Módulos por feature
│  ├─ auth/
│  ├─ challenges/
│  ├─ dashboard/
│  ├─ design/
│  ├─ hints/
│  ├─ landing/
│  ├─ onboarding/
│  ├─ profile/
│  └─ runner/
├─ hooks/               Hooks compartilhados
└─ lib/                 Integrações e infraestrutura
   ├─ ai/
   ├─ api/
   └─ supabase/

O alvo é Vercel + Supabase (Supabase é gerenciado — sem deploy próprio).

1. Importe o repositório na Vercel (detecta Next.js automaticamente).
2. Configure as 4 variáveis de ambiente acima.
3. Após o deploy, no Supabase → Authentication → URL Configuration, defina Site URL e Redirect URLs (https://seu-dominio/**) para o login funcionar em produção.

npm run build   # valida o build de produção antes de subir