Skip to main content

Environment Overview

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

This page gives the high-level environment map for ZGRID. Use ../99-reference/environment-contract.md for the full variable list. Keep this page at a high level and avoid concrete private hosted endpoints.

Local​

  • API: http://localhost:3000
  • Manager Desk: http://localhost:3001
  • Back Office: http://localhost:3002
  • Landing: http://localhost:3003
  • Docs: http://localhost:3004

Notes:

  • landing public routes are language-prefixed, with / redirecting to the default locale
  • Back Office and Manager Desk are desktop / larger-tablet apps
  • MobileGuard blocks viewport widths below 960px
  • use EMAIL_PROVIDER=dev_log unless intentionally testing real delivery

Staging​

  • API: internal managed entry point
  • Landing: internal managed entry point
  • Back Office: internal managed entry point
  • Manager Desk: internal managed entry point

Notes:

  • keep landing preview private or noindexed if it should not be public
  • use environment-managed secrets only
  • if resident payments are enabled, keep them on mock / staging provider unless a real provider is explicitly integrated

Production​

  • API: managed production entry point
  • Landing: public production domain
  • Back Office: managed production entry point
  • Manager Desk: managed production entry point

Notes:

  • production root for landing should redirect to /bs
  • do not run mock resident payment provider in production
  • do not claim Monri or production resident card payments are live unless a real provider is integrated

Cross-Environment Rules​

  • do not commit secrets, keys, or tokens
  • internal apps use app-level language switching
  • do not add /bs and /en URL routing to internal apps unless explicitly decided later
  • keep concrete internal service URLs in restricted operational tooling, not in the public docs portal