Cookbook

Pequenas receitas, grandes histórias.
Um livro de receitas privado, partilhado e feito para cozinhar em conjunto.

mobile first · PWA · PT-PT · tempo real

---

Da coleção até à mesa

O Cookbook junta num só lugar as receitas de Ivo e Ana. Foi desenhado primeiro para telemóvel e tablet, com uma linguagem visual caseira, editorial e prática.

_{Uma entrada privada e acolhedora para abrir o nosso livro de receitas.}

_{Receita completa com fotografia, tempos, doses, etiquetas e autoria.}

Uma experiência pensada para telemóvel

Início e sugestão adaptada à fotografia.

Passos, ingredientes e temporizadores sempre à mão.

Importar, rever e só depois guardar

Importação por texto com leitura assistida quando necessário.

Preview editável para confirmar todos os campos.

O essencial

• coleção partilhada com pesquisa, etiquetas, favoritos e avaliações individuais;
• criação e edição manual, medidas europeias e ajuste das doses por pessoas;
• importação por texto ou ligação, com Gemini como apoio quando a página é difícil de ler;
• fotografias privadas com recorte escolhido pelo utilizador e otimização automática em WebP;
• Modo Cozinhar com passos, ingredientes contextuais, progresso e vários temporizadores;
• sincronização em tempo real, caixote, cópia de segurança e instalação como PWA.

Chef Pitéu

O Chef Pitéu é a identidade visual e o pequeno anfitrião da aplicação. As suas poses acompanham a leitura, a descoberta, a cozinha, os estados de carregamento e os momentos de celebração sem transformar a interface num desenho infantil.

Como foi construído

Camada	Tecnologia
Interface	Next.js 16, React 19, TypeScript e Tailwind CSS 4
Dados	Supabase Postgres, Auth, Realtime e Storage privado
Validação e imagem	Zod e Sharp
Importação assistida	Google Gemini, usado apenas como fallback ou revisão explícita

web/
├── src/app/          páginas, rotas e ações de servidor
├── src/components/   interface reutilizável
├── src/lib/          domínio, importação e clientes Supabase
└── supabase/         schema, políticas RLS e configuração de Storage

Executar localmente

É necessário Node.js 20.9 ou superior e um projeto Supabase dedicado.

cd web
npm install
Copy-Item .env.example .env.local
npm run dev

Preencher .env.local sem o adicionar ao Git:

NEXT_PUBLIC_SUPABASE_URL=https://SEU-PROJETO.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=SUA_CHAVE_PUBLICA
GEMINI_API_KEY=SUA_CHAVE_PRIVADA_DO_GOOGLE_AI_STUDIO

As instruções para criar a base de dados estão em web/supabase/README.md.

Verificação

cd web
npm run lint
npm test
npm run build

O guia completo para publicar na Vercel e ligar um subdomínio da OVH está em docs/DEPLOYMENT.md.

---

Receitas também unem pessoas. Cozinhar é cuidar.