Cookbook · how to build the features you actually ship

The Huchu cookbook is a "how to build X" book, not a catalogue. Every recipe walks you through one end-to-end feature — state, data, interactions, edge cases — using primitives, blocks and patterns from the Huchu reference. Start with a goal ("Build a sign-in with 2FA flow", "Build a leave-request workflow"), copy the React, ship.

Cookbook · v0.1 1 recipe live · 18+ coming @corelithzw/react Press / to search
Start here

If it's your first time, build these three

Every Huchu app needs sign-in, a shell to live in, and a way to capture data. Build these three recipes in order and you'll have shipped the spine of an app — everything else is more screens.

01 · Auth

Sign in with 2-step verification

Email + password, then a 6-digit OTP. Resend countdown, trust-this-device, error states. The canonical Huchu auth flow.

Open recipe
02 · Shells

App shell with sidebar nav

The standard operator shell — top bar, collapsible sidebar, content area, keyboard nav. Drop your pages inside and you're done.

Coming soon
03 · Forms

Multi-step wizard with autosave

A 3-step form with validation per step, autosave between steps, and a sticky footer. The pattern most "create" flows want.

Coming soon
All themes

Browse by what you're building

Each theme groups recipes that share the same shape — same primitives, same state machine, same edge cases. If you can't find your feature by name, you'll find a recipe with the right scaffolding here.

Auth

Sign in, sign up, recover, verify. Everything that gates the front door.

Shells & nav

The frame around your app — sidebars, tab bars, command palettes.

  • App shell with sidebarSoon
  • Mobile bottom-tab shellSoon
  • Command-palette navSoon

Forms

Capture data without losing the user halfway through.

  • Multi-step wizardSoon
  • Autosave drawer formSoon
  • Inline edit on rowSoon

Lists & detail

Show many things, then dig into one. The bread and butter of an operator app.

  • Filterable data tableSoon
  • Master–detail pageSoon
  • Day-grouped mobile listSoon

Dashboards

KPIs at a glance, with a clear path from number to detail.

  • Operator overviewSoon
  • KPI hero + drilldownSoon

States

Empty, loading, error, optimistic. The states that decide whether your app feels alive.

  • Empty, loading, errorSoon
  • Optimistic + rollbackSoon

Settings

Profile, security, team — the long-tail of an account.

  • Profile & securitySoon
  • Team & rolesSoon

Approvals & queues

Inboxes of work that someone has to act on. Approve, reject, escalate.

  • Leave-request workflowSoon
  • Inbox + bulk actionsSoon
How recipes work

Each recipe is a working build, not a feature list

A recipe is what a senior engineer would walk a junior through if they had an hour. Crisp rationale, real React, full composition at the end. You copy the code; you don't read about the code.

01

End-to-end React using @corelithzw/react

Every snippet imports from @corelithzw/react — the intended npm surface for the design system. State stays in useState / useReducer. No extra libraries, no hidden magic.

02

Required pieces are listed up front

Each recipe opens with the primitives, blocks, patterns and shells it needs — linked to the reference page so you can study any one in depth before you start.

03

One final composition you can copy

The last section of every recipe is the whole component, assembled. Realistic state machine, error states, variations called out. That's the file you ship.

Need depth on one piece?

The reference is right next door

Recipes are about the build. The reference is about the parts. Jump to a single primitive, block, pattern or shell — props, variants, do/don't — whenever a recipe mentions one.