TrackFlow is an open-source, privacy-first, edge-native web analytics platform available at trackflow.saifulalom.com. Rebuilt as a unified, high-performance architecture on top of Astro and Astro API Routes, TrackFlow records visits, unique users, traffic sources, and conversions via a lightweight script without tracking cookies or heavy client-side overhead.
| Platform | Role | Live Demo | Source Code |
|---|---|---|---|
| Landing page | Application Hub | Visit Site | GitHub |
We care deeply about user experience, speed, and accessibility. TrackFlow is fully optimized to achieve perfect scores across all core web metrics:
| Metric | Score | Status |
|---|---|---|
| 🚀 Performance | 100/100 | ✅ Passed |
| ♿ Accessibility | 100/100 | ✅ Passed |
| 🛡️ Best Practices | 100/100 | ✅ Passed |
| 🔍 SEO | 100/100 | ✅ Passed |
Below is our latest desktop core vitals audit showing a clean sweep:
Audit captured on June 4, 2026 via Google Lighthouse.
TrackFlow is built using an Edge-Native Minimalist Architecture designed for 100/100 Lighthouse performance scores and sub-millisecond edge processing:
- Framework: Astro (Unified SSR Frontends & Type-Safe API Routes)
- Frontend Components: React, Tailwind CSS, Lucide Icons
- Schema Validation: Zod
- Database Engine: Cloudflare D1 (Distributed SQLite at the Edge)
- Object-Relational Mapping: Drizzle ORM (Schema-First Type Pipelines)
- Testing Runner: Vitest (In-Memory
better-sqlite3andjsdomruntimes)
The TrackFlow dashboard gives developers and digital businesses a scannable overview of their traffic metrics without bloating client tracking payloads.
- Total Traffic: Aggregated session network volumes.
- Bounce Rate: Single-page bounces without interactions.
- Avg. Session Duration: High-accuracy real-time reading duration metrics.
- Conversion Rate: Goal completions tracked via micro-event pixels.
The layout decomposes into modular, decoupled component lanes:
<DashboardStatsGrid />— Higher metric summary layout rows.<TrafficTrendsChart />— Visualizes Network Hit Volumes with smart timeline aggregation.<DevicesCard />— High-accuracy browser, engine, and platform footprints.<DashboardReferrerList />— Clean referrer origin domain stripping.<PageviewsCard />— Top performing URL node lists.<TrafficMap />— Global geographic distribution mappings.
src/
├── components/ # React components (Charts, Cards, Maps, UI)
├── db/ # Drizzle ORM schema definitions and migrations
│ ├── schema/ # Table definitions and TypeScript relationships
│ └── migrations/ # D1 SQL migration scripts
├── lib/ # Core system configurations and DB client initialization
├── modules/ # Domain-driven feature sets
│ └── dashboard/ # Dashboard module (Components, libs, actions, hooks)
│ └── __tests__/ # Complete Vitest Unit & Integration suite
└── pages/ # SSR pages and Astro API routes (pixel ingestion)
public/
└── pixel.js # High-performance tracking script snippet
- Node.js 18+
- pnpm (Workspace runner)
- Wrangler CLI (Authenticated to your Cloudflare ecosystem)
git clone [https://github.com/saifulalomdev/track-flow.git](https://github.com/saifulalomdev/track-flow.git)
cd track-flow
pnpm install
Generate your SQL migration assets and execute them against your local sandbox instance:
pnpm run db:generate
pnpm run db:migrate
Boot your local dev environment:
pnpm dev
TrackFlow features 100% code coverage across core utilities and UI logic using Vitest.
# Execute the full test runner suite (Utils, DOM Cards, Path Resolvers)
pnpm test
# Run tests in continuous file watch mode during active development
pnpm test:watch
TrackFlow runs completely within Cloudflare's edge runtime environment. To provision your database properties and compile your Astro build targets:
# 1. Generate local Cloudflare type-safety files
pnpm cf-types
# 2. Apply your schema migrations directly to your production Cloudflare D1 Database
pnpm db:migrate
# 3. Build the Astro optimization bundle
pnpm build
- Crash-Only Software: Designed around type-safe data pipelines where corrupt inputs or failing network dependencies fail early and cleanly without side effects.
- Privacy-First Tracking: Bypasses cookie banners completely by performing host-stripping calculations at the edge without recording Personally Identifiable Information (PII).
- Zero Overhead Monoliths: Rebuilding from independent edge microservices to a single unified Astro project improved developer velocity while keeping Cold Starts near 0ms.
Built by Saiful Alom — Edge Architecture & Distributed Systems Specialist.
- GitHub: @saifulalomdev
- Portfolio: saifulalom.com
- TrackFlow Hub: trackflow.saifulalom.com