Development Server Guide

Starting the Dev Server

Run yarn nx dev from the repo root. This starts both the Astro dev server and the watch script that incrementally rebuilds packages on file changes.

Browser automation (claude-in-chrome): you may need to manually accept the self-signed certificate once at the local dev URL before automation works.

Per-Product Reference

| | AG Charts | AG Grid | AG Studio | |--------------------|-------------------------------|-------------------------------|-------------------------------| | Dev port | 4600 | 4610 | 4620 | | Local URL | https://localhost:4600/ | https://localhost:4610/ | https://localhost:4620/ | | Docs URL pattern | /charts/javascript/${pageName}/ | /${framework}-data-grid/${pageName}/ | /${framework}/${pageName}/ | | Docs content | packages/ag-charts-website/src/content/docs/ | documentation/ag-grid-docs/src/content/docs/ | packages/ag-studio-docs/src/content/docs/ | | Nav config | …/ag-charts-website/src/content/docs-nav/nav.json | …/ag-grid-docs/src/content/docs-nav/nav.json | …/ag-studio-docs/src/content/docs-nav/nav.json | | Gallery metadata | …/ag-charts-website/src/content/gallery/data.json | — | — | | Staging URL | https://charts-staging.ag-grid.com/ | https://grid-staging.ag-grid.com/ | https://studio-staging.ag-grid.com/ | | Production URL | https://www.ag-grid.com/charts/ | https://www.ag-grid.com/ | https://www.ag-grid.com/studio/ |

Staging note: Staging sites do not use the production path prefix (e.g. no /charts prefix on charts-staging.ag-grid.com).

Build Watch Status Monitoring

The watch script (external/ag-shared/scripts/watch/watch.js) writes status to node_modules/.cache/ag-watch-status.json. Check this file to confirm builds have finished before running tests, committing, or starting browser automation.

Key fields:

status: STARTING | RUNNING | BUILDING | IDLE | STOPPED
currentBuild: active build targets and projects (only when BUILDING)
recentBuilds: last 10 builds with status, duration, and errors
targetHistory: per-target success/failure counts

# Wait for idle before operations
while [ "$(jq -r '.status' node_modules/.cache/ag-watch-status.json 2>/dev/null)" = "BUILDING" ]; do
  sleep 2
done

Troubleshooting

Build failures: Check recentBuilds in the status file for error details. Failed builds do not block the watch loop — subsequent file changes will trigger new builds.

Nx daemon disabled: The watch script requires the Nx daemon. If it reports "Nx daemon has been disabled", run:

yarn nx reset && yarn

Repeated respawn errors: If you see "Repeated respawn detected", the Nx daemon is likely in a bad state:

yarn nx daemon --stop
yarn

Check .nx/cache/d/daemon.log for details.

Git operations pausing builds: The watch script automatically pauses builds while git operations are in progress (detects index.lock, rebase-merge, rebase-apply, MERGE_MSG). Builds resume automatically once the git operation completes.