01 — The Problem
Planning international hardware or inventory purchases using only base USD sticker prices leads to cash shortfalls by overlooking per-pound courier freight, membership discounts, and customs tax jumps above the US$200 FOB threshold.
02 — Architecture & Flow
Dockerized TypeScript full-stack service backed by interchangeable persistence (zero-setup SQLite by default or MariaDB 11 via Compose override) paired with a streamlined single-screen interface.
Computes discounted courier freight by weight plus customs duties whenever FOB exceeds US$200.
Moving an item to IN_TRANSIT deducts item cost and locks estimated freight + taxes.
Allocates free liquidity down the priority queue and flags affordable lower-queue items.
Marking Picked Up records actual courier payment and settles remaining liquidity.
03 — Technical Solution
Built a waterfall funding engine that locks committed freight and tax reserves for in-transit shipments, allocates remaining free liquidity strictly down the priority queue, and reconciles real courier receipts via a two-step state flow (WISHLIST → IN_TRANSIT → PICKED_UP).
04 — Production Results
- Instant visibility into true landed cost before committing cash to any purchase.
- Clean reconciliation between estimated transit reserves and actual courier invoices upon pickup.
- Portable self-hosted deployment with persistent Docker volumes and health-checked API endpoints.
Single-Screen Financial Clarity
Zero accounting bloat, maximum decision speed
BudgetTracker strips away multi-page dashboards to answer one practical question: what can be ordered today without starving incoming shipments at pickup?
- Committed vs. free liquidity: Items marked
IN_TRANSITisolate their estimated shipping and customs obligations immediately so available cash is never double-counted. - Out-of-order affordability hints: While preserving strict top-priority funding, the waterfall highlights lower-priority items that fit comfortably inside remaining free balance.
- Drop-in persistence: Starts in seconds on local SQLite or swaps cleanly to MariaDB via Docker Compose overlays and automated healthchecks.
Interactive engineering demo
LIVE INTERACTIVE DEMO // REACT ISLAND
Test the engineering logic live
Simulate available liquidity and the customs tax threshold jump above US$200 FOB (with a 20% courier freight discount).
Courier freight (-20% disc.)
$20.16
Customs duty & tax
$60.20
Taxed above US$200 FOB
Total Landed Cost
$295.36
Remaining free liquidity
$154.64
Affordable with current balance