QTrack

Admin Console

ADMIN
Authenticated Admin Session: scottharvey035@gmail.com
Hidden from Free & Pro users
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.

USPS Live / TEM Validation Test POST /api/usps-track
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.

Sandbox / Live Validation Test POST /api/fedex-track
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.

v40.6 — Latest Release CURRENT

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: #trackInput only 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.js and api/usps-track.js, and added a new Source & Destination Geography analytics card, Audit Log column, and CSV export columns to reports.html.
v40.6 Emerald Focus Outlines

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-none and non-empty emerald border/ring rules to both #trackInput and #labelInput so 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".
v40.4 USPS Tracking v3 API

Live USPS Tracking v3 REST API Integration (/api/usps-track) & Admin Diagnostic Panel

  • Added Vercel serverless proxy api/usps-track.js supporting USPS OAuth2 v3 token caching (/oauth2/v3/token via USPS_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 in admin.html.
v40.6 Elevated Header & Unified Settings

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.html as reorderable accordion sections, with the live green #cloudIndicator status dot displayed on the Settings gear icon.
v40.1 Header Tier Update

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 PRO badge) 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).
v40.0 Show/Hide Cloud Account

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, and admin.html) for a cleaner, single-row title + PRO badge 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.
v39.9 Connected Status & Wrapping

Full-Width Wrapping Connected Account Line, Unified Header Icon Row Alignment & "Connected" Sync Status

  • Placed the Connected Account email in cloud.html on 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) across index.html, settings.html, and cloud.html to match reports.html, about.html, and admin.html so the icon row sits at the exact same height and never overlaps the title.
  • Updated Cloud Sync status on cloud.html to display "Connected" (instead of getting stuck on "Reconnecting..." when opening the page with a saved Google account).
v39.8 Single-Line Subtitles

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, and admin.html so they never wrap onto multiple lines.
v39.7 Instant Header & Cloud Dot Fix

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_ts was unset.
  • Removed truncate from 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.
v39.6 Rebrand & Settings Fix

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.html that 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".
v39.5 Navigation & Privacy Polish

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.
v39.4 Direct SMTP & Contact Relay

Native TLS Gmail SMTP Client in /api/contact & Browser-Origin Fallback

  • Added zero-dependency native TLS Gmail SMTP client (smtp.gmail.com:465 via GMAIL_APP_PASSWORD) to api/contact.js to bypass Cloudflare datacenter IP blocks.
  • Added runtime XOR-decoded browser fallback in about.html so Contact Us submissions succeed with zero plain-text email exposure in source code.
  • Added live Contact Us Relay & SMTP diagnostic tester to admin.html.
v39.2 – v39.3 About & Contact Page

Dedicated About Us & Contact Page (about.html) & Server-Side Contact Endpoint

  • Created about.html featuring QTrack's mission, 4-pillar local-first architecture overview, and interactive Contact Us form.
  • Created api/contact.js with rate-limiting and honeypot bot protection so owner email is never exposed on the site.
v39.2 – v39.3 Silent OAuth & AdSense Guard

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 / localhost domains and for Pro users, eliminating console 403 errors.
v39.2 – v39.3 Admin Console & Carrier Cleanup

Restricted Admin Console (admin.html), Pro-Gated Analytics & YunExpress Removal

  • Created admin.html restricted exclusively to scottharvey035@gmail.com and 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.
v39.2 – v39.3 AdSense Publisher Content & Scaling

AdSense Publisher Content Compliance, ads.txt & 8-Tier Typography Scaling

  • Added rich crawlable publisher guides (#publisherContentSection) and root ads.txt / robots.txt to satisfy Google AdSense content policies.
  • Expanded Display & Text Size settings to 8 granular scaling tiers from Micro (82%) to Max (135%).
v39.2 – v39.3 FedEx Track v1 API & SLA Scoring

Live FedEx Track v1 REST API Integration (/api/fedex-track) & Delivery SLA Grading

  • Built Vercel serverless proxy api/fedex-track.js with OAuth2 token caching, Sandbox VIRTUAL.RESPONSE verification, 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.
v30.0 – v35.9 Executive Reports & Play Billing

Executive Delivery Analytics Suite (reports.html) & Google Play Billing Pro Tier

  • Built reports.html with 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.js supporting Google Play Digital Goods API purchase verification, HMAC-SHA256 JWT entitlement tokens, and Google account allowlist verification.
v1.0 – v29.9 Core Foundation

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 Drive appDataFolder synchronization.