Moped parcel tracker

A tracking page for InPost parcels. It shows the same live status as InPost, but on a game-style city map where a courier on a moped drives the parcel to the customer.

• No backend. The page reads InPost's public tracking API (api-shipx-pl.easypack24.net) straight from the browser. It needs no API key.
• InPost's own wording. Every status title and description comes from InPost's status list, in Polish or English, so customers see exactly what InPost says.
• Live. It re-checks every 60 seconds and whenever the customer comes back to the tab. It stops once the parcel is delivered.
• No typing for customers. The tracking number is in the link.

How to use it

1. Send the parcel at InPost as usual and copy the tracking number.
2. Open the site with no parameters (e.g. https://your-site/). Paste the number and press Utwórz link, then Kopiuj.
3. Send that link (https://your-site/?p=<number>) to the customer.

?p=demo shows a demo with buttons for every stage.

New parcels can take a few hours to appear at InPost. Until then the page says so and keeps checking.

Menu page

snusshop.pl/menu shows the flavour section on its own, so the seller can send it to customers who ask for the menu in DMs.

Basket: customers pick a flavour, set a quantity with − / +, and tap Dodaj do koszyka (Add to basket). Repeat for other flavours. A basket bar at the bottom opens the basket, where they can change quantities or remove items. Wyślij zamówienie na Instagramie (Send order on Instagram) copies one message listing every item and the total number of pieces. Instagram can't pre-fill a DM, so a "Zamówienie skopiowane" (Order copied) screen then shows the three taps (message box → Paste → Send), a preview of the order and an Otwórz Instagram (Open Instagram) button. The "Zamów ponownie" (Order again) button uses the same screen. The basket is saved on the customer's phone, and the same basket appears on the menu page and on tracking pages; there, the message also includes their parcel number. The home page (link maker) has a Menu button and a Kopiuj link do menu (copy menu link) button. /menu is set up as a rewrite in vercel.json; locally, use ?menu.

Link previews (Instagram, WhatsApp, Messenger) use assets/og.jpg.

18+ confirmation

The flavours, basket and ordering only show after the visitor taps "Tak, mam 18 lat" (Yes, I'm 18). On /menu the question appears straight away; on tracking pages the parcel tracking stays open and only the flavour section is locked, behind "Pokaż smaki (18+)" (Show flavours, 18+).

• "Yes" is remembered on the phone for ageGateDays (30) days.
• "No" keeps the flavours hidden for that visit.
• The EU nicotine warning is shown with the question and under the flavours.
• Turning it off: set ageGate: false in config.js.

This is a self-declaration, not an ID check.

The map

The page shows a dark, game-style city map with four pins: Warehouse — dispatch → InPost sorting hub → Local depot → your Paczkomat / home. A courier on a moped drives along the glowing route between them:

InPost status	Moped
created / confirmed	parked at the warehouse
sent / collected	driving to the sorting hub
at the sorting centre	parked at the hub
sent from the sorting centre	driving to the local depot (crosses the bridge)
at the destination branch	parked at the depot
out for delivery	driving to the customer
in the Paczkomat / delivered	parked at the customer's pin
returned, undelivered, expired…	stopped, shown in red

InPost doesn't publish the courier's GPS position, so the map position is an estimate. Each InPost update moves the moped to the correct stage. Between updates it creeps closer to the next pin, based on how long that stage usually takes. The page tells customers the position is approximate.

The city is generated in the browser (no map service or API key needed). Each tracking number gets its own city layout. On phones the map rotates so the route runs top-to-bottom. Śledź / Follow zooms in on the moped, and Trasa / Route shows the whole route.

The map can be moved and zoomed within the city's limits:

• Computer: drag to move, scroll wheel or double-click to zoom.
• Phone: two fingers to move and pinch-zoom. One finger still scrolls the page, and a short tip explains this.
• Both: the + / − buttons zoom in and out.

The map only redraws while something is moving, so an idle page uses almost no battery. While someone is dragging or pinching, the page slides the already-drawn map instead of redrawing it, and redraws once, sharply, when they let go. Decorative pins are hidden when zoomed out past the whole-route view.

Extra features

extras.js and extras.css add these. Each one is switched on separately under extras in config.js; currently only 2 (order) and 9 (myParcels) are on. Add &preview=1 to any link to try all of them:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