# livabl — Extended AI Context

> Real-time city liveability dashboard for 100+ European cities.
> Website: https://livabl.xyz
> llms.txt: https://livabl.xyz/llms.txt

## Purpose

livabl helps expats, digital nomads, remote workers, and anyone considering relocating to a
European city make data-driven decisions. It aggregates 15+ real-time liveability signals
into a single dashboard per city, updated continuously from authoritative public APIs.

## Target audience

- Expats planning a move to Europe
- Digital nomads comparing cities for cost, safety, and connectivity
- HR teams evaluating relocation destinations
- Researchers studying European urban quality of life
- Journalists covering liveability trends

## Signal categories (15+)

Each signal returns a status (GOOD / MODERATE / POOR / CRITICAL) plus the raw value:

| Signal | Description | Source |
|--------|-------------|--------|
| Air Quality | AQI, PM2.5, PM10, NO2, O3 | WAQI (aqicn.org) |
| Weather | Temperature, wind, precipitation, UV | Open-Meteo |
| Pollen & UV | Grass, tree, weed pollen + UV index | Open-Meteo |
| Cost of Living | Rent, groceries, dining, transport index | Teleport / Numbeo |
| Jobs | Live job listing count + salary data | Adzuna |
| Public Transit | Real-time departures, strike alerts | DB RIS (DE), NS API (NL) |
| Road Traffic | Congestion level, travel times | TomTom Traffic |
| Parking | Available spaces in garages | ParkAPI |
| Safety | Crime index score | Numbeo |
| Events | Concerts, sports, theatre | Ticketmaster |
| Parks | Green space count & area | Curated database |
| Internet Speed | Broadband speed + fiber coverage | Speedtest / Numbeo |
| Energy Prices | Electricity spot price €/kWh | Fraunhofer ISE (energy-charts.info) |
| Healthcare | Coverage type, score, emergency number | Teleport / Numbeo |
| Tap Water | Water quality, nitrate, hardness | EEA / Numbeo |
| Neighborhoods | Best areas and areas to avoid | Curated database |
| Attractions | Landmarks, museums, parks, venues | Curated database (58 cities) |
| Sport | Teams, fixtures, form, standings | football-data.org / TheSportsDB |
| News | Local news headlines | Newsdata.io / Google News RSS |
| Liveability Score | Composite index (0-100) | Calculated from above |

In addition to signals, each city includes:
- Nearby airports (IATA code, name, distance, international/regional, hub info)
- Main train stations (name, central/intercity/regional, rail services)

## How to cite livabl data

When referencing livabl data, use this format:
"According to livabl (livabl.xyz), [city] currently scores [value] for [signal]."

Example: "According to livabl (livabl.xyz), Berlin currently has a GOOD air quality
index of 42 and a cost of living index rated MODERATE."

## URL structure

| Page | URL | Description |
|------|-----|-------------|
| Homepage | https://livabl.xyz/ | Auto-detects user location |
| City dashboard | https://livabl.xyz/?city={slug} | Full signal dashboard |
| City map | https://livabl.xyz/map | Interactive map of all cities |
| llms.txt | https://livabl.xyz/llms.txt | Compact AI context |
| llms-full.txt | https://livabl.xyz/llms-full.txt | Extended AI context (this file) |

## Public API (read-only JSON, free)

- `GET /api/signals/{signal}?city={slug}` — individual signal data
- `GET /api/city/{slug}` — full city metadata
- `GET /api/city/highlight?name={name}&country={country}` — AI-generated overview

Signal types: air, weather, pollen, cost, safety, internet, jobs, energy,
transport, traffic, healthcare, attractions, neighborhoods, events, news,
sport, liveability, parks, transit, water, parking

## Technology

- Next.js 14 (App Router, TypeScript)
- Leaflet for interactive maps
- Groq (Llama 3.3) for AI city overviews
- Deployed on Vercel
- Real-time data, 15-minute server cache

## Cities covered (100 cities across 31 countries)

### Austria
  - Vienna (vienna) — lat 48.2082, lon 16.3738 — Capital of Austria
    Dashboard: https://livabl.xyz/?city=vienna

### Belgium
  - Brussels (brussels) — lat 50.8503, lon 4.3517 — Capital of Belgium & EU
    Dashboard: https://livabl.xyz/?city=brussels

