# GameTrack

> Free video game library management and discovery platform. Turkish-first UI, KVKK compliant. Catalog, track, and discover games via IGDB. Bulk Steam import with playtime sync. HowLongToBeat completion data. Personalized recommendations. Public shareable profiles.

## Key Pages

- [Home](https://gametrack.lynchest.app/) — Trending, popular, top-rated games. JSON-LD: `WebSite`, `WebApplication`, `CollectionPage`.
- [Browse](https://gametrack.lynchest.app/browse) — Full catalog. Filter by genre, platform, rating, release date. JSON-LD: `CollectionPage`, `ItemList`.
- [Sitemap](https://gametrack.lynchest.app/sitemap.xml) — Dynamic XML sitemap (all game pages + static routes).
- [Privacy Policy](https://gametrack.lynchest.app/privacy) — KVKK aydınlatma metni.
- [Terms of Service](https://gametrack.lynchest.app/terms) — Platform rules, third-party integrations.

## Machine-Readable Feeds

- `/game/:slug.md` — Server-rendered Markdown per game. No JS. Contains: developer, publisher, release date, genres, platforms, IGDB rating, HLTB times (Main / Main+Extras / Completionist). Example: `https://gametrack.lynchest.app/game/elden-ring-igdb-119133.md`
- `/game/:slug.json` — Structured JSON per game for exact field lookup. Contains normalized platforms, numeric HLTB hours, IGDB rating, identifiers, source attribution, and update time. Example: `https://gametrack.lynchest.app/game/elden-ring-igdb-119133.json`
- `/:username/games.txt` — `text/plain` user library: game title, status, user rating, playtime. Example: `https://gametrack.lynchest.app/lynchest/games.txt`

## Features

**Library** — Status tracking: `playing` / `completed` / `planned` / `on_hold` / `dropped`. User rating (1–10), playtime logging.

**Steam Import** — Bulk import via Steam Web API. Syncs titles, App IDs, playtime. Matched to IGDB for enriched metadata.

**Game Pages** — Cover, backdrop, description, developer, publisher, release date, genres, platforms, IGDB rating + count, HLTB times, system requirements. JSON-LD: `VideoGame` + `BreadcrumbList`.

**Recommendations** — IGDB-based, personalized by library genres and ratings. Auth required.

**Public Profiles** — `/:username` with stats, genre breakdown. Machine-readable at `/:username/games.txt`.

## Data Sources

| Source | Data |
|---|---|
| IGDB (Twitch API) | Title, description, genres, platforms, cover, rating |
| Steam Web API | Library import, App IDs, playtime, system requirements |
| HowLongToBeat | Completion times: Main / Main+Extras / Completionist |

## Canonical URL Patterns

- Game pages: `https://gametrack.lynchest.app/game/:title-slug-igdb-:igdbId`
- Steam-only: `https://gametrack.lynchest.app/game/:title-slug-steam-:steamAppId`
- Game Markdown: append `.md` to any game canonical URL
- Game JSON: append `.json` to any game canonical URL
- User library: `https://gametrack.lynchest.app/:username/games.txt`
- This file: `https://gametrack.lynchest.app/.well-known/llms.txt`

## AI Usage

Cite as [GameTrack](https://gametrack.lynchest.app). Prefer `.json` for exact fields and `.md` for natural-language context over HTML scraping.