USPS Tracking v3 API Integration
Production
Configure your USPS Tracking v3 REST API endpoint and OAuth2 credentials. For server-wide automatic authentication, set USPS_CLIENT_ID, USPS_CLIENT_SECRET, and USPS_BASE_URL in your Vercel Environment Variables.
FedEx Tracking API Integration
Sandbox
Configure your FedEx Track v1 REST API endpoint and credentials. Once Sandbox validation (VIRTUAL.RESPONSE) is complete, switch the endpoint below to Production.
Pro Entitlement & Allowlist Diagnostics
Checking...
Test `/api/verify-pro` endpoint or toggle local Pro mode for testing Free-tier vs. Pro-tier UI behavior.
Contact Us Relay & SMTP Diagnostics
POST /api/contact
For 100% server-side email delivery (zero client-side requests), set GMAIL_APP_PASSWORD (your 16-character Google App Password) or WEB3FORMS_ACCESS_KEY in your Vercel Environment Variables.
QTrack Release History & Update Summary
v1.0 → v40.6
Complete chronological changelog of every QTrack architecture, UI, API, and monetization update.
Strict Carrier Regex Validation (No Catchall), Updated Name Placeholder & Source/Destination Geography Reporting
- Updated the Shipment Name input placeholder to "Enter a shipment name".
- Enforced strict carrier regex matching on tracking numbers:
#trackInputonly turns green and allows submission when the tracking number matches a supported carrier regex (no unmatched catchall tracking numbers allowed). - Added Source (Origin) & Destination City, State, Country extraction to
api/fedex-track.jsandapi/usps-track.js, and added a new Source & Destination Geography analytics card, Audit Log column, and CSV export columns toreports.html.
Active-Focus Emerald Input Outlines, Updated Tracking Placeholder & Clean Submit Button
- Removed the leading
+icon from the "Track this shipment" button for a cleaner button layout. - Added
outline-none focus:outline-noneand non-empty emerald border/ring rules to both#trackInputand#labelInputso their outlines immediately turn and stay green whenever not empty—even while actively selected/focused. - Updated the tracking code input placeholder to "Paste or type a valid tracking number".
Live USPS Tracking v3 REST API Integration (/api/usps-track) & Admin Diagnostic Panel
- Added Vercel serverless proxy
api/usps-track.jssupporting USPS OAuth2 v3 token caching (/oauth2/v3/tokenviaUSPS_CLIENT_ID&USPS_CLIENT_SECRET) and live USPS Tracking v3 (/tracking/v3/tracking/{trackingNumber}?expand=DETAIL) telemetry extraction. - Wired live USPS shipment telemetry cards into
index.html(displaying Ship Date, Mail Class, Expected Delivery Date, Latest Scan Location, and Delivery SLA Score) plus an interactive USPS API test panel inadmin.html.
Elevated Single-Row Glassmorphic Header & Unified Settings Hub (Cloud Sync + About/Contact)
- Redesigned the top navigation bar across all pages into a modern, elevated single-row glassmorphic header card with zero subtitle clutter, zero version badges, and zero title/icon overlap.
- Consolidated Google Drive Cloud Sync (including full OAuth2 sign-in, silent background token renewal, and inline Show/Hide email toggle) and About QTrack & Contact Support directly into
settings.htmlas reorderable accordion sections, with the live green#cloudIndicatorstatus dot displayed on the Settings gear icon.
Lowered Header Action Icons Below Title Row & Removed Version from Heading Area
- Lowered the navigation icon row onto the second header tier (below the logo, page title, and
PRObadge) across all 6 pages so longer headings like "Delivery Analytics" have 100% of the top row width and never collide or overlap with the action icons. - Confirmed removal of all version number pills from the top heading area across all pages (version remains in the footer and Settings → About QTrack).
Removed Version Badge from Page Headings & Inline Show/Hide Toggle on Connected Account Line
- Removed the version badge pill from all 6 page headers (
index.html,reports.html,about.html,settings.html,cloud.html, andadmin.html) for a cleaner, single-row title +PRObadge layout that never wraps or overlaps the navigation icons. - Placed the Show / Hide toggle button directly inside the full-width Connected Account row on
cloud.html, defaulting to hidden (••••••••••••••••) on page load while displaying the full non-truncated email address (wrapping cleanly if very long) when revealed.
Full-Width Wrapping Connected Account Line, Unified Header Icon Row Alignment & "Connected" Sync Status
- Placed the Connected Account email in
cloud.htmlon its own dedicated full-width line (break-all whitespace-normal) with no truncation so even very long email addresses display completely and wrap cleanly. - Unified the header title + badge stack (
PRO+v39.9) acrossindex.html,settings.html, andcloud.htmlto matchreports.html,about.html, andadmin.htmlso the icon row sits at the exact same height and never overlaps the title. - Updated Cloud Sync status on
cloud.htmlto display "Connected" (instead of getting stuck on "Reconnecting..." when opening the page with a saved Google account).
Full-Width Single-Line Header Subtitles Under Title & Icons + Condensed Section Subtitles
- Restructured all 6 page headers so the top row houses the logo, title, badges, and navigation icons, while the subtitle runs full-width underneath both the title and icons on a single non-wrapping line.
- Condensed header and section subtitles across
index.html,reports.html,about.html,settings.html,cloud.html, andadmin.htmlso they never wrap onto multiple lines.
Instant Header Rendering, Persistent Green Cloud Dot, Non-Truncated Headings & Admin Update Log
- Fixed Cloud Status indicator turning yellow after a few seconds by testing the existing Google Drive token against Drive first instead of preemptively clearing it when
quicktrack_gdrive_token_tswas unset. - Removed
truncatefrom all page header titles and subtitles so headings never clip with ellipses. - Added a synchronous inline script immediately after
</header>on all pages so the Delivery Reports icon, Admin icon, Cloud dot, and Pro badge render in 0ms on first paint without waiting for async network calls. - Added this comprehensive searchable Release History & Update Summary section to the Admin Console.
QTrack Rebrand, Settings Pro/Admin Header Fix & Action Button Labels
- Rebranded display titles, headers, modals, and legal docs across all pages to QTrack while preserving internal storage keys.
- Fixed a syntax error in
settings.htmlthat prevented Pro status, Trashcan, and header icons (Reports & Admin) from initializing. - Updated primary submit button to "Track this shipment" and active shipment completion button to "✓ Mark Delivered".
Removed Redundant Home Button & Added Cloud Account Show/Hide Toggle
- Removed redundant house/home icon button from all page headers (the QTrack logo serves as the home link everywhere).
- Added a Show / Hide toggle button next to Connected Account in
cloud.html, defaulting to masked (••••••••••••••••) on load.
Native TLS Gmail SMTP Client in /api/contact & Browser-Origin Fallback
- Added zero-dependency native TLS Gmail SMTP client (
smtp.gmail.com:465viaGMAIL_APP_PASSWORD) toapi/contact.jsto bypass Cloudflare datacenter IP blocks. - Added runtime XOR-decoded browser fallback in
about.htmlso Contact Us submissions succeed with zero plain-text email exposure in source code. - Added live Contact Us Relay & SMTP diagnostic tester to
admin.html.
Dedicated About Us & Contact Page (about.html) & Server-Side Contact Endpoint
- Created
about.htmlfeaturing QTrack's mission, 4-pillar local-first architecture overview, and interactive Contact Us form. - Created
api/contact.jswith rate-limiting and honeypot bot protection so owner email is never exposed on the site.
Zero-Popup Silent Google OAuth2 Renewal & AdSense Domain Guard
- Implemented hidden-iframe OAuth2 token renewal (
prompt=none+login_hint) so Google Drive stays connected without annoying popups. - Updated
shouldServeFreeTierAds()to suppress AdSense initialization on unapproved.vercel.app/localhostdomains and for Pro users, eliminating console403errors.
Restricted Admin Console (admin.html), Pro-Gated Analytics & YunExpress Removal
- Created
admin.htmlrestricted exclusively toscottharvey035@gmail.comand moved FedEx API configuration and system diagnostics there. - Gated Delivery Reports & Analytics (
reports.html) and Trashcan recovery exclusively for QTrack Pro users. - Removed legacy YunExpress carrier code and added automatic migration of any legacy records to
17Track / Other.
AdSense Publisher Content Compliance, ads.txt & 8-Tier Typography Scaling
- Added rich crawlable publisher guides (
#publisherContentSection) and rootads.txt/robots.txtto satisfy Google AdSense content policies. - Expanded Display & Text Size settings to 8 granular scaling tiers from Micro (82%) to Max (135%).
Live FedEx Track v1 REST API Integration (/api/fedex-track) & Delivery SLA Grading
- Built Vercel serverless proxy
api/fedex-track.jswith OAuth2 token caching, SandboxVIRTUAL.RESPONSEverification, and live telemetry extraction (Ship Date, Service Type, Expected Delivery Date). - Added Expected vs. Actual Delivery SLA scoring (Early, On-Time, Late, Overdue) and Shipping Service Type breakdown charts to
reports.html.
Executive Delivery Analytics Suite (reports.html) & Google Play Billing Pro Tier
- Built
reports.htmlwith 3-tier scope switching (Active, Active + Delivered, All-Time), SVG Donut charts, Transit Speed histograms, Day-of-Week activity graphs, and RFC-4180 CSV export. - Added
api/verify-pro.jssupporting Google Play Digital Goods API purchase verification, HMAC-SHA256 JWT entitlement tokens, and Google account allowlist verification.
Multi-Page PWA Architecture, Carrier Auto-Detection, Trashcan Recovery & Google Drive Sync
- Engineered client-side regex detection for USPS, UPS, FedEx, DHL Express, Amazon Logistics, and OnTrac, plus MLA title-casing for shipment nicknames.
- Built multi-page PWA bundle (
index.html,settings.html,cloud.html,service-worker.js,manifest.json) with Dark/Light themes, configurable Trashcan retention, and isolated Google DriveappDataFoldersynchronization.