Local development

Preferred: hstack (recommended)

If you’re developing Happier in this monorepo, the supported workflow is to run everything via hstack so ports, auth, DB, caches, and runtime state are isolated per stack.

Start with:

• /docs/hstack/setup
• /docs/hstack/development
• /docs/hstack/quickstarts

One-time setup

hstack setup --profile=dev

Run a dev stack (pinned to the canonical dev/ checkout)

hstack stack new dev
hstack stack wt dev -- use dev

Interactive development (preferred):

hstack tui stack dev dev
# mobile dev-client + QR:
hstack tui stack dev dev --mobile

If you can’t use the TUI (non-interactive terminals / CI), run:

hstack stack dev dev

Legacy/manual (not stack-scoped)

If you’re not using hstack, these commands can be useful, but they are not stack-scoped (they share ports/auth/caches with your machine and can be harder to run in parallel).

yarn install

Then run the server:

• Full flavor:

yarn --cwd apps/server dev

• Light flavor:

yarn --cwd apps/server dev:light

App (web UI)

The app can run as Expo web locally:

yarn --cwd apps/ui web

Website

yarn --cwd apps/website dev