User Manual

This manual is generated live from the app's own rules, templates and database. Whenever a feature ships, an ingredient is added, or a recipe is imported, this page updates on the next load.

1. Overview

Headcount
—
Week starting
—
Lock status
Unlocked
Ingredients in catalog
0
Smart dish templates
0
Cookbook recipes
…

2. The 7-Day Matrix

Each day has 5 meals. Cells are one of two colours:

Static staple — auto-added daily, cannot be swapped Variable dish — freely editable and swappable
MealTimeSlots
☕ Bed Coffee6:00 – 7:00Drink
🍳 Breakfast8:00 – 9:30FruitsCerealBBJTea/CoffeeMain 1Main 2ChutneySide
🍛 Lunch12:30 – 14:00CurdButtermilkPapadPhulkaSaladPickleWhite RiceRasamSambarGravyPalyaVariety RiceSweetSoup
🥨 Snacks16:30 – 17:30DishTea/Coffee/Milk
🌙 Dinner19:30 – 21:00CurdButtermilkPickleMilkWhite RiceRasamUpma/RotiPhulkaChutneyPalyaDalMilk/Curd
Source: src/lib/menu.ts › MEALS · STATIC_SLOTS

3. How Grocery Math Works

For every non-empty cell, the estimator resolves ingredients through this priority chain:

  1. Pinned cookbook recipe — parsed grams-per-serving win outright.
  2. Custom overrides — per-cell manual entries.
  3. Auto-detected defaults — static staples + variable dish rules + smart templates.

Totals are then multiplied by the current headcount (75) and grouped by category.

Static staple rules
20
Variable dish rules
5
Smart templates
0
Parsed recipes (driving math)
…
Source: src/lib/menu.ts › computeEntryIngredients

4. Static Staples

Slot(s)IngredientPer person
Drink, Tea/Coffee, Tea/Coffee/MilkMilk100 ml
Drink, Tea/Coffee, Tea/Coffee/MilkCoffee/Tea Powder3 g
Drink, Tea/Coffee, Tea/Coffee/MilkSugar/Jaggery12 g
Milk/CurdMilk60 ml
White RiceWhite Rice (Lunch/Dinner side)55 g
PhulkaWheat Flour/Atta35 g
RasamLemon/Tamarind3 g
CurdCurd60 ml
ButtermilkButtermilk50 ml
SaladSalad Vegetables30 g
PicklePickle6 g
Variety RiceRice for Variety/Special Rice55 g
SoupSoup Vegetables25 g
DalMoong/Chana Dal10 g
ChutneyFresh Grated Coconut10 g
ChutneyGreen Chilies, Ginger, Garlic4 g
ChutneyPeanuts/Groundnuts6 g
FruitsBanana80 g
CerealCorn Flakes20 g
CerealMilk100 ml
CerealSugar/Jaggery8 g
BBJBread Slices40 g
BBJButter6 g
BBJJam8 g
PapadPapad4 g
MilkMilk150 ml
SweetSugar/Jaggery25 g
SweetMilk40 ml
SweetCooking Oil/Ghee6 ml
SweetCashew Nuts2 g
DishCooking Oil/Ghee6 ml
DishWheat Flour/Atta15 g
DishOnions10 g
Source: src/lib/menu.ts › STATIC_STAPLE_RULES

5. Variable Dish Rules

SlotFixed basePrefix veg
Palya—80 g
Sambar
Toor Dal 14 g
Tamarind 2 g
40 g
Gravy—60 g
Upma/Roti
Cooking Oil/Ghee 8 ml
Mustard Seeds 1 g
Onions 15 g
—
Main 1, Main 2
Cooking Oil/Ghee 5 ml
—

Note: dinner Palya uses 80 g (not 100 g) — overridden in variableGramsFor().

Source: src/lib/menu.ts › VARIABLE_DISH_RULES

6. Smart Dish Templates

0 keyword-based templates map a dish name to an ingredient set.

NameMatchesBaseVariants
Source: DB › dish_templates

7. Side-Dish Auto-Reclassify Keywords

When a template is loaded, dishes whose names contain any of these keywords in a breakfast Main slot are moved to the Side slot:

