Recipe library with 10 recipes, category filtering, search, and AI-powered recipe generation.
Recipe detail with serving multiplier, ingredient checklist, and numbered instructions.
Weekly meal plan with stat cards, macro-nutrient bars, and day-by-day schedule.
Multi-Provider AI
Generate recipes, enhance existing ones, and get ingredient substitutions across OpenAI, Claude, Gemini, and local Ollama models.
Smart Meal Planning
Weekly calendar with AI suggestions, save-as-template, calendar export, and auto-generated shopping lists with pantry cross-check.
Self-Hosted & Private
Docker one-command deploy with PostgreSQL. Your recipes, meal plans, and data stay on your hardware — zero cloud dependency.
Shopping lists with items grouped by category, progress tracking, and inline quantity editing.
Pantry inventory with category filters, expiration tracking, and quantity adjustment.
Cooking analytics with variety score, meal type distribution, and most-cooked recipes.
Gamification system with levels, points, streaks, and 16 unlockable achievements.
From Recipe Box to Kitchen Platform
Culinode evolved from a simple recipe CRUD app into a full kitchen management platform with AI integration, meal planning, pantry tracking, and gamification.
Recipe Management
CRUD, URL import, ingredient parsing — Jan 2026
Meal Planning & Shopping
Weekly calendar, auto-generated lists, pantry — Feb 2026
AI & Gamification
Multi-provider generation, achievements, batch cooking — Mar 2026
The Process
Culinode started from a simple problem: recipes scattered across bookmarks, screenshots, messaging apps, and paper notes. I wanted one place to store them, plan meals around them, and auto-generate shopping lists — self-hosted, so the data stays mine. I wrote a PRD in Claude Code defining the core entities (recipes, ingredients, meal plans, shopping lists) and the monorepo structure (React frontend, Express backend, shared TypeScript types). The first working version — recipe CRUD with URL import — was running in Docker within the first week.
The meal planning system was the biggest design challenge. A weekly calendar needs to show enough information per meal (recipe name, servings, cook time) without becoming overwhelming. The solution was a day-by-day vertical layout with color-coded meal type badges (lunch, dinner) and inline stat cards that aggregate nutrition and prep time across the full plan. Shopping lists generate automatically from any meal plan, grouping ingredients by category (Protein, Dairy, Produce, Pantry) and consolidating duplicates — if two recipes both need garlic, you see one line item with the combined quantity.
The multi-provider AI integration mirrors the same pattern I used in Cortex: let users pick their preferred provider (OpenAI, Anthropic, Google AI, or local Ollama) and configure it per-account. AI features are entirely optional — the app works fully without any API key. The gamification layer (levels, points, streaks, 16 achievements) was added to make the app stickier for daily use — cooking habits form faster when there’s a visible progress loop.
Impact
AI Providers Supported
Files Implemented
One-Command Deploy