Project Structure

Last reviewed: 2026-05-13
Maintained by: Engineering

This page is the short orientation map for the Zgrid monorepo.

Workspace layout

apps/api: Express API, auth, business rules, data access, and integration boundaries
apps/back-office: super_admin web workspace
apps/manager-desk: organization-scoped manager workspace
apps/zgrid-mobile: Expo mobile app for tenant and technician flows
apps/docs: Docusaurus shell for the internal docs portal
packages/api-client: shared typed API client and contracts
packages/validation: shared validation utilities
database: SQL migrations, schema snapshot, and bootstrap artifacts
docs: canonical markdown source for engineering documentation

The repo uses pnpm workspaces with apps/* and packages/*.
Most common team commands are exposed from the root package.json.
App-specific dependencies should stay in the workspace that uses them.
Shared contracts and reusable utilities should move into packages/* instead of being duplicated across apps.

For dependency and script rules, see ../99-reference/monorepo-standards.md.