"/home/yossef/notes/git/projects/maplibra/Commands.md"

path: maplibra/Commands.md

- **fileName**: Commands
- **Created on**: 2026-06-16 00:48:42

Commands

Purpose: Common commands for running, testing, and building the project.

Related: ./Home.md, ./Development Workflow.md, ./Testing.md

App

• npm run dev — start the Vite dev server.
• npm run build — build the app with Vite.
• npm run preview — preview a production build.

Tests

• npx vitest run — run the full Vitest suite.
• npx vitest run tests/route-smoothing.test.js tests/route-features.test.js — focused route smoothing verification.
• npx vitest run tests/zip-node-builder.test.js tests/integration-realmap.test.js — graph building and real-map integration verification.
• npx vitest run tests/outdoor-routing.test.js tests/unified-outdoor-route.test.js — outdoor routing verification.
• npx vitest run tests/route-kernel-*.test.js tests/path-worker-binary.test.js — WASM routing verification.
• npx vitest run tests/bootstrap-*.test.js tests/startup-*.test.js — startup verification.
• npx vitest run tests/ui-manager-*.test.js tests/search-box-*.test.js — UI verification.
• npx vitest run tests/perf-budget.test.js tests/performance-routing.test.js — performance verification.

Quality

• npm run lint — ESLint over src/.
• npm run lint:fix — ESLint autofix.
• npm run format — Prettier write over source files.
• npm run format:check — Prettier check over source files.

Routing Assets

• npm run build:nodes — build MVF-derived routing/debug assets from a zip.
• npm run build:routing-binary — build binary routing graph assets.
• npm run build:routing-wasm — build the WASM routing kernel.
• npm run bench:routing-wasm — benchmark WASM routing.

Performance

• npm run perf:phase6 — run routing performance CI script.
• npm run perf:baseline — build and record startup baseline.
• npm run perf:build-analysis — analyze build output.
• npm run perf:build-analysis:verify — build then analyze.

Data Sync

• npm run build:nodes — syncs MVF data and regenerates walkable nodes.
• scripts/sync-data-map.sh — sync temp_mvf/ into assets/ and rebuild my_data.zip.
• scripts/build-walkable-nodes.js — generate walkable_nodes.geojson and optionally walkable_areas.geojson.

Debug URLs

• ?debug=1 — auto-load debug layers

• ?perf — enable startup performance logging

• ?routing.engine=wasm — request WASM routing engine

• ?routing.telemetry=1 — enable rollout telemetry

• ?graph.format=json — request JSON graph format

• ?routing.trace=1 — enable route trace diagnostics

• ?clear — clear cache and show upload screen

• ?skipBundledMap — skip default bundled map

• ?mode=upload — show upload screen

  continue:[[]]
  before:[[]]