Skip to content
Documentation sections
Discover

Discover Home

What this screen is for

The bottom bar's default tab. It lists a search box, city chips for the first five distinct cities encountered, and cover-photo cards for published businesses. With device location on, the list starts from the nearest business; if the customer has an upcoming appointment, it sits above the list as its own banner.

When you would use this

A customer opens the app to find a business — searching a name, narrowing to a city, or just seeing what is nearby — and lands here by default.

Who sees it

Every signed-in customer account sees it; it is one of the three tabs the bottom bar always shows.

Where it lives

The screen exists only in the mobile app.

What you can do here

Search by name, description or city

Text typed into the search box is matched, case-insensitively, against a business's name, description, city and district; an empty box leaves the list unchanged.

Narrow by city

The first five distinct cities encountered among the listed businesses become chips; tapping one narrows the list to that city, the "All" chip clears the filter.

See the nearest business first

Once device location is available, the list sorts by distance to the business, ascending; a business with no location sorts to the end.

Retry when location is off

When the location service is off or permission was refused, a line says so alongside a "retry" button; the list keeps showing without location.

See an upcoming appointment

If the customer has an upcoming appointment, its nearest one shows as its own card under the search box; tapping the card opens the appointment's detail.

Move to a business's profile

Tapping a card opens that business's profile.

What the server accepts and refuses

Only published, non-suspended businesses are listed

The list reads only businesses that are published and not suspended by an administrator, straight from the server; a draft or suspended business never appears here.

City chips show the first five cities encountered, not the busiest five

Chips are not ranked by how many businesses are in each city; the first five distinct cities the stream happens to encounter become chips, and a sixth or later city never gets one.

With location off, ordering keeps stream order rather than shuffling it

When device location cannot be resolved, the list shows in the order it arrived from the server, not by distance.