Skip to main content

Manager Desk Runbook

Last reviewed: 2026-04-21
Maintained by: Engineering

Purpose​

apps/manager-desk is the manager-facing workspace for organization-scoped operations (buildings, issues, service requests, onboarding, finance/comms modules).

Run Locally​

pnpm run dev:manager-desk

Expected URL:

  • http://localhost:3001

Prerequisite:

  • API should run on http://localhost:3000

Key Folders / Where Logic Lives​

  • App routes: apps/manager-desk/app
  • Shared UI + shell/auth providers: apps/manager-desk/components
  • Feature modules (issues, service requests, buildings, payments): apps/manager-desk/features
  • API adapters/types/i18n: apps/manager-desk/lib

Minimum PR Checks​

pnpm run check:manager-desk
pnpm run lint:manager-desk
pnpm run test:manager-desk

How to Debug Startup Failure​

  1. Confirm API is up:
  • http://localhost:3000/api/health
  1. Restart manager app:
pnpm run dev:manager-desk
  1. If stale artifacts suspected:
rm -rf apps/manager-desk/.next
rm -f apps/manager-desk/tsconfig.tsbuildinfo
  1. Re-run type check to identify compile blockers:
pnpm run check:manager-desk