Shipment tracker
@eventcrew/shipment-tracker
Track booth gear and swag shipments for events from a CSV or a pasted list of tracking numbers. Detects UPS, FedEx, USPS, and DHL from the number, builds a tracker table with tracking links, and flags anything at risk of missing its needed-by date. Works offline.
- Activity
- New: be the first to try it
- Installs
- 0 installs
- Likes
- 0 likes
- Clones
- 0 clones
- 1# Shipment tracker
- 3Paste your tracking numbers and get one clear table of every box headed to your event: carrier, tracking link, days left, and a loud flag on anything that might not make it. No logins, no carrier APIs.
- 5**Who it is for:** event and field marketing teams, founders running their own booth, anyone who has ever stood at a venue dock asking "where are the banners?"
- 7## Example
- 9Input (`data/shipments.csv`, or just paste it):
- 11```csv
- 12tracking,item,destination,needed_by,status
- 131Z999AA10123456784,Booth backdrop,Expo hall dock B,2026-11-10,in transit
- 14123456789012,Swag: 300 t-shirts,Expo hall dock B,2026-11-06,label created
- 151234567890,Demo laptops,Expo hall dock B,2026-11-03,in transit
- 16```
- 18Output (`out/shipments.md`):
- 20| Flag | Item | Needed by | Days left | Carrier | Status | Why |
- 21| --- | --- | --- | --- | --- | --- | --- |
- 22| LATE | Demo laptops | 2026-11-03 | -1 | DHL | in transit | needed 1 day(s) ago |
- 23| AT RISK | Swag: 300 t-shirts | 2026-11-06 | 2 | FedEx | label created | needed in 2 day(s), status: label created |
- 24| ok | Booth backdrop | 2026-11-10 | 6 | UPS | in transit | |
- 26Every tracking number links to the carrier's tracking page. Claude then walks you through the at-risk ones, updates statuses as you report them, and suggests what to do (reroute, call, backup plan). Also writes `out/shipments.csv` for your spreadsheet. Try `examples/shipments.csv`.
- 28## What it can access
- 30- Reads and updates `data/shipments.csv` or `data/shipments.txt`.
- 31- Writes `out/shipments.md`, `out/shipments.csv`, and `out/shipments.json`.
- 32- Runs one script, `scripts/track.mjs` (Node, no dependencies). No network: it builds tracking links but never opens them.
- 34## Setup
- 36None. Needs Node 18 or newer.
