household.roles()People with different jobs
Owner, member and helper roles sit on top of server-side permission checks and household-scoped access.
visitor@sultaning:~/work$ open homechef-os
CASE STUDY / PLATFORM
HomeChef
OS
An operating system for the household kitchen. HomeChef OS connects recipes, planning, shopping, pantry state, people and guided cooking into one coordinated workflow.
open live beta ↗HOME CHEF OS / HOUSEHOLDbeta
Recipes + Discoverycurated content · saved recipes · multilingual snapshots
↓
Weekly Planmeals · slots · household schedule
↓
Shoppingtrips · budget · supply links
Pantrystock · expiry · missing staples
↓
Assign → Chef Modewho cooks · guided steps · timers · completion
Ownercontrol
Memberparticipate
Helperoperate
01 / THE SYSTEM
The recipe is only the beginning.
Most cooking products stop at finding or saving a recipe. HomeChef OS continues into the operational work around it: deciding what to cook, coordinating a household, buying what is missing, understanding what is already available, assigning the cooking and guiding the person who actually prepares the meal.
01Choosediscover or select a recipe
02Planplace it into the household week
03Shopaggregate what the plan requires
04Assigndecide who will cook
05Cookfinish through guided Chef Mode
02 / HOUSEHOLD
Designed around a household, not a single user.
The core data model is household-scoped. Owners, family members and helpers can participate with different access, while shared state — schedule, pantry, shopping and cooking tasks — remains coordinated around one home.
schedule.week()Shared meal planning
A Sunday-based weekly planner supports multiple recipes, custom meal slots and operational changes across the week.
shopping.session()Shopping as a workflow
Categorized trips connect planned recipes with pantry state, price tracking, completion and guest Supply Links.
cook.assign()From task to completion
Cooking assignments persist across devices and move from queued to cooking to done through the guided flow.
03 / INTELLIGENCE
Content is treated like structured infrastructure.
Behind the consumer experience is an Arabic-first Content Studio and a canonical ingredient system. Recipes can be imported, translated, versioned, published as immutable locale snapshots and enriched with AI-generated metadata and media without turning the runtime product into an AI demo.
content.publish()Versioned recipe publishing
Drafts become immutable published snapshots per locale, with rollback creating a new draft instead of mutating history.
ingredient.resolve()Canonical ingredient identity
Multilingual aliases resolve into canonical ingredient IDs used by recipe, shopping and pantry workflows.
ai.gateway()Provider-separated AI tools
Recipe parsing, translation, tagging, step generation and image creation flow through an AI gateway rather than leaking provider logic across the product.
localize()Language is operational
Arabic, English and additional household languages are handled as content and UI concerns, including RTL and server-resolved mobile display values.
04 / ARCHITECTURE
A real platform behind the interface.
The same Express REST API serves the React web product and the native React Native client. Authentication is stateless Firebase Bearer auth, household context is resolved server-side, PostgreSQL stores the operating model, Cloudflare R2 handles media and the mobile path has its own native build and TestFlight delivery pipeline.
330documented API routes across public, household and admin surfaces
Web + Nativeseparate clients consuming one REST backend and shared contracts
5 localesArabic, English, Tagalog, Bengali and Amharic represented in the platform
PostgreSQLhousehold, content, shopping, pantry, scheduling and analytics state
Firebasestateless token authentication with server-side actor and role resolution
R2 + AIdeduplicated media storage and provider-separated recipe intelligence
05 / MINI → OS
Same product lineage. Different job.
HomeChef Mini was deliberately reduced to a sharp market entry: capture cooking content and turn it into a useful recipe. HomeChef OS solves the larger problem that begins after the recipe exists. The two are presented separately because their user promise, scope and runtime systems are intentionally different.
HomeChef MiniCapture the recipe. Fast import, structure, translation and useful cooking context.
→
HomeChef OSRun the kitchen around it. Plan, shop, stock, coordinate and cook across the household.
06 / MY ROLE
From product model to operating system.
The work spans product direction, household workflow design, information architecture, backend contracts, AI-assisted content systems, multilingual UX, native mobile architecture, operational tooling and the decisions required to move a broad idea into a working beta platform.
PRODUCTScope, household model, workflows and feature decisions.
DESIGNWeb and mobile information hierarchy, RTL and kitchen-first interaction.
ENGINEERINGREST platform, data model, auth, AI, media, mobile and delivery architecture.
07 / PLATFORM ENGINEERING07 / هندسة المنصة
Multiple clients. One operating model.واجهات متعددة. نموذج تشغيلي واحد.
HomeChef OS keeps web, native mobile, household operations, content and AI on one coordinated backend model. The technology is organized around shared household state rather than around individual screens.يبقي HomeChef OS الويب والجوال الأصلي وتشغيل المنزل والمحتوى والذكاء الاصطناعي على نموذج باك إند منسق واحد. التقنية منظمة حول حالة منزلية مشتركة، لا حول شاشات منفصلة.
LanguagesاللغاتTypeScript · SQL
WebReact · Vite · TanStack Query · Tailwind · Shadcn
MobileReact Native · native iOS / Android builds · Firebase Authentication
Backendالباك إندNode.js · Express · REST API · Drizzle ORM
Data & Mediaالبيانات والوسائطPostgreSQL · Cloudflare R2 · deduplicated media pipeline
AI Layerطبقة الذكاء الاصطناعيprovider-separated AI gateway · parsing · translation · tagging · step generation · media intelligence
Identity & Accessالهوية والوصولFirebase · Bearer auth · household-scoped roles · server-side permission resolution
Runtime & Deliveryالتشغيل والتسليمNode.js application runtime · stateless API services · web production pipeline · native builds · TestFlight · Codemagic
WebReact · Vite
Native MobileReact Native
↘ ↙
REST PlatformNode.js · Express · shared contracts
↓
Household Contextactor · role · household scopeالمستخدم · الدور · نطاق المنزل
↓
Recipes
Planning
Shopping
Pantry
Cooking
Content
↓
PostgreSQLoperating stateالحالة التشغيلية
Cloudflare R2media storageتخزين الوسائط
AI Gatewayprovider-separated intelligenceذكاء مفصول عن المزوّد
The platform has many surfaces, but the household operates against one shared truth.للمنصة واجهات كثيرة، لكن المنزل كله يعمل على حقيقة مشتركة واحدة.