Browser fingerprinting and trust score analysis platform built on Cloudflare's full stack (Pages + Workers + D1 + R2)
New to this project? Start here:
- Install dependencies:
npm install - Configure environment: Environment files are already created (see below)
- Start development:
npm run dev - Open browser: http://localhost:3000
📖 Detailed instructions: Quick Start Guide
apps/web/ # Next.js 16 frontend (Cloudflare Pages)
workers/network-injector/ # Cloudflare Worker API
packages/types/ # Shared TypeScript types
docs/ # Documentation
Environment files have been created with default values:
- ✅
apps/web/.env.local- Frontend configuration - ✅
workers/network-injector/.dev.vars- Worker secrets
For local development, no changes needed! The app works with defaults.
Optional API keys (for enhanced features):
- IPInfo.io token (free 50k/month): https://ipinfo.io/signup
- Cloudflare Turnstile keys: https://dash.cloudflare.com/
See Quick Start Guide for setup.
npm run dev # Start frontend + worker (concurrent)
npm run build # Build all projects
npm run test # Run unit tests (71 tests)
npm run test:e2e # Run E2E tests
npm run typecheck # TypeScript validation| Document | Description |
|---|---|
| Quick Start | Get up and running in 5 minutes |
| Quick Deploy | ⚡ Deploy to Cloudflare in 10 minutes |
| Deployment Guide | Complete deployment and operations guide |
| Production Deployment | Detailed production setup |
| Deployment Summary | Configuration checklist |
| Project Completion Summary | Full project status and metrics |
| OG Image Guide | Social media preview image creation |
- 🔍 Browser Fingerprinting: Canvas, WebGL, audio context, fonts detection
- 🌐 Network Analysis: IP intelligence, TLS fingerprinting (JA3/JA4), ASN lookup
- 🔒 Leak Detection: WebRTC, DNS, IPv6 leak testing
- 📊 Trust Scoring: Deduction-based scoring system (0-100)
- 🤖 Bot Detection: Behavioral analysis, automation detection
- 📄 PDF Reports: Generate detailed analysis reports
- ✅ 71 unit tests (all passing)
- ✅ 15+ E2E scenarios (Playwright)
- ✅ WCAG AA compliant (accessibility)
Ready for production! This project uses GitHub Actions for automatic deployment to Cloudflare.
- Configure GitHub Secrets: See Quick Deploy Guide
- Push to main branch: Automatic deployment via GitHub Actions
- Done! Your app is live on Cloudflare
Manual deploy:
# Deploy worker
npm run deploy:worker
# Deploy pages
npm run deploy:pages📖 Complete guides:
- Quick Deploy Guide - Fast setup
- Full Deployment Guide - Detailed instructions
- Deployment Summary - Configuration checklist
- ✅ Security: XSS vulnerabilities fixed
- ✅ Features: All tools implemented
- ✅ Testing: Comprehensive coverage
- ✅ Accessibility: WCAG AA compliant
- ✅ Documentation: Complete guides
- ✅ Production Ready: Can deploy now
See PROJECT_COMPLETION_SUMMARY.md for details.
- Frontend: Next.js 16, React 19, TanStack Query, Framer Motion, Tailwind CSS
- Backend: Cloudflare Workers (Hono), D1 (SQLite), R2, KV
- Language: TypeScript (strict mode)
- Testing: Vitest, Playwright
- Deployment: Cloudflare Pages + Workers
[Add your license here]
Status: 🎉 Production Ready | Last Updated: 2025-01-15