Hetu Monorepo

Hetu is a account system for Minecraft servers.

This repository hosts the Hetu backend (Elysia + Drizzle) and web client (Next.js App Router) plus shared packages managed by Turborepo and Bun.

Workspaces

• apps/backend: API server with routes under src/modules/**, config in config.*.yaml, and Drizzle migrations in migrations/.
• apps/web: Next.js front-end (app/**) that shares UI and API helpers from packages/*.
• packages/*: Shared UI kit, API client, lint/ts configs, etc.

Development

bun install
bun run dev        # turbo dev across all workspaces
bun run lint       # eslint + prettier
bun run typecheck  # ts --noEmit checks

Use turbo run <task> --filter=@repo/<pkg> to target a single app/package.

Deployment Notes

• Build everything with bun run build; CI should also run bun run lint + bun run typecheck to catch regressions.
• Backend deployments must ship a matching config.<env>.yaml, run bun run migration:run before starting, and expose the configured port/URL from config.example.yaml values.
• Web deployments rely on a .env.production.local (or platform-specific env vars) that mirror apps/web/.env.development.local; make sure API base URLs point at the deployed backend.
• When using Dockerfiles (Dockerfile.package-backend / Dockerfile.package-web), pass the correct build args/secrets and persist the Bun cache volume to avoid re-install storms.