Sources and Methodology

This site is designed to be transparent. Every model row in data/models.csv includes source URLs. The build publishes the normalized dataset at /data/models.json and rankings at /data/rankings.json. Brand sales are published at /data/brands.json.

Field definitions

Range: rated range in miles (EPA/WLTP/Manufacturer, as labeled).
Efficiency: Wh/mi where available; derived mi/kWh is shown for convenience.
DC max (kW): peak advertised DC fast charging power (not the full curve).
10–80%: minutes from 10% to 80% on DC fast charging when available.
Best Value ranking: MSRP divided by rated range ($/mi). Lower is better.

Mix-sourcing rules (recommended)

Range & efficiency: prefer EPA / fueleconomy.gov; otherwise use a clearly labeled manufacturer rating.
MSRP: prefer manufacturer “Build & Price” or press releases; third-party pricing only if it’s clearly dated and sourced.
Charging (10–80%, curve, peak kW): prefer instrumented third-party tests; if using manufacturer values, label them and keep a single charging source URL.
Everything set must have a field source: if you fill msrp_usd, you must fill msrp_source_url (same idea for range and charging).

How updates work

Edits happen in the repo (CSV + guide content) and go live after a static rebuild and deploy. No runtime database is used in this MVP.