• 🚧 Hosted version
  • Publicly hosted version for testing and feedback
  • Basic multi-user support with isolated spaces
  • Crowd-funded moneypot to share LLM and hosting costs
  • ToS, Privacy, Cookies banners, and GDPR compliance
  • Fix main bugs, rough UX edges, and stabilize the API a bit before launching self-hosted
  • Offline usage & sync engine (PowerSync)
• Self-hosted version
  • Dockerized deployment & documentation
  • Automated database migrations on startup
  • Embed & update ingredient images in docker
  • Automated backup and restore of database and media files
• Documentation
  • Usage documentation for end-users
  • Technical architecture documentation for devs
  • Translate app & docs

• Shared households

  • Create one or more isolated "home" spaces (e.g., Home, Parents' house)
  • Share spaces with other users to collaborate
  • Invite users to your spaces

• Recipe engine

  • Import recipes from common websites or create your own
  • Convert ingredient quantities and units
  • Organize recipes in shareable cookbooks
  • Robust recipe import from social media, photos, text, and other apps.
  • Recipe variants: plan a meal, switch meal ingredients, save as variant/shortcut

• Basic meal planning

  • Simple dateless meal plan
  • Add additional ingredients & custom items

• Shopping list generation

  • Automatically generate a shopping list
  • Suggest items based on past purchases
  • Sort & group items by aisle, meal, or cart status

• Make this foundation great before the next step

• Pantry management
  • Add pantry items with categories, quantities, expiration dates, and storage locations
  • Import pantry items from receipts, supermarket APIs, or smart scales
  • Quantity tracking with automatic unit conversions
  • Expiration dates estimation and reminders
• Closing the loop: Pantry-Meal-Grocery Reservation Engine
  • Connect pantry directly to planned meals and automatically reserve items for each meal
  • Adapt the grocery list based on pantry availability and reserved items
  • Show "cookability" state for each recipe
  • Suggest substitutions for missing ingredients

• Contextual & Predictive Pantry Rules
  • Set "Minimum Quantities" per item to auto-trigger shopping list additions regardless of meal plan
  • Consumption habits and pantry probabilities (e.g. assume 100g of cereal daily for breakfast)
• Smart Recipe Recommendations
  • Quick-scale party filters (e.g., "Ideas for (-) 2 (+) people")
  • Contextual badges for recipe matches: Ready to Cook, Change of Plans, or Groceries Needed
  • Reason-based suggestion badges (e.g., "Uses up items about to expire")
  • Top-of-page interactive assistant recommending tailored search filters
• Timeline & Stats
  • Past: View everything you cooked, bought, and consumed
  • Future: Step through your planned timeline to view calculated future pantry states
  • Time travel: Select a position between planned meals to see if a cookable meal fits
  • Stats: Cooking habits, nutrition, spending, waste, sustainability, ...
• TODO History & Undo, LLM Assistant, Nutrition Stats, Sustainability Metrics, Local Producer Sourcing...

• Supermarket mode
  • Barcode scanning while shopping: nutrition insights, past purchases, price comparisons
• Streamlined Inventory Inputs
  • Manual slider adjustments
  • Text & image-based input processing (Groceries receipt scanning / OCR parsing)
  • Direct supermarket API inventory loading
  • Explicit "Mark recipe as cooked" triggers to batch-decrement inventory
• Probabilistic Inventory Tracking
  • Support quantity variance ranges (e.g., tracking "1-2 onions" instead of exact grams)
  • Habit-based predictive quantity engine derived from historical data
  • Periodic low-friction micro-checkins asking users to quickly verify true quantities
• The Autonomous Kitchen Wizard
  • Continuous, algorithmic meal plan pre-filling based on learned user profiles
  • Soft-ui states: Display suggestions as half-faded layouts for swift confirm/switch/remove interactions
  • Profile toggles: Familiar vs. Discover balancing, Flexitarian settings, and Mood adjustments
  • Kill-switch toggle to fully disable auto-filling behaviors

A more complete guide will be written soon, but here is a quickstart for now:

# Clone the repo and install dependencies
git clone https://github.com/MadeInPierre/cuicuit.git
cd cuicuit
npm install

# Setup environment variables (see `.env.example` for reference)
cp .env.example .env
# Edit .env to set your own values (e.g., Supabase URL and keys)

# Start the local Supabase dev server (Postgres + Auth + Storage)
supabase start
# Open http://localhost:54321 in your browser to access Supabase Studio

npm run db:reset  # Create the database schema and seed it with test data

# Start the dev server (web app + API + MCP)
npm run dev
# Open http://localhost:5173 in your browser
# Log in with the seeded dev user `dev@cuicuit.app` with password `1SouffleAuFromage`
# Open http://localhost:5173/api/v1/docs for the API docs