# itch.io browsing The itch Store tab opens on the front page shelves. A row of chips above them (`ui/ItchBrowseBar.kt`) sets an order (Popular, New, Top rated, Top sellers) and a price (Any, Free, On sale). Leave both at their defaults and the shelves stay; pick anything else and the tab shows that query's games as a grid that loads the next page as it scrolls into view. ## Data `ItchBrowse` (`stores/itch/ItchBrowse.kt`) turns a `BrowseQuery` into itch's listing feed: ``` https://itch.io/games[/][/][/platform-...][/tag-...].xml[?page=N] ``` `BrowseQuery` already carries platforms and tags, so the URL builder is complete; the controls for them come in a later change. A price filter has more than one spelling on itch, so `urls()` returns every candidate and `page()` takes the first that answers with games. Every request is logged (`itch.io browse: answered with games`), which is how a wrong guess is found and fixed from a device. Requests go out one at a time, at least 1.2 s apart. A 429 waits 8 s and tries once more; if that fails the games already on screen stay. Each page is kept under the app cache for three hours, so going back to a query does not ask itch again. Results are parsed by `ItchShelves.parse`, the same reader the shelves use, so a game looks the same wherever it appears. `ItchBrowseState` holds the query, the games loaded so far and whether more can be asked for. A newer query bumps a generation counter, so a slow answer for an older one is dropped. A game already in the library replaces its browse copy on the grid, so Install and the owned markers are right; the detail page looks browse results up through `StoresState.detailItem`.