chutneycurrypalyagojjusabjisabzipodipachadithogayalthokkuraitakosambarisagustewkurmakorma
Source: src/lib/menu.ts › SIDE_DISH_KEYWORDS

8. Cookbook

Total recipes
…
Parsed (drive math)
…
Ingredient lines
…
Mapped to catalog
…
By source file
    Source: DB › recipes · recipe_ingredients

    9. Weekly Templates

    Load these from the Weekly Menu's Load Template menu. Locked days are preserved.

    • Starter Week — 224 entries, always available via Reset Week.
    Source: src/lib/menu.ts › STARTER_WEEK · DB › menu_templates

    10. Upcoming Festivals

    • 🪔Diwali2026-11-082 swaps
    Source: src/lib/festivals.ts › FESTIVALS

    11. Ingredient Catalog

    Fresh Vegetables (0)
      Fresh Herbs (0)
        Fruits (0)
          Dairy (0)
            Dals & Pulses (0)
              Grains & Flours (0)
                Oils & Fats (0)
                  Spices (0)
                    Spice Powders (0)
                      Condiments (0)
                        Nuts & Dry Fruits (0)
                          Sweeteners (0)
                            Beverages (0)
                              Bakery & Snacks (0)
                                Dry Groceries (0)
                                  Supplies (0)
                                    Miscellaneous (0)
                                      Source: DB › ingredients

                                      12. Feature Reference

                                      Planning
                                      • 7-Day Menu MatrixPlan Breakfast, Lunch, Snacks and Dinner across every day of the week with slot-level cells.Weekly Menu·since 2026-06-01
                                      • Headcount MultiplierOne control (default 75) scales every per-person weight into total groceries.Weekly Menu › top bar·since 2026-06-01
                                      • Static Staples (red) vs Variable Dishes (blue)Daily staples like White Rice, Phulka and Buttermilk are colour-coded and protected from swaps.Weekly Menu·since 2026-06-08
                                      • Reset WeekRestores the curated Starter Week — including all static staples for every day.Weekly Menu › Reset Week·since 2026-06-05
                                      • Lock / Freeze MenuPrevents any accidental edits once a week has been approved.Weekly Menu › Lock toggle·since 2026-06-10
                                      • Swap DishInterchange any variable dish with another dish or a cookbook recipe of the same family.Cell › 🔄 icon·since 2026-06-15
                                      • Custom Ingredient OverridesPer-cell escape hatch — set a bespoke ingredient + grams for a specific dish.Edit dish modal·since 2026-06-15
                                      • Festival AwarenessDetects festivals near the selected week and offers a one-click sweet-swap template.Weekly Menu › week picker·since 2026-06-18
                                      Grocery
                                      • Grocery EstimatorAggregates every dish × headcount into a single shopping list grouped by category.Grocery Estimator·since 2026-06-01
                                      • Ingredient Priority ChainPinned recipe → Custom override → Auto-detected default. Highest-precedence rule wins.Grocery math (internal)·since 2026-06-15
                                      • Cookbook-Driven DishesParsed recipes drive real grocery math for matched dishes automatically.Grocery › Cookbook section·since 2026-06-22
                                      • Approve Grocery ListMarks the current week's grocery estimate as final for hand-off to procurement.Grocery Estimator › Approve·since 2026-06-12
                                      • Ingredient-aware Rasam/Sambar/Gojju rulesRasam/Sambar/Gojju slot bases no longer add tomato blindly. Variants like Pepper, Garlic, Ginger, Lemon, Pineapple, Jeera, Menthe, Hurulikaalu, Bassaru add only their own ingredients; bare 'Rasam'/'Sambar' still include tomato as the daily fallback.Grocery math (internal)·since 2026-07-02
                                      Recipes
                                      • Recipe Library364+ recipes from 10+ source files, matched to menu cells by dish name.Cell › 📖 icon·since 2026-06-20
                                      • Pin Recipe to CellLocks a specific recipe as the source of truth for one menu entry.Edit dish › Recipe panel·since 2026-06-22
                                      • Bulk Recipe ImporterPaste raw recipe text (or upload files) and the parser extracts ingredients per serving.Master Settings › Recipe Importer·since 2026-06-05
                                      Templates
                                      • Weekly TemplatesStarter Week plus North-South Fusion, Healthy Millets and Udupi & Iyengar weeks.Weekly Menu › Load Template·since 2026-06-18
                                      • Smart Dish DetectionType “Beans Palya” and the app auto-adds Beans @ 100 g/person. Live preview in the editor.Edit dish modal·since 2026-06-08
                                      • Side-Dish ReclassificationChutney / Palya / Gojju / Sagu placed in a Main slot are moved to the Side slot on template load.Template loading (internal)·since 2026-06-20
                                      Admin
                                      • Master Ingredient SettingsEdit default grams-per-person for every ingredient in the catalog.Master Settings·since 2026-06-01
                                      • Dynamic User ManualThis page. Auto-updates from feature registry + live rule tables + database counts.Manual·since 2026-07-02
                                      Source: src/lib/manual-registry.ts › FEATURES

                                      13. Changelog

                                      • 2026-07-02Dynamic User Manual— This page. Auto-updates from feature registry + live rule tables + database counts.
                                      • 2026-07-02Ingredient-aware Rasam/Sambar/Gojju rules— Rasam/Sambar/Gojju slot bases no longer add tomato blindly. Variants like Pepper, Garlic, Ginger, Lemon, Pineapple, Jeera, Menthe, Hurulikaalu, Bassaru add only their own ingredients; bare 'Rasam'/'Sambar' still include tomato as the daily fallback.
                                      • 2026-06-22Cookbook-Driven Dishes— Parsed recipes drive real grocery math for matched dishes automatically.
                                      • 2026-06-22Pin Recipe to Cell— Locks a specific recipe as the source of truth for one menu entry.
                                      • 2026-06-20Recipe Library— 364+ recipes from 10+ source files, matched to menu cells by dish name.
                                      • 2026-06-20Side-Dish Reclassification— Chutney / Palya / Gojju / Sagu placed in a Main slot are moved to the Side slot on template load.
                                      • 2026-06-18Festival Awareness— Detects festivals near the selected week and offers a one-click sweet-swap template.
                                      • 2026-06-18Weekly Templates— Starter Week plus North-South Fusion, Healthy Millets and Udupi & Iyengar weeks.
                                      • 2026-06-15Swap Dish— Interchange any variable dish with another dish or a cookbook recipe of the same family.
                                      • 2026-06-15Custom Ingredient Overrides— Per-cell escape hatch — set a bespoke ingredient + grams for a specific dish.
                                      • 2026-06-15Ingredient Priority Chain— Pinned recipe → Custom override → Auto-detected default. Highest-precedence rule wins.
                                      • 2026-06-12Approve Grocery List— Marks the current week's grocery estimate as final for hand-off to procurement.
                                      • 2026-06-10Lock / Freeze Menu— Prevents any accidental edits once a week has been approved.
                                      • 2026-06-08Static Staples (red) vs Variable Dishes (blue)— Daily staples like White Rice, Phulka and Buttermilk are colour-coded and protected from swaps.
                                      • 2026-06-08Smart Dish Detection— Type “Beans Palya” and the app auto-adds Beans @ 100 g/person. Live preview in the editor.
                                      • 2026-06-05Reset Week— Restores the curated Starter Week — including all static staples for every day.
                                      • 2026-06-05Bulk Recipe Importer— Paste raw recipe text (or upload files) and the parser extracts ingredients per serving.
                                      • 2026-06-017-Day Menu Matrix— Plan Breakfast, Lunch, Snacks and Dinner across every day of the week with slot-level cells.
                                      • 2026-06-01Headcount Multiplier— One control (default 75) scales every per-person weight into total groceries.
                                      • 2026-06-01Grocery Estimator— Aggregates every dish × headcount into a single shopping list grouped by category.
                                      • 2026-06-01Master Ingredient Settings— Edit default grams-per-person for every ingredient in the catalog.

                                      14. Days of the Week

                                      The planner uses ISO order: 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday, 7=Sunday.