Naalya Handbook
Using Chowbea

The Chowbea task map

Getting a backend type into the Education Hub — regenerate the client, export on the type bus, import the result.

The ticket is usually "the Hub needs this type" or "I added an endpoint and the Hub doesn't know." Which pipe you reach for is decided in How Chowbea works; these pages are the mechanics.

Keeping the Hub client in sync

api:watch, extract, and what you must never edit.

Exporting a type on the bus

A *.chowbea.ts barrel, extract, and the closed-world rule.

Using a bus type in the Hub

Import from _generated/bus — worked examples.

The Generated Client

The REST half, in Hub data-layer depth.

Invalidating Hub queries

After a DB write, publish a domain action so every open Education Hub screen refetches the right React Query keys.

Keeping the Hub client in sync

How extract, the bus endpoint, and api:watch fit together so a backend change shows up in the Education Hub.