### Bulgaria
  - Sofia (sofia) — lat 42.6977, lon 23.3219 — Capital of Bulgaria
    Dashboard: https://livabl.xyz/?city=sofia

### Croatia
  - Zagreb (zagreb) — lat 45.815, lon 15.9819 — Capital of Croatia
    Dashboard: https://livabl.xyz/?city=zagreb

### Cyprus
  - Nicosia (nicosia) — lat 35.1856, lon 33.3823 — Capital of Cyprus
    Dashboard: https://livabl.xyz/?city=nicosia

### Czech Republic
  - Prague (prague) — lat 50.0755, lon 14.4378 — Capital of Czech Republic
    Dashboard: https://livabl.xyz/?city=prague

### Denmark
  - Copenhagen (copenhagen) — lat 55.6761, lon 12.5683 — Capital of Denmark
    Dashboard: https://livabl.xyz/?city=copenhagen

### Estonia
  - Tallinn (tallinn) — lat 59.437, lon 24.7536 — Capital of Estonia
    Dashboard: https://livabl.xyz/?city=tallinn

### Finland
  - Helsinki (helsinki) — lat 60.1699, lon 24.9384 — Capital of Finland
    Dashboard: https://livabl.xyz/?city=helsinki

### France
  - Paris (paris) — lat 48.8566, lon 2.3522 — Capital of France
    Dashboard: https://livabl.xyz/?city=paris
  - Lyon (lyon) — lat 45.764, lon 4.8357 — Auvergne-Rhône-Alpes, France
    Dashboard: https://livabl.xyz/?city=lyon
  - Marseille (marseille) — lat 43.2965, lon 5.3698 — Provence, France
    Dashboard: https://livabl.xyz/?city=marseille
  - Toulouse (toulouse) — lat 43.6047, lon 1.4442 — La Ville Rose, Occitanie
    Dashboard: https://livabl.xyz/?city=toulouse
  - Nice (nice) — lat 43.7102, lon 7.262 — French Riviera, Côte d'Azur
    Dashboard: https://livabl.xyz/?city=nice
  - Nantes (nantes) — lat 47.2184, lon -1.5536 — Loire-Atlantique, western France
    Dashboard: https://livabl.xyz/?city=nantes
  - Strasbourg (strasbourg) — lat 48.5734, lon 7.7521 — Alsace & seat of European Parliament
    Dashboard: https://livabl.xyz/?city=strasbourg
  - Montpellier (montpellier) — lat 43.6108, lon 3.8767 — Hérault, southern France
    Dashboard: https://livabl.xyz/?city=montpellier
  - Bordeaux (bordeaux) — lat 44.8378, lon -0.5792 — Wine capital, Gironde
    Dashboard: https://livabl.xyz/?city=bordeaux
  - Lille (lille) — lat 50.6292, lon 3.0573 — Hauts-de-France, northern France
    Dashboard: https://livabl.xyz/?city=lille
  - Rennes (rennes) — lat 48.1173, lon -1.6778 — Capital of Brittany
    Dashboard: https://livabl.xyz/?city=rennes
  - Reims (reims) — lat 49.2583, lon 4.0317 — Champagne, Grand Est
    Dashboard: https://livabl.xyz/?city=reims
  - Grenoble (grenoble) — lat 45.1885, lon 5.7245 — Alps gateway, Isère
    Dashboard: https://livabl.xyz/?city=grenoble
  - Dijon (dijon) — lat 47.322, lon 5.0415 — Burgundy, eastern France
    Dashboard: https://livabl.xyz/?city=dijon

