> For the complete documentation index, see [llms.txt](https://smashzone.gitbook.io/docs-eng/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smashzone.gitbook.io/docs-eng/03-app.md).

# App and How It Works

Smashzone is a mobile application available for **Android and iOS**, designed for real padel players. Its goal is to **turn every match played into a rewarded experience**, without changing what you already do: just play.

***

## 🧩 What does the app do?

* 🔍 Detects if you are on a padel court (geolocation)
* 📲 Syncs your physical activity (steps, calories, active minutes…)
* ✅ Verifies if the match meets the minimum criteria
* 🪙 Rewards you with $SMASH (Season 0 uses a capped promotional reward; Season 1+ activates real mining)
* 📊 Displays your ranking, history, progress, and missions

All from a simple, visual, and direct interface.

***

## 🔐 What permissions does it need?

* **Location:** To validate that the match was played on a real court
* **Physical Activity:** To verify that there was real effort during the match

The app only uses this data to validate the match and **does not store sensitive health information**.

***

## 🛠 Platforms and Compatibility

| System  | Current Status                |
| ------- | ----------------------------- |
| Android | ✅ Functional (Health Connect) |
| iOS     | ✅ Functional (HealthKit)      |

⚠️ Some smartwatch models (Huawei, Garmin, Fitbit…) may not be compatible yet.

***

## 🧭 In-app Navigation

The app is organized into several main screens:

* 🏠 **Dashboard:** your progress, stats, and summary
* 🧑‍💼 **Profile:** match history, points, and details
* 🧩 **Missions:** active and completed challenges
* 🥇 **Ranking:** overall leaderboard by season
* 🔍 **Explore:** courts, tournaments, community (future)
* 🎁 **Rewards:** claim, achievements, and redemption (future)