Skip to main content
Run commands from the repository root unless a section says otherwise.

​
Mobile development

The app requires native modules, so create a local native build before using Metro. When environment values change, restart Metro because Expo inlines EXPO_PUBLIC_* references into the client bundle.

​
Configurator development

The Nx target starts the Configurator’s Express and Vite server. The default port is 5173, or the value of PORT if set. The tool reads and writes files in the local checkout; do not expose it as a hosted production service. Build its web client with:

​
Documentation development

The docs target runs mint dev with apps/docs as its working directory. Generate API reference pages and run the production content gate from the repository root:
docs:build generates the TypeDoc reference through its Nx dependency, then runs mint validate. Use bun run docs:serve when you want the same long-running local preview as docs:dev under the serve target. Run additional Mintlify checks directly from the docs workspace:

​
Code quality

  • lint runs biome lint ..
  • format runs biome format . and reports formatting output according to Biome’s CLI behavior.
  • check runs the combined Biome checker.
  • verify runs affected Nx lint, typecheck, and test targets.

​
Cache and native troubleshooting

  1. Try bun run start:clear for JavaScript or Metro resolution issues.
  2. Run bun run nx:reset if Nx cache state is stale.
  3. Run bun run clear only when native projects must be regenerated.
  4. Run bun run doctor after dependency or Expo SDK changes.
The root reset script deletes dependencies and several caches before reinstalling. Review that script before using it, especially when local state is important.