Back to the catalog

Milemark knowledge

Bundle OKF 0.2 · 2 conceitos · aaryanporwal/spotter

Open source Repository Open in the app JSON README (API)

About

# Milemark knowledge

Pointers only. Open a linked file only if this task needs it. Do not read the rest of the bundle.

# Orient

* [Source map](map.md) - which files to open for a task; no file contents
* [Invariants](invariants.md) - cross-file couplings that a single source file does not state

Details

Kind
OKF bundles
Topic
Maps, weather & travel
Publisher
aaryanporwal
Origin
okf_github
Category
dados
Version
0.2
Stars
1
Last push
2026-09-03T21:31:09Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-09-08 02:21:44
Updated
2026-09-08 02:21:44
Origin id
aaryanporwal/spotter:knowledge/index.md

README

# Milemark

HOS-aware trip planner for property-carrying drivers. Enter current location, pickup, drop-off, and cycle hours. The app returns a route, required stops, and printable daily log sheets.

Django API + React (Vite, shadcn/Geist). Hosted as a Cloudflare Worker: static frontend plus `/api/*`.

Live: https://milemark-eld-planner.altaaryan.workers.dev

Agent knowledge (Google OKF): [knowledge/index.md](knowledge/index.md)

## Run locally

```sh
uv sync
bun install
bun dev
```

API: `http://127.0.0.1:8808`  
Web: `http://127.0.0.1:5179` (proxies `/api` to Django)

```sh
bun run test
bun run lint
```

## Deploy

Pushes to `main` deploy via GitHub Actions. Add a `CLOUDFLARE_API_TOKEN` repo secret (Cloudflare dashboard → My Profile → API Tokens → Create Token → **Edit Cloudflare Workers**).

To deploy locally, Wrangler must already be logged in:

```sh
bun run deploy
```

That builds the frontend, then `uv run pywrangler deploy`.

## License

MIT. See [LICENSE](LICENSE).

More