VoltFlow

VoltFlow is a mobile-first PWA for EV charging, vehicle telemetry, trip history, and maintenance records. It is built with Next.js, React, and Supabase.

Documentation

• Architecture
• Russian architecture reference
• Current product status
• Charging sessions
• Trips
• Web interface formulas
• Knowledge search
• Database schema
• Telemetry storage
• VoltFlow Mate API
• Premium and retention
• Telegram live widget
• Installation guide (Russian)

Features

• Charging sessions with SOC, energy, tariff-aware estimates, and history.
• Manual recovery of missed charging sessions from provider receipt data.
• Live vehicle telemetry, trip history, route tracks, and analytics.
• Expiring visible-view fast status for compatible VoltFlow Mate clients without adding dense history rows.
• Vehicle energy analytics with trip efficiency, parked-vehicle consumption context, and cell-balance trends.
• Offline-capable PWA with responsive mobile navigation.
• Per-user access control through Supabase Auth and Row Level Security.
• Optional VoltFlow Mate integration for vehicle telemetry and remote commands.
• Administration dashboard with user lifecycle metrics and an account attention queue.
• Knowledge-base content, maintenance records, and notifications.

Development

Requirements: Node.js 22+ and npm.

npm install
cp .env.example .env.local
npm run dev

Open the local development URL printed by Next.js. Use placeholder values in .env.local; never commit credentials or environment-specific settings.

Useful commands:

npm run lint
npm run test
npm run build
npm run search:eval
npm run db:migrations:status

The charging auto-session suite is intentionally outside the default test glob; use the focused command documented in AGENTS.md. Local migrations are applied one at a time. Self-hosted production uses the private psql procedure in docs/OPS_LOCAL.md, not the Supabase CLI pooler path.

Security

Keep service credentials server-side. Client access uses the public project key and is restricted by Row Level Security. Do not commit credentials, personal telemetry, or environment-specific operational data.

License

MIT License. See LICENSE.