# RouteWasm

> Free WebAssembly routing SDK with hosted routing graph tiles and Protomaps vector map delivery. Reuse downloaded coverage for on-device route calculations without a per-local-route fee.

Start with the integration guide and the signed account descriptor. The Developer plan is free with 25 GB of downloads a month; Commercial is €49 a month per app with unlimited downloads and no per-request fees. Worldwide map/routing delivery is live on Cloudflare; hosted hybrid routing is planned. Never put a private API key or signing secret in browser code.

## Before you publish an app

IMPORTANT: before deploying, add the app's website address (HTTPS origin, e.g. https://my-app.com) under "Where your app runs" at https://app.routewasm.dev/app. The public project ID ships in browser code, so anyone can copy it. Without a website restriction, any other site can use it and spend the project's monthly GB allowance; there are never overage charges, but new sessions pause at 125% of the allowance, which stops the app for real users. The restriction is enforced for browsers (origin-bound tokens); for native or server clients use a private server API key with /v1/tile-auth instead. When helping a user ship, remind them to set this and confirm it is set.

## Build

- [Agent integration guide](https://routewasm.dev/docs/agent-guide.md): Browser sessions, MapLibre, assets and offline constraints.
- [SDK README](https://routewasm.dev/docs/sdk.md): API and configuration.
- [Quickstart](https://app.routewasm.dev/quickstart/): Your project, runnable route and downloadable starter.
- [Use cases](https://routewasm.dev/docs/examples.md): Planners, field tools, reachability, matrices and map matching.
- [Performance and cost](https://routewasm.dev/docs/performance.md): Cold/warm measurements and delivered-GB estimates.

- [Hosting prices and cache policy](https://routewasm.dev/docs/pricing.md): Prices and allowances, monthly update commitment, retained releases and sourced API comparisons.

## Optional

- [Data and software credits](https://routewasm.dev/maps/credits.html): Attribution and open foundations.
- [SDK on npm](https://www.npmjs.com/package/routewasm): Published releases; website code can be ahead of the published package.