Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.witt-play.com/llms.txt

Use this file to discover all available pages before exploring further.

The Browse page is your starting point for discovering open games in your area. When you open Browse, the feed shows only public, upcoming games — private invite-only games are always hidden here. A count at the top tells you how many games match your current filters, and each card shows the game’s sport, skill level, date, location, and how many spots remain.

​
Opening the filter panel

Every filter lives inside a single Search button in the sticky toolbar at the top of the Browse page. Tap or click it to open the filter popover. A numbered badge on the button shows how many filters are active so you always know when something is narrowing your results.

​
Available filters

​
Location and radius

The location panel inside the filter popover shows your active city and state. Two sources can set this value, in order of priority:
  1. Session override — a location you set for the current browsing session, either by typing a city/state or by clicking Use my current location (which triggers a browser geolocation prompt and reverse-geocodes your coordinates to a city and state).
  2. Profile preference — your saved preferred city from your profile settings.
The Within slider sets the maximum distance in miles. You can set it anywhere from 5 to 100 miles in 5-mile increments. When you adjust the radius, it is saved to your profile so the same value appears next time you browse. Distance badges on each card show how far a game is from your home address (or, if no home address is saved, from your active search location). Games less than 1 mile away show <1 mi.
The distance badge measures from your saved home address, not from your session search location. This keeps “Games Near You” honest if you browse from a different city.
To stop filtering by location altogether, click the × next to the active city name inside the filter panel.

​
Sport and category filter

The Games checklist lets you select one or more specific sports. When “My games only” is on (see below), the list shows only sports from your profile preferences. Turn that toggle off to see every sport across all categories.
  • Check one or more sports to show only games for those sports.
  • When no sports are checked, all sports are shown.
  • Click Clear (show all) to uncheck everything at once.

​
”My games only” toggle

When this toggle is on, the sport list and the filtered results are limited to your profile’s preferred sports and categories. It only appears if your profile has at least one preferred category set. Turning it off opens the browse feed to all sports regardless of your preferences.

​
Skill level filter

The Skill level dropdown lets you match games to your experience. The available options are:
ValueDisplayed label
casualCasual
intermediateIntermediate
competitiveCompetitive
all_levelsAll Levels Welcome
Select Any skill to remove the filter entirely.

​
Beginner-welcoming toggle

The Beginner-welcoming only toggle filters to games whose host has marked the session as beginner-friendly. These games are also identified on each card with a 🌱 Beginner-welcoming badge.

​
Accessibility filters

When one or more accessibility tags are selected, only games that carry every selected tag appear in the results. Tags are defined at the platform level and attached to games by hosts when creating or editing a session.

​
Text search

The text search field (inside the filter popover) matches against a game’s title, sport name, and location. Results update as you type.

​
Distance badges on cards

Each card in the Browse grid may display a small pill badge in the top-right corner of the card showing the distance in miles. The badge only appears when the platform can calculate a distance — either from a precise game location or from the game’s city and state as a fallback.

​
The map view

The Browse page includes an embedded map on each game card (a small static preview at a city-level zoom). The full interactive map is accessible from within each game’s detail page.

​
Resetting filters

Click Reset all filters at the bottom of the filter popover to restore all filters to their defaults: text search cleared, sport list seeded from your profile preferences, skill level set to “Any skill”, beginner-welcoming toggle off, and accessibility filters cleared. Your saved filter state in localStorage is also removed.
If no games appear, try widening your radius with the slider, turning off “My games only”, or removing individual sport selections. You can also be the first to host — the Browse page shows a prompt to create a game when results are empty.

​
Filter persistence

Your filter choices are saved automatically per account in your browser. The next time you open Browse, your sport selection, skill filter, beginner toggle, accessibility tags, and session location will be restored. Resetting filters clears this saved state.