Documentation

Install & build

How to install dependencies, run tests, build static outputs for both brands, and preview the production bundles.

Commands and lifecycle scripts for building Haulpoint for production.

Available scripts

Haulpoint comes with six npm scripts configured in package.json: dev, build, check, validate, test, and package.

ScriptCommandDescription
dev astro dev Start local development server
build node tools/build.mjs Build both brands to static output directories
check node tools/check.mjs Run the 12-section production verification suite
validate node tools/validate-data.mjs Verify shipment records against E1-E6 rules
test node tools/test-logic.mjs Run pure logic assertions
package node tools/package.mjs Create clean distribution zip in release/

Building both brands

Running npm run build invokes tools/build.mjs, which runs Astro build for each configured brand. Output is written to distinct brand directories under dist/, with sitemaps and pruned assets.

$ npm run build

Previewing production output

Use tools/serve.mjs to serve the dist/ directory locally and run a smoke test across all routes.

$ node tools/serve.mjs --smoke
$ node tools/serve.mjs --port 8983 --seconds 60

Explore further

Ready to see the platform in action?

Review live track events or explore operations in the control tower.