Welcome to HostMetrics
HostMetrics (internally TuroDashboard) is a comprehensive fleet management and analytics platform for Turo hosts. It enables hosts to track vehicles, trips, earnings, expenses, investors/co-hosts, and generate profitability reports.Who This Documentation Is For
| Audience | Start Here |
|---|---|
| New Developer / Intern | Prerequisites → Local Setup → Architecture Overview |
| Product Owner | Features → Business Rules |
| Returning Developer | Hooks Reference → DB Operations |
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript 5 |
| Database | Supabase (PostgreSQL) |
| Auth | Supabase Auth (JWT) |
| Styling | Tailwind CSS 4 |
| UI Components | shadcn/ui (Radix UI) |
| Charts | Recharts |
| PDF Generation | jsPDF |
| Payments | Stripe |
| Testing | Vitest + Playwright |
| Deployment | Vercel |
| Background Jobs | AWS Lambda (toll scraping) |
Core Features
Dashboard & KPIs
Financial metrics, trip analytics, revenue breakdowns, fleet health, and monthly trends
Trip Management
Import Turo CSVs, filter by status, view earnings breakdowns per trip
Vehicle Fleet
Add vehicles, manage photos, track status, per-vehicle profitability
Investor Management
Revenue sharing, vehicle assignments, payment tracking, agreements, 1099 generation
Toll Reconciliation
Connect toll accounts (NTTA, EZPass, SunPass), match tolls to trips, track costs
Expense Tracking
Per-vehicle and global expenses, splitting, categories, recurring support
Reports & Analytics
Monthly earnings, vehicle profitability, discrepancy detection, toll analysis
Fleet Showcase
Public fleet pages with customizable templates for marketing your fleet
Project Stats
| Metric | Count |
|---|---|
| Page Routes | 28 |
| React Components | 200+ |
| Custom Hooks | 28 |
| Database Tables | 25+ |
| API Routes | 16 |
| Test Files | 60+ |
| Supabase Migrations | 24+ |
Documentation Structure
- Getting Started — Environment setup, dependencies, first run
- Architecture — System diagrams, database schema, data flows, API routes
- Features — What each feature does and how it works (for all audiences)
- Business Rules — Revenue formulas, payment calculations, timezone rules
- Development Guide — Code patterns, design system, testing, PR process
- Data Reference — CSV field specifications with downloadable sample files