Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

256 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Plein. logo

Plein.

A full tank at the right price — find the cheapest fuel stations around you and along your routes, in France, Spain, Andorra and Portugal.

English · Français · Español · Català · Português

Open the app

MIT license PWA Data React 18 TypeScript Leaflet


Prices around you A station's page Along your route
Price map around Toulouse A station's page: price per fuel, gap to the cheapest, services and savings on a full tank Station comparison on a Toulouse → Lille route

✨ Features

  • 🗺️ Live price map — stations around you, price pins colored by price: good deals in green, the priciest in orange.
  • 🇫🇷🇪🇸🇦🇩🇵🇹 Four countries on one map — the official feeds of France, Spain, Andorra and Portugal combined; border fill-ups compare at a glance.
  • 📋 Real best choice — the fuel burned for the detour is counted, so a closer station can beat the cheapest one.
  • 🛣️ Route fuel plan — where to stop along your trip, how many liters at each stop and at what cost, under 3 strategies.
  • Favorites — your stations and their day's price, across areas and countries.
  • All fuels — Diesel, SP95/98, E10, E85, LPG; filters by radius, brands, services and AdBlue.
  • 🕐 Real opening hours — "Open 24/7", "Closed · opens at 6:30 am" — with price freshness flagged.
  • 🏷️ Recognized brands — station names and logos from the official feeds and OpenStreetMap.
  • 🧭 Directions — opens the station in your GPS app.
  • 🔗 Shareable links — the URL follows the map and the route; a link reopens the same view.
  • 🌗 Light and dark themes — follows your browser, switchable in Settings.
  • 🌍 Five languages — French, English, Spanish, Catalan and Portuguese.
  • 🖥️ Phone and desktop — full-screen map and sheet on mobile, side panels on a wide screen.
  • 📱 Installable PWA — the last areas and tiles work offline.

🚀 Usage

  1. Open plein.zadkiel.fr (the official deployment).
  2. Allow geolocation — or continue without it, and search for a city in France, Spain, Andorra or Portugal. The search remembers the places you picked there: it offers them as soon as it opens and ranks them at the top of the suggestions as soon as you type.
  3. Pick your fuel at the top of the map: the best choice (price AND distance, detour counted) shows up in the bottom sheet, Directions starts the guidance.
  4. Before a long trip, open the Route tab: enter the destination and compare the stations along the way. The departure starts on My position as soon as location has given one, and either endpoint's search offers it as a row — one end at a time.
  5. On mobile, install the app (install banner or Settings → Application) to get it as an icon, full screen and offline.

No account, no tracker: your favorites and settings stay in your browser.

📊 Data sources

Each covered country has its own official feeds — prices and geocoding — which the app picks according to the visible area (Automatic source). The rest (routing, basemaps) is shared by all four.

🇫🇷 France

Data Source License
Fuel prices & opening hours Prix des carburants — real-time feed (data.economie.gouv.fr) Licence Ouverte / Open Licence
Station brands OpenStreetMap (generated static index, matched to stations by proximity) ODbL
Geocoding & autocompletion Base Adresse Nationale (api-adresse.data.gouv.fr) Licence Ouverte / Open Licence

🇪🇸 Spain

Data Source License
Fuel prices, hours & brands Precios de carburantes (sedeaplicaciones.minetur.gob.es, MITECO) — the brand (rótulo) is carried by the feed Datos abiertos
Geocoding & autocompletion CartoCiudad (IGN) CC BY 4.0

🇦🇩 Andorra

Data Source License
Fuel prices & brands Preus dels carburants (sig.govern.ad, Govern d'Andorra — Oficina de l'Energia i del Canvi Climàtic) — the brand is derived from the station name; the feed carries neither address nor opening hours © Govern d'Andorra
Geocoding & autocompletion Nomenclàtor (official gazetteer) & LocatorIDE (sig.govern.ad, IDE Andorra) © Govern d'Andorra

🇵🇹 Portugal

Data Source License
Fuel prices & brands Preços dos combustíveis (DGEG — Direção-Geral de Energia e Geologia) — the brand (marca) is carried by the feed, which gives neither opening hours nor E10; mainland coverage (the Azores and Madeira have their own regime) Dados abertos
Geocoding & autocompletion Photon (public Komoot instance, OpenStreetMap index), bounded to mainland Portugal — the country publishes no keyless address geocoder ODbL

Shared by all four countries

Data Source License
Routing OSRM (demo server) · Valhalla (public FOSSGIS server) for "avoid motorways / tolls" © OpenStreetMap contributors
Basemaps CARTO light / dark following the theme (OpenStreetMap tiles as offline-friendly fallback) © OpenStreetMap contributors

The app has no backend: the browser queries these public services directly. Sources are pluggable (src/data/types.ts). Offline or when a feed is down, the app keeps the last loaded stations (per-area cache) with an explicit banner and retries as soon as the connection returns.

🛠️ Built with

Vite · React 18 · strict TypeScript · Leaflet, no other runtime dependency. The production build is static assets, served by a Cloudflare Worker.

🤝 Contributing

Bug reports, translations and pull requests are welcome — CONTRIBUTING.md covers the setup, the commands, the house rules and the tests. When reporting a bug, paste the debug snapshot: Settings › Offline data › Debug overlay, then the floating DBG chip → Report, which copies it and opens the form.

📄 License

Code under the MIT license © Zadkiel Aharonian. The displayed data remains subject to the licenses of its respective producers (Licence Ouverte for French public data, MITECO datos abiertos for Spanish prices, © Govern d'Andorra for Andorra, DGEG dados abertos for Portuguese prices, ODbL for OpenStreetMap). The Archivo and Spline Sans Mono fonts, embedded in public/fonts/, are under the SIL Open Font License 1.1 (see the *-OFL.txt files in the same folder).

About

A full tank at the right price — PWA that finds the cheapest fuel stations around you and along your routes (France · Spain · Andorra · Portugal)

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages