Skip to content

Aster Debug Checklist

Gateway distribution runtime debugging checklist.

Start from the active distribution:

Terminal window
bun run --filter @aster/distro dev

Then verify the gateway:

Terminal window
curl http://127.0.0.1:4040/gateway/health
curl http://127.0.0.1:4040/gateway/ready
curl http://127.0.0.1:4040/__aster/web/bootstrap

For web development, bun run dev:web starts the Aster distribution first, waits for bootstrap readiness, and then starts the Vite web shell.

When debugging runtime composition, inspect packages/distro/src/index.ts for the product graph and packages/gate/src/runtime.ts for graph ordering and startup phases.