HaloStack Docs

HaloStack is a template monorepo for building type-safe product apps. It gives you a working web app, API, docs site, landing site, mobile app, worker, shared libraries, local services, and deployment automation before you write product code.

It is also built to live beyond the first fork. The template lineage system records reusable changes as typed entries, generates the changelog, and lets downstream projects see what they have not yet ported.

Start here

Setup — run the Bun workflow with Docker-hosted services.
Goals & Philosophy — understand the repo shape and the template model.
Operations — deploy with Railway IaC, GitHub Actions, Cloudflare R2, and preview environments.

The stack

Layer	Technology
Runtime & package manager	Bun 1.3.14
Build system	Turborepo
Language	TypeScript 6, strict
Linter / formatter	Biome 2.4
Web app	TanStack Start, TanStack Router, Vite, React 19
API	Elysia on Bun, with Eden Treaty client
Docs	Fumadocs on TanStack Start
Landing	Astro, static build
Mobile	Expo, React Native, NativeWind
UI	shadcn/ui + coss UI + Base UI + Tailwind CSS v4
Data	Drizzle + Postgres
Runtime services	Redis, S3-compatible object storage, SMTP
Env	envalid through `@halostack/env`

What's inside

Apps — web, API, docs, landing, mobile, and worker.
Packages — shared runtime libraries for UI, auth, data, storage, notifications, telemetry, jobs, localization, AI, Redis, and seed data.
Config — shared TypeScript bases, validated environment config, and design token generation.
Tools — scaffolding, scripts, screenshots, test harness, Docker assets, git hooks, Graphify automation, and template lineage.
Operations — Railway topology, env sync, GitHub Actions deploys, R2 bootstrap, and downstream template sync.

Browse the sidebar for a guide to each area. The AGENTS guides remain the agent-facing source of truth; these docs are the reader-facing map.