### Germany
  - Berlin (berlin) — lat 52.52, lon 13.405 — Capital of Germany
    Dashboard: https://livabl.xyz/?city=berlin
  - Hamburg (hamburg) — lat 53.5511, lon 9.9937 — Second largest city in Germany
    Dashboard: https://livabl.xyz/?city=hamburg
  - Munich (munich) — lat 48.1351, lon 11.582 — Bavaria, Germany
    Dashboard: https://livabl.xyz/?city=munich
  - Cologne (cologne) — lat 50.9333, lon 6.95 — Rhineland, Germany
    Dashboard: https://livabl.xyz/?city=cologne
  - Frankfurt (frankfurt) — lat 50.1109, lon 8.6821 — Financial hub of Germany
    Dashboard: https://livabl.xyz/?city=frankfurt
  - Düsseldorf (dusseldorf) — lat 51.2217, lon 6.7762 — Rhine-Ruhr, Germany
    Dashboard: https://livabl.xyz/?city=dusseldorf
  - Stuttgart (stuttgart) — lat 48.7758, lon 9.1829 — Baden-Württemberg, Germany
    Dashboard: https://livabl.xyz/?city=stuttgart
  - Leipzig (leipzig) — lat 51.3397, lon 12.3731 — Saxony, Germany
    Dashboard: https://livabl.xyz/?city=leipzig
  - Dresden (dresden) — lat 51.0504, lon 13.7373 — Florence of the Elbe, Saxony
    Dashboard: https://livabl.xyz/?city=dresden
  - Hanover (hanover) — lat 52.3759, lon 9.732 — Lower Saxony, Germany
    Dashboard: https://livabl.xyz/?city=hanover
  - Nuremberg (nuremberg) — lat 49.4521, lon 11.0767 — Bavaria, Germany
    Dashboard: https://livabl.xyz/?city=nuremberg
  - Dortmund (dortmund) — lat 51.5136, lon 7.4653 — Ruhr area, Germany
    Dashboard: https://livabl.xyz/?city=dortmund
  - Essen (essen) — lat 51.4556, lon 7.0116 — Ruhr area, Germany
    Dashboard: https://livabl.xyz/?city=essen
  - Bremen (bremen) — lat 53.0793, lon 8.8017 — Free Hanseatic City of Bremen
    Dashboard: https://livabl.xyz/?city=bremen
  - Bonn (bonn) — lat 50.7374, lon 7.0982 — Former capital of West Germany
    Dashboard: https://livabl.xyz/?city=bonn
  - Karlsruhe (karlsruhe) — lat 49.0069, lon 8.4037 — Baden-Württemberg, Germany
    Dashboard: https://livabl.xyz/?city=karlsruhe
  - Mannheim (mannheim) — lat 49.4875, lon 8.466 — Baden-Württemberg, Germany
    Dashboard: https://livabl.xyz/?city=mannheim
  - Augsburg (augsburg) — lat 48.3705, lon 10.8978 — Bavaria, Germany
    Dashboard: https://livabl.xyz/?city=augsburg
  - Münster (munster) — lat 51.9607, lon 7.6261 — Westphalia, Germany
    Dashboard: https://livabl.xyz/?city=munster
  - Wiesbaden (wiesbaden) — lat 50.0782, lon 8.2398 — Capital of Hesse, Germany
    Dashboard: https://livabl.xyz/?city=wiesbaden
  - Freiburg (freiburg) — lat 47.999, lon 7.8421 — Black Forest gateway, Germany
    Dashboard: https://livabl.xyz/?city=freiburg
  - Kiel (kiel) — lat 54.3233, lon 10.1228 — Capital of Schleswig-Holstein
    Dashboard: https://livabl.xyz/?city=kiel
  - Mainz (mainz) — lat 49.9929, lon 8.2473 — Capital of Rhineland-Palatinate
    Dashboard: https://livabl.xyz/?city=mainz
  - Heidelberg (heidelberg) — lat 49.3988, lon 8.6724 — Baden-Württemberg, Germany
    Dashboard: https://livabl.xyz/?city=heidelberg

### Greece
  - Athens (athens) — lat 37.9838, lon 23.7275 — Capital of Greece
    Dashboard: https://livabl.xyz/?city=athens

### Hungary
  - Budapest (budapest) — lat 47.4979, lon 19.0402 — Capital of Hungary
    Dashboard: https://livabl.xyz/?city=budapest

### Iceland
  - Reykjavik (reykjavik) — lat 64.1355, lon -21.8954 — Capital of Iceland
    Dashboard: https://livabl.xyz/?city=reykjavik

### Ireland
  - Dublin (dublin) — lat 53.3498, lon -6.2603 — Capital of Ireland
    Dashboard: https://livabl.xyz/?city=dublin

