Onboarding & Discovery

The onboarding wizard runs the first time a guest opens the app. A handful of light questions establish intent (just curious, want to try, ready to join), location and language. From the answers the wizard composes a personalised next-step screen: nearby beginner sessions, the closest clubs that run welcome programmes, suggested content cards and a single primary CTA — usually "Find a try-petanque event near you".

The getting-started content library is structured as bite-sized cards, not a wall of text. Each card covers one topic — what the game is, how a mène works, scoring, formats (tête-à-tête, doublette, triplette), basic etiquette, what to wear — with photos, short videos and a 30-second read time. Cards are tagged and surfaced contextually elsewhere in the app (a first-time spectator opening a live match sees scoring and end-of-mène cards in a dismissible footer).

The nearest-club finder uses the device's GPS (or a typed postcode if location is denied) to list clubs within a chosen radius, sorted by distance, with badges for beginner-friendly, training nights and language. A tap opens the club's profile with a one-tap contact CTA. Try-petanque events are a curated calendar surface — only events flagged as beginner-friendly by their organiser appear, with explicit copy on equipment provided, fees, language and what to expect.

The rules overview is a structured walk-through with diagrams, animated micro-demos and a glossary of French terms (mène, tirer, pointer, biberon). The equipment guide covers what a beginner actually needs (no boules required for first sessions; club loaners are typical) and progresses to a buyer's guide with weight, diameter and hardness explanations. The sport ambassador programme matches newcomers with experienced players in their area who have opted in to mentor — the ambassador receives a notification, can accept and arrange a meet-up through in-app chat. Onboarding state is persisted so progress survives logouts and device switches.