# Quickstart Setup

Once you have your API keys, it's time to run the MeasureOne Quickstart locally! The instructions below will guide you through the process of cloning the [Quickstart repository](https://github.com/measureone-reference/quickstart), customizing the .env file with your own MeasureOne client ID and Staging secret, and finally, building and running the app.

Before you get started make sure you have [npm](https://nodejs.org/) and [ngrok](https://ngrok.com/download) installed in your system.

## 1. Clone the Quickstart repository to your local machine


```bash
# Note: If you're using Windows, run the following command to ensure correct symlink behavior
# git clone -c core.symlinks=true https://github.com/measureone-reference/quickstart

git clone https://github.com/measureone-reference/quickstart
```

## 2. Set up and start the Backend

To start the node server, navigate to `node` folder and create a .env file

Next, open the .env file in a text editor and fill in the following fields with your credentials:


```bash
M1_API_URL = https://api-stg.measureone.com
M1_CLIENT_ID = <your_client_id>
M1_CLIENT_SECRET = <your_client_secret>
```

Once the .env file is set up, install the necessary dependencies and start the backend application:


```bash

# navigate to node folder
cd quickstart/node

# Install dependencies for the backend app
npm install

# Start the backend app
npm start
```

## 3. Set up and start the Frontend

To start the Frontend, navigate to frontend -> m1-react-quickstart folder and create a .env file

Next, open the .env file in a text editor and fill in the following fields with your `access token`:


```bash
REACT_APP_SERVER_URL = http://localhost:3000
REACT_APP_M1_HOSTNAME = api-stg.measureone.com
REACT_APP_ACCESS_KEY = '<your_access_key>'
```

Once the .env file is set up, open a new terminal shell and install the necessary dependencies and start the frontend application.


```bash

# navigate to frontend -> m1-react-quickstart folder
cd quickstart/frontend/m1-react-quickstart

# Install dependencies for the frontend app
npm install

# Start the backend app
npm start
```

Your application will now be running at [http://localhost:3000](http://localhost:3000). Open your browser and explore the interface to interact with MeasureOne's APIs in real-time.

![Home Page](/assets/quickstart-home-page.3ea210d9b84ad5dabb75b219df1a85e6b4767d4efdb70977d94bb72191283e80.9c1bb791.png)