# Routeflow - AI-powered flow mapping for modern applications

## About
Routeflow helps developers understand how their applications work by mapping frontend routes, backend APIs, SQL queries, and external dependencies into one clear flow visualization.

## Main Pages

### Homepage
URL: /
Description: Landing page introducing Routeflow's flow mapping capabilities, product features, pricing, and getting started guide.

### Product Features
URL: /#product
Description: Overview of Routeflow's key features including frontend-to-backend mapping, SQL query tracking, external dependency monitoring, and performance insights.

### How It Works
URL: /#how-it-works
Description: Step-by-step explanation of how to install Routeflow SDKs and start visualizing application flows.

### Pricing
URL: /#pricing
Description: Transparent pricing tiers - Free (up to 10K requests/month), Pro ($29/month, up to 500K requests), and Business ($99/month, unlimited requests).

### FAQ
URL: /#faq
Description: Frequently asked questions about Routeflow installation, data privacy, supported frameworks, and integration.

## Application Pages

### Dashboard
URL: /dashboard
Description: Main dashboard for managing Routeflow projects, viewing API keys, and accessing installation guides for frontend and backend SDKs.

### Flow Explorer
URL: /dashboard/flows/explorer
Description: Interactive flow visualization showing how frontend routes connect to backend endpoints, SQL queries, and external APIs with performance metrics.

### Session Traces
URL: /dashboard/session-traces
Description: Timeline view of user sessions showing frontend page views, backend requests, SQL queries, and external API calls in chronological order.

### SQL Analytics
URL: /dashboard/sql
Description: SQL query analytics dashboard showing query fingerprints, performance metrics (p50/p95/p99 latency), slow queries, and error rates by statement type.

## Authentication

### Login
URL: /login
Description: User authentication page for accessing Routeflow dashboard.

## Technology Stack
- Frontend: Next.js, React, TypeScript, Tailwind CSS
- Backend: Python, Flask, PostgreSQL
- SDKs: Browser SDK (JavaScript/TypeScript), Python SDK (Flask/FastAPI/Django)
- Deployment: Vercel (frontend), Python backend server

## Key Features
1. **Frontend Route Mapping**: Automatically track which frontend routes trigger which backend APIs
2. **SQL Query Analysis**: Capture and analyze SQL queries with duration, fingerprinting, and error tracking
3. **External Dependency Tracking**: Monitor calls to third-party APIs and services
4. **Performance Metrics**: p50/p95/p99 latency tracking, error rates, and slow query detection
5. **Session Tracing**: Follow complete user journeys across frontend and backend
6. **Impact Analysis**: Understand what depends on what before making changes

## Use Cases
- Understanding inherited codebases generated by AI
- Debugging production issues with session traces
- Identifying slow SQL queries and performance bottlenecks
- Mapping dependencies before refactoring
- Onboarding new developers to complex applications

## Supported Frameworks

### Frontend
- React, Vue, Angular, Svelte
- Next.js, Nuxt, SvelteKit
- Vanilla JavaScript

### Backend
- Python: Flask, FastAPI, Django
- SQL: PostgreSQL, MySQL, SQLite (via SQLAlchemy or asyncpg)

## Contact
Email: hello@routeflow.dev
Website: https://routeflow.dev

## Privacy & Data
- No sensitive data required for core functionality
- SQL parameters can be redacted for privacy
- Self-hosted option available for Enterprise
- SOC 2 compliant (Business tier)