# PugliApp

> Curated travel guide to Puglia, Italy. 261 places, 53 categories, in English, Italian, and German.
> Every content page is available as Markdown by appending `.md` to its URL or sending the header `Accept: text/markdown`. A JSON API is available under `/api`.

## Guides (Markdown)
- [Home (EN)](/en.md): site overview and category index
- [Home (IT)](/it.md): site overview and category index
- [Home (DE)](/de.md): site overview and category index

## API (JSON)
- [Places](/api/places?locale=en): list & search (params: category, q, limit, offset, features)
- [Place detail](/api/places/{slug}?locale=en)
- [Categories](/api/categories?locale=en)
- [Map pins](/api/map?locale=en)
- [Health/metadata](/api/health)

## Conventions
- Append `.md` to any place/category/home URL, e.g. /en/place/ostuni-old-town.md or /en/great-food.md
- Or send `Accept: text/markdown` to a place or home URL (e.g. /en/place/ostuni-old-town).
- See /AGENTS.md in the source repository for the full data model.