Waypoints

Commute users

Invite someone by email — Cognito sends them a temporary password. They sign in at /commute/ and manage their own routes.

API usage & limits

Every external API the site calls this month, against its free ceiling. Expand a row for the rate-limit / pricing spec.

AI spend cap

—

Adding an API? add a row to API_REGISTRY in the waypoints Lambda and a bumpApi() call on the upstream fetch.

Commute — Google Routes cost

Routes is the only per-call cost. These levers and the counter below cap and track it.

Routes — how much detail

Controls the FieldMask on the Routes call and how much of the road block the card shows. "trip distance" adds one field (still the Advanced SKU).

Home page layout

Order and width of the panels on the public home page. The Full/Half button sets a panel to sit side by side with an adjacent half-width panel on wide screens (stacks full-width on narrow ones). Applies to every visitor within a few seconds of saving.

Maze

Grid shapes, complexity, and timed mode for the homepage Maze widget. Visitors pick among whichever shapes are enabled here; changes apply within a few seconds of saving.

Marble

Tunes how the marble moves and the trail it leaves in Marble mode. Settings are fetched fresh (no caching) once when /marble/ loads, so changes apply the next time someone loads that page — not to an already-open tab.

Speed & feel

Top speed: the cap on how fast the marble can ever move, no matter how hard or fast you drag. Pull gain: how eagerly the marble chases your finger from a distance — higher catches up faster, lower lags further behind before it starts moving. Ease rate: how quickly the marble's actual motion catches up to where it wants to go — lower feels softer and laggier, higher feels tighter and more direct. Friction: how fast the marble grinds to a stop once you let go — lower stops it almost instantly, closer to 1 lets it keep rolling/coasting.

Trail mark

Trail fade: how quickly the sand trail fades away behind the marble — lower makes it linger longer, higher erases it faster. Groove darkness (base): how dark the trail mark is when the marble is moving slowly. Groove darkness (+speed): how much darker the trail mark gets at top speed, on top of the base darkness. Groove width: how wide the dark trail mark is, relative to the marble itself.

Glow

Glow width: how wide the warm glow halo around the marble is — 0 turns the glow off entirely. Glow brightness (base): how bright the glow is when the marble is moving slowly. Glow brightness (+speed): how much brighter the glow gets at top speed, on top of the base brightness. Could add later: the glow's tint colors (light/dark-mode rgb pair) as color pickers — a separate, smaller follow-up.

Aircraft

Live aircraft near the page location (ADSBexchange via RapidAPI). Fetched on demand only while the homepage panel is visible, with a ~40s shared cache. RapidAPI Basic is a hard 10,000 requests/month cap, so the daily cap below is what keeps a month from draining in days. Usage + projection show in "API usage & limits" above. Leave disabled until the key is set in Secrets Manager.

The homepage panel loads once and does not auto-refresh; a "Refresh" button on it is shown to signed-in admins only.

Map views

Which views the panel offers. Visitors pick among the enabled set (remembered per browser); "Map" is a vector geographic view with US state outlines, rivers and lakes drawn from local data (assets/usmap.js, ~53 KB gzip, loaded only when first shown).

Traffic filters & alerts