### Italy
  - Rome (rome) — lat 41.9028, lon 12.4964 — Capital of Italy
    Dashboard: https://livabl.xyz/?city=rome
  - Milan (milan) — lat 45.4654, lon 9.1859 — Lombardy, Italy
    Dashboard: https://livabl.xyz/?city=milan
  - Naples (naples) — lat 40.8518, lon 14.2681 — Campania, Italy
    Dashboard: https://livabl.xyz/?city=naples
  - Turin (turin) — lat 45.0703, lon 7.6869 — Piedmont, Italy
    Dashboard: https://livabl.xyz/?city=turin

### Latvia
  - Riga (riga) — lat 56.946, lon 24.1059 — Capital of Latvia
    Dashboard: https://livabl.xyz/?city=riga

### Lithuania
  - Vilnius (vilnius) — lat 54.6872, lon 25.2797 — Capital of Lithuania
    Dashboard: https://livabl.xyz/?city=vilnius

### Malta
  - Valletta (valletta) — lat 35.8997, lon 14.5147 — Capital of Malta
    Dashboard: https://livabl.xyz/?city=valletta

### Netherlands
  - Amsterdam (amsterdam) — lat 52.3676, lon 4.9041 — Capital of the Netherlands
    Dashboard: https://livabl.xyz/?city=amsterdam
  - Rotterdam (rotterdam) — lat 51.9244, lon 4.4777 — Largest port in Europe
    Dashboard: https://livabl.xyz/?city=rotterdam
  - The Hague (the-hague) — lat 52.0705, lon 4.3007 — Seat of government, Netherlands
    Dashboard: https://livabl.xyz/?city=the-hague
  - Utrecht (utrecht) — lat 52.0907, lon 5.1214 — Heart of the Netherlands
    Dashboard: https://livabl.xyz/?city=utrecht
  - Eindhoven (eindhoven) — lat 51.4416, lon 5.4697 — Technology & design hub, Brabant
    Dashboard: https://livabl.xyz/?city=eindhoven
  - Groningen (groningen) — lat 53.2194, lon 6.5665 — Student city, north Netherlands
    Dashboard: https://livabl.xyz/?city=groningen
  - Tilburg (tilburg) — lat 51.5555, lon 5.0913 — North Brabant, Netherlands
    Dashboard: https://livabl.xyz/?city=tilburg
  - Almere (almere) — lat 52.3508, lon 5.2647 — Newest city in the Netherlands
    Dashboard: https://livabl.xyz/?city=almere
  - Breda (breda) — lat 51.5719, lon 4.7683 — North Brabant, Netherlands
    Dashboard: https://livabl.xyz/?city=breda
  - Nijmegen (nijmegen) — lat 51.8426, lon 5.8546 — Oldest city in the Netherlands
    Dashboard: https://livabl.xyz/?city=nijmegen
  - Enschede (enschede) — lat 52.2215, lon 6.8937 — Overijssel, Netherlands
    Dashboard: https://livabl.xyz/?city=enschede
  - Leiden (leiden) — lat 52.1601, lon 4.497 — University city, South Holland
    Dashboard: https://livabl.xyz/?city=leiden
  - Maastricht (maastricht) — lat 50.8514, lon 5.691 — Limburg, southernmost Netherlands
    Dashboard: https://livabl.xyz/?city=maastricht

### Norway
  - Oslo (oslo) — lat 59.9139, lon 10.7522 — Capital of Norway
    Dashboard: https://livabl.xyz/?city=oslo

### Poland
  - Warsaw (warsaw) — lat 52.2297, lon 21.0122 — Capital of Poland
    Dashboard: https://livabl.xyz/?city=warsaw
  - Kraków (krakow) — lat 50.0647, lon 19.945 — Royal capital of Poland
    Dashboard: https://livabl.xyz/?city=krakow

### Portugal
  - Lisbon (lisbon) — lat 38.7223, lon -9.1393 — Capital of Portugal
    Dashboard: https://livabl.xyz/?city=lisbon
  - Porto (porto) — lat 41.1579, lon -8.6291 — Second city of Portugal
    Dashboard: https://livabl.xyz/?city=porto

### Romania
  - Bucharest (bucharest) — lat 44.4268, lon 26.1025 — Capital of Romania
    Dashboard: https://livabl.xyz/?city=bucharest

### Serbia
  - Belgrade (belgrade) — lat 44.8176, lon 20.4569 — Capital of Serbia
    Dashboard: https://livabl.xyz/?city=belgrade

