Instruções sobre como rodar localmente logo após texto introdutório do desafio.

Construir um aplicativo web simples de notas que permita criar, listar, atualizar e excluir registros. O desafio avalia sua capacidade de trabalhar com nosso stack principal (Effect, React, Drizzle) e explorar o uso de IA no design de interface.

• Desenvolver em TypeScript usando Effect:

  • http-api para definição de contrato e rotas
  • uso de services e layers para injeção de dependências
  • validação com schemas
  • erros tipados mapeados corretamente para status HTTP

• CRUD completo de notas: criar, listar, buscar por ID, atualizar e excluir.

• Modelagem via Drizzle ORM (SQLite ou Postgres).

• Tabela notes com:

  • id, title, content, createdAt, updatedAt.

• Interface em React.

• CRUD acessível e fluido.

• Estilo/UX produzido com apoio de IA (Cursor, Claude Code, etc.).

• Uso consistente da paleta Ledda:

  Primary Colors

  • Primary: Deep teal #1E4D4A / hsl(180, 45%, 15%)
  • Secondary: Light green #D5E5DC / hsl(142, 25%, 86%)

  Supporting Colors

  • Background: Pure white hsl(0, 0%, 100%)
  • Foreground: Deep teal hsl(180, 45%, 15%)
  • Muted: Very light green hsl(142, 25%, 96%)
  • Accent: Light green hsl(142, 25%, 86%)
  • Border: Light green hsl(142, 25%, 86%)

  Logo Colors

  • Petals: Light green #C1D9C3
  • Stroke: White

• README deve explicar:

  • Como rodar localmente (backend, frontend, banco).
  • Decisões técnicas e trade-offs.
  • Como a IA foi utilizada no design (com prompts ou descrição do processo).

/apps
  /api
    src/
      domain/        # schemas, erros de domínio
      services/      # services + layers
      http/          # contrato HttpApi + handlers
      db/            # schema Drizzle + migrations
  /web
    src/
      components/    # UI (cards, forms, feedback)
      pages/         # telas de CRUD
      lib/           # client API
      styles/        # tokens e temas

Bônus (+ até 10%)

• TanStack Query e gerenciamento de cache
• Testes e2e (Playwright)
• Deploy funcional (Vercel/Render/Railway)

Requisitos: Node 20+, Bun, Postgres (local via Docker) ou Neon.

Configuração .env em api/ (exemplo):

DATABASE_URL=postgres://postgres:postgres@localhost:5432/notes
PORT=3001
HOST=127.0.0.1
MIGRATE_ON_STARTUP=true

Comandos (dentro de api/):

bun install
bun run db:migrate
bun run db:seed      # opcional
bun run dev          # API em http://127.0.0.1:3001

Requisitos: Node 20+, Bun.

Comandos (dentro de web/):

bun install
bun run dev          # abre em http://localhost:5173

O Vite proxy está configurado para encaminhar /api/* para http://127.0.0.1:3001 (ajuste em web/vite.config.ts se necessário).

• shadcn/ui para rapidez e consistência visual.
• Tailwind v4 com @tailwindcss/vite para DX simples e tokens de tema.
• Proxy /api no Vite para evitar CORS em dev.
• Cliente HTTP leve em web/src/lib/api.ts (sem libs extras).
• Componente FlowerLogo com animação e ruído sutil no board para reforçar a identidade visual.

Consulte web/README.md na seção “Prompts de IA utilizados”.

• Se bun run dev não existir no web/package.json, rode bunx --bun vite.
• Se o board não aparecer, verifique se a API está rodando e se o proxy do Vite aponta para o host/porta corretos.
• Problemas de IPv6: use HOST=127.0.0.1 na API para favorecer IPv4.