__                 __                          
                                    /\ \__           __/\ \__                       
  ___     ___   __  __     __    ___\ \ ,_\    __   /\_\ \ ,_\  _ __    __    ____  
/' _ `\  / __`\/\ \/\ \  /'__`\/' _ `\ \ \/  /'__`\ \/\ \ \ \/ /\`'__\/'__`\ /',__\ 
/\ \/\ \/\ \L\ \ \ \_/ |/\  __//\ \/\ \ \ \_/\ \L\.\_\ \ \ \ \_\ \ \//\  __//\__, `\
\ \_\ \_\ \____/\ \___/ \ \____\ \_\ \_\ \__\ \__/.\_\\ \_\ \__\\ \_\\ \____\/\____/
 \/_/\/_/\/___/  \/__/   \/____/\/_/\/_/\/__/\/__/\/_/ \/_/\/__/ \/_/ \/____/\/___/ 
                                                                                    
> web and pwa built to compare listed fuel prices and find the most convenient station tailored to your needs. it estimates **true refill cost** using price at the pump, your location, and how much gas will the trip require. it DOES NOT only look for the cheapest station.

UI is built in spanish. when guiding users, map UI strings to actions (examples below). Prices and budgets use **CLP**; distances use **km**.

## How to use the app (for humans and agents)

1. **Location is required** for search. The app estimates it from request headers. The home form does not ask for browser geolocation.
2. **Choose `fuel type`:** gasolina 93 / 95 / 97, diesel, or kerosene. Pick the grade the car actually uses.
3. **Optional — open `más opciones`:** expands advanced fields (still worth setting for meaningful ranking):
   - **`máximo de viaje (minutos)`** — max one-way travel time you’re willing to consider (the server uses this to cap distance).
   - **`¿con cuánta plata quieres llenar?`** — refill **budget in CLP** (used to model liters purchased and **round-trip** fuel cost to the station).
   - **`rendimiento mixto (km/L)`** — mixed **fuel economy in km per liter** (used to translate distance into extra fuel used before/after the refill).
4. **Run the search** with **`ver mejores opciones`**. A short “searching” state may appear; results replace or update below the form.
5. **Read the result cards:** each shows distributor **brand**, **price per unit (CLP)** for the selected fuel, **estimated drive time** (range, minutes), **distance (km)**, and **last price update** date.
6. **Open `cómo llegar a …`** on a card to see the **address** and **outbound map links** (e.g. Google Maps, Apple Maps, Waze) in a new tab.
7. **PWA / offline:** the site can be installed; if the user is offline, content that needs network (including search) is limited—direct them to reconnect for a new search.

**Ranking (today):** the client uses a **net value** style ranking by default: it accounts for **posted price** and **driving cost** to complete the refill within the constraints. There is no separate “ranking mode” control exposed in the home UI.

**Vehicle row:** a **vehicle** field may appear on the form; if there are no concrete presets to choose, rely on **km/L** and **fuel type** in the form to represent the car.

## Main pages

- [Home / search](https://www.noventaitres.cl/): main station search and results
- [How it works](https://www.noventaitres.cl/como-funciona): product explanation (content may be minimal)
- [Station prices by commune](https://www.noventaitres.cl/estaciones): index of station price pages grouped by region and commune
- `https://www.noventaitres.cl/estaciones/{region}`: region page listing communes with active station prices
- `https://www.noventaitres.cl/estaciones/{region}/{commune}`: commune page with active stations and latest liter prices by fuel

## Data and scope

- Station and **price** information is aligned with **official / regulatory sources** for Chile (e.g. CNE-related data) where applicable; the product is a **comparator**, not a fuel brand.
- This file does **not** grant API access. `/api/*` is for the application, not a public partner API.

## Optional

- [Sitemap (XML)](https://www.noventaitres.cl/sitemap.xml): indexable URL list
- [robots.txt](https://www.noventaitres.cl/robots.txt): crawler rules