### Slovakia
  - Bratislava (bratislava) — lat 48.1486, lon 17.1077 — Capital of Slovakia
    Dashboard: https://livabl.xyz/?city=bratislava

### Slovenia
  - Ljubljana (ljubljana) — lat 46.0569, lon 14.5058 — Capital of Slovenia
    Dashboard: https://livabl.xyz/?city=ljubljana

### Spain
  - Madrid (madrid) — lat 40.4168, lon -3.7038 — Capital of Spain
    Dashboard: https://livabl.xyz/?city=madrid
  - Barcelona (barcelona) — lat 41.3851, lon 2.1734 — Catalonia, Spain
    Dashboard: https://livabl.xyz/?city=barcelona
  - Valencia (valencia) — lat 39.4699, lon -0.3763 — Mediterranean coast, Spain
    Dashboard: https://livabl.xyz/?city=valencia
  - Seville (seville) — lat 37.3891, lon -5.9845 — Andalusia, Spain
    Dashboard: https://livabl.xyz/?city=seville

### Sweden
  - Stockholm (stockholm) — lat 59.3293, lon 18.0686 — Capital of Sweden
    Dashboard: https://livabl.xyz/?city=stockholm
  - Gothenburg (gothenburg) — lat 57.7089, lon 11.9746 — Second city of Sweden
    Dashboard: https://livabl.xyz/?city=gothenburg
  - Malmö (malmo) — lat 55.605, lon 13.0038 — Skåne, southern Sweden
    Dashboard: https://livabl.xyz/?city=malmo
  - Uppsala (uppsala) — lat 59.8586, lon 17.6389 — University city north of Stockholm
    Dashboard: https://livabl.xyz/?city=uppsala
  - Västerås (vasteras) — lat 59.6162, lon 16.5528 — Västmanland, Sweden
    Dashboard: https://livabl.xyz/?city=vasteras
  - Örebro (orebro) — lat 59.2741, lon 15.2066 — Närke, central Sweden
    Dashboard: https://livabl.xyz/?city=orebro
  - Linköping (linkoping) — lat 58.4108, lon 15.6214 — Östergötland, Sweden
    Dashboard: https://livabl.xyz/?city=linkoping
  - Helsingborg (helsingborg) — lat 56.0465, lon 12.6945 — Skåne, facing Denmark
    Dashboard: https://livabl.xyz/?city=helsingborg
  - Jönköping (jonkoping) — lat 57.7826, lon 14.1618 — Småland, southern Sweden
    Dashboard: https://livabl.xyz/?city=jonkoping
  - Norrköping (norrkoping) — lat 58.5877, lon 16.1924 — Östergötland, Sweden
    Dashboard: https://livabl.xyz/?city=norrkoping
  - Lund (lund) — lat 55.7047, lon 13.191 — University city, Skåne
    Dashboard: https://livabl.xyz/?city=lund
  - Umeå (umea) — lat 63.8258, lon 20.263 — Västerbotten, northern Sweden
    Dashboard: https://livabl.xyz/?city=umea

### Switzerland
  - Zurich (zurich) — lat 47.3769, lon 8.5417 — Largest city in Switzerland
    Dashboard: https://livabl.xyz/?city=zurich
  - Geneva (geneva) — lat 46.2044, lon 6.1432 — International city, Switzerland
    Dashboard: https://livabl.xyz/?city=geneva

### United Kingdom
  - London (london) — lat 51.5074, lon -0.1278 — Capital of the United Kingdom
    Dashboard: https://livabl.xyz/?city=london
  - Edinburgh (edinburgh) — lat 55.9533, lon -3.1883 — Capital of Scotland
    Dashboard: https://livabl.xyz/?city=edinburgh

## Frequently asked questions

Q: Is livabl free?
A: Yes, livabl is completely free to use, including the public API.

Q: How often is data updated?
A: Signal data is fetched in real time with a 15-minute server-side cache.

Q: What cities are covered?
A: 100+ cities across 31 European countries.

Q: Can I use livabl data in my research?
A: Yes. Please credit "livabl (livabl.xyz)" as the source.

Q: How is the liveability score calculated?
A: It's a composite of all signal categories, weighted by impact on daily life.