# Introduction

Proposed level of Achievement: Apollo 11

## What is Run Mania?

A mobile application made using React Native that generates suitable looping routes of a specific distance you set for running and keeps track of your runs while having gamification features. Compete and challenge your friends as you level up through running!

## **Motivation**

Ever felt unhealthy and have been putting on some weight? Unwilling to go for runs because of the same old route all the time? Perhaps during runs, you start to lose motivation as you run through the repetitive scenery just to clock your mileage.

Many can relate to such thoughts, having realized that they are out of shape. They can acknowledge that their lifestyle choices might not be the healthiest. Despite acknowledging this, few are willing to take it one step further to make changes in their lifestyle, citing reasons such as laziness or the lack of any incentives. Hence, we want to increase the conversion rate from acknowledgement to action.

## **Aim**

We envision an application that generates a route of X distance based on the user’s input in a way that the user completes the run in just one round, while also having intentions to gamify the application to reach out to the gaming community.

## **User Stories**

As a user, 

1. I have always found that repeated rounds around a park/stadium boring and tires me out faster. I want to be able to pick a route based on distance.
2. I want to be able to easily pick a new route of a longer distance as I progressively improve on running.
3. I want to be able to compare my total distance ran with other users.
4. I want to track and log all my runs, so that I can view them all in the future.
5. I want to be able to see my avatar stats.
6. I want to be able to compete with other users' avatars in a pvp battle.
7. I want to time my runs and see other information like calories burned.
8. I want to be able to add my friends and accept friend requests.

## Poster

![](/files/-MetgYkmfDNuAMTeJDxh)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://run-mania.gitbook.io/run-mania/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.