Admin Release and Environments

This guide is for admins and new team members who support deployment and release operations.

Environment model

The app is typically managed across:

  • Development: active feature work and validation
  • Staging: pre-release verification
  • Production: live customer usage

Release flow at a glance

  1. Develop and validate changes in development.
  2. Build frontend assets.
  3. Deploy to staging and run final checks.
  4. Deploy to production.
  5. Monitor behavior and support tickets.

Core commands

Run these from the app repository:

npm run tunnel
npm run build
npm run deploy:dev
npm run deploy:staging
npm run deploy:prod
npm test
npm run lint
npm run type-check

Critical deployment note

Always run npm run build before any deploy command. If you skip build, Jira can serve stale frontend assets.

Suggested pre-release checklist

  • npm run lint passes
  • npm run type-check passes
  • npm test passes
  • npm run build completes successfully
  • Staging validation completed for map, tasks, and SEAM views

Post-release checks

  • Open app in a test project and verify load time and rendering
  • Create and update one stakeholder entry
  • Create and complete one communication task
  • Update one SEAM current/desired pair and confirm save