This section covers how to work with the Hype Stack codebase day-to-day: the folder structure, dev workflow, and key concepts.
apps/
backend/ # Hono API server (Prisma, Kysely, Redis)
frontend/ # React SPA (TanStack Router, Tailwind, HyperFetch)
packages/ # Shared code across apps
docker-compose.yml
nx.json # Task orchestration
pnpm-workspace.yaml
The apps/ folder holds deployable applications. The packages/ folder holds shared libraries that apps import.
Start everything with one command:
pnpm dev
This runs both the backend and frontend dev servers through Nx, with hot reload on both sides. The backend runs on port 3000, the frontend on port 4200.
| What | Where |
|---|---|
| API routes | apps/backend/src/features/ |
| Database schema | apps/backend/prisma/schema.prisma |
| Frontend pages | apps/frontend/src/routes/ |
| UI features | apps/frontend/src/features/ |
| Shared components | apps/frontend/src/components/ |
| API client (SDK) | apps/frontend/src/api/ |
| Theme tokens | apps/frontend/assets/styles.css |
| Env variables | .env files in each app |