HEJI projects monorepo

One public repo for several products. Each lives in projects/<name>/ with its own Cloudflare site/Worker, mobile and desktop apps, docs and release settings. They share one Supabase project, one npm workspace and the CI plumbing.

Project	What	README
Waypack	Offline trip bundles: MCP server + Worker site, Flutter app (iOS, Android, macOS)	projects/waypack
Wee Hours	Hands-free newborn log: iPhone + watch app with on-device voice (Swift), Even G2 glasses app, site + MCP Worker	projects/weehours
FeedbackKit	In-app feedback with a closed fix loop: SDKs (iOS/macOS/watchOS, Android, web, Flutter, React Native, desktop), dashboard, Portal apps, CLI + MCP. Own Supabase project (BACKEND=own)	projects/feedbackkit
Voxbrief	Voice memos on Apple Watch → clean Markdown notes on iPhone/Mac, transcribed and rewritten on the device (Swift, Whisper + Qwen3). No backend (BACKEND=none)	projects/voxbrief
Meowtrix	Remote workspace for vibe engineering: self-hosted Node server (split panes of terminals, browsers, editor), macOS desktop apps (Tauri). No backend (BACKEND=none); standalone npm project with its own lockfile	projects/meowtrix
Contempo	AI-native hour tracker for STR material-participation tests: Android + Wear OS (Kotlin), iOS + watchOS (Swift), web app + admin + API on its Worker. Moved off Firebase onto the shared Supabase project (schema contempo)	projects/contempo
ToddlerCam	Dual-camera app for toddlers (front + rear at once, face-tracking masks, toddler lock) with an Apple Watch remote for the parent (Swift). Kids Category, no backend (BACKEND=none)	projects/toddlercam
TinyTouch	Toddler lock + low-stimulation play on Apple Watch (touch shield, Digital Crown toys, 3-second parent hold) with an iPhone remote (Swift). Kids Category, no backend (BACKEND=none)	projects/tinytouch
G2 Digest	A brief compiled ahead of time into glanceable cards for Even G2 glasses + R1 ring and pre-made audio: web app + brief editor + G2 preview, Even Hub plugin, MCP for the build agent (one Worker, TypeScript)	projects/g2digest
Headway	Caltrain status on Even G2 glasses + R1 ring and iPhone alerts (delays, cancellations, leave now, before your stop): Even Hub plugin, iPhone app (Swift), site + API + alert cron + MCP Worker (TypeScript)	projects/headway
FitLoop	The fitness and nutrition plan your own AI agent writes over MCP, followed and checked in on iPhone + Apple Watch (Swift), the web and Even G2 glasses, with in-the-moment feedback back to the agent (one Worker, TypeScript)	projects/fitloop
Tether	Phone-to-monitor tiling split-pane desktop workspace with Browser (web), SSH-only Terminal (ssh), and Local + SFTP Files (files) for iOS (Swift/UIKit), Android (Kotlin/Compose), and Web + MCP Worker (TypeScript)	projects/tether
Trading Plan Board	Dated, collaborative trade plans: hosted agents debate over MCP, only the owner approves (portal, Google/Apple + TOTP), a local executor validates, re-quotes, sanity-checks with a local model and places through the official Robinhood MCP. One Worker + a Node executor (TypeScript)	projects/tradeboard
Polymath	Agent-native interactive course player & extensible learning runtime: desktop app (Tauri v2), course component SDK, managed agent workspace authoring, and MCP server	projects/polymath

Layout

projects/<name>/        everything one product owns (apps, services, packages, site, docs)
  release.env           how scripts/cut_release.sh releases it
  review.env            its App Review demo account (scripts/review_account.sh, skill heji-review-account)
supabase/               the shared Supabase project: config, schemas/<name>/, one migrations/ history
scripts/cut_release.sh  releases one project: scripts/cut_release.sh <name> [patch|minor|major|x.y.z]
scripts/review_account.sh <name>   App Review demo account: Worker secrets, live check, App Store Connect (asc_review_details.mjs)
scripts/db_migration.sh new migration for one project; check_supabase.mjs keeps projects apart
scripts/check_isolation.mjs, graduation_check.sh   each project can leave for its own Supabase (supabase/GRADUATION.md)
branding/               marketing for every product: promo-videos/ (one Remotion project, media git-ignored; branding/README.md)
pages/                  the GitHub Pages site for every app (npm run pages:dev); project docs come from projects/<name>/docs
.claude/skills/         agent skills: heji-new-project, heji-migrate-project, heji-candidate-review, heji-fix-ci, heji-new-skill, heji-archive-reports, heji-build-next, heji-even-hub-submit, heji-update-toolchain, heji-report, heji-review-account, heji-remotion, heji-promo-video, heji-demo-video, heji-google-flow, heji-youtube-studio-upload (.agents/skills/ links them for Codex, Antigravity, Gemini CLI, Cursor…)
.github/workflows/      <name>-*.yml per project
.github/actions/        apple-signing, evenhub-login (shared), <name>-toolchain
package.json            npm workspaces: projects/*/packages/*, projects/*/services/*, projects/*/apps/*
tsconfig.base.json      shared TypeScript settings

npm install                 # every project's workspaces
supabase start              # shared local stack (ports 554xx)
npm run build:waypack       # per-project scripts: build:<name>, test:<name>, typecheck:<name> (waypack, weehours, g2digest, headway, fitloop, tether, tradeboard)

Adding a project

1. Code in projects/<name>/: Node packages under packages/ or services/, apps under apps/ (any of them with a package.json is picked up by the workspaces; name them @<name>/…). Add build:/test:/typecheck:<name> scripts to the root package.json.
2. Backend: projects/<name>/backend.env (copy Wee Hours'): which Supabase project it uses and the only files allowed to contain its coordinates. Projects share the HEJI project until they graduate to their own; keep that possible (supabase/GRADUATION.md). Database: its own Postgres schema (named after the project, so the folder name must be a valid identifier) and Storage bucket. Tables go in supabase/schemas/<name>/; generate migrations with scripts/db_migration.sh <name> <what>. Read supabase/README.md first: users, auth settings, the service key and the plan's quota are shared (that's the point). Wee Hours is the worked example of a non-legacy project.
3. CI: .github/workflows/<name>-ci.yml with paths: covering projects/<name>/** and the shared root files (copy waypack-ci.yml). Release workflows trigger on release: published and must skip other projects' tags: if: startsWith(github.event.release.tag_name, '<name>-v'). Name its GitHub variables and secrets <NAME>_… (only the Apple team signing secrets are shared).
4. Docs: projects/<name>/docs/ with an index.md (and optionally pages.json for the sidebar) appears on the site as /<name>/; add a card for the app to pages/index.md.
5. Releases: projects/<name>/release.env (copy Waypack's) with TAG_PREFIX="<name>-v" and LATEST=false. Waypack owns the repo's "latest" release: its installed Mac apps update from releases/latest.
6. Cloudflare: a Workers Builds project per Worker, root directory = repo root, deploy command cd projects/<name>/services/<worker> && npm run deploy, build watch paths .