Introduction

Cookest

Cookest is a full-stack meal planning and kitchen management platform built as a school project (PAP). The backend is now split into a standalone Food API for catalog data and an App API for authenticated product flows, a Flutter app runs on iOS and Android, and a Python pipeline seeds the recipe and ingredient database.

What's in these docs

Backend APIs

Rust · Actix-Web 4 · SeaORM — Food API, App API, auth, endpoints, database schema, PDF pipeline

Mobile App

Flutter · Riverpod · GoRouter — screens, state management, design system

ETL Pipeline

Python — recipe and nutrition data ingestion from USDA and TheMealDB

Architecture

How the four components fit and communicate

User Guide

Using Cookest as an end user

AI & Automation

Agentic skills, MCP server, and automated documentation

UI Components

@cookest/ui — shared React and Flutter design system with 12 components

CUCL

CUCL · React · TailwindCSS 4 · Framer Motion — shared component library, design tokens, and Storybook

Contributing

Documentation standards, best practices, and translation guide

Project layout

PAP/
  api/             — Rust backend workspace (Food API + App API)
  UI/              — Flutter mobile app (Riverpod, GoRouter)
  web/             — Next.js landing page (TailwindCSS, Framer Motion)
  ui-components/   — Shared component library (React + Flutter)
  etl/             — Python data pipeline
  dataset/         — Raw CSV dataset (MM-Food-100K)
  docs/            — This site (Fumadocs, i18n)

Tech at a glance

Layer	Stack
API	Rust · Actix-Web 4 · SeaORM · PostgreSQL 15 — split into Food API + App API
Auth	Argon2id · JWT access + refresh · HttpOnly cookies
AI	Ollama (llava for PDF vision, llama3.2 for chat)
Payments	Stripe — webhooks + Free / Pro / Family tiers
Mobile	Flutter 3 · Dart 3 · Riverpod · GoRouter
Web	Next.js 16 · TailwindCSS 4 · Framer Motion
Data	Python · psycopg2 · USDA FoodData Central · TheMealDB
UI Components	React · TailwindCSS 4 · Framer Motion · Storybook
Docs	Next.js · Fumadocs · MDX · 5 languages

Available in English, Português, Français, Deutsch, and Español.