---
title: "Build your app with an external repository"
description: "Here, you will learn how to set-up a React application and run it locally"
url: https://docs.ovhcloud.com/it/guides/public-cloud/data-platform/tutorials-app-development-build
lang: it
lastUpdated: 2026-09-14
---
> For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/it/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/it/llms-full.txt.

# Build your app with an external repository

## Objective

Here, you will learn how to set-up a React application and run it locally.

By the end of this guide, you will be able to edit a Data Platform application by running it **locally**, **connecting** it to the Platform' ecosystem and **deploying** it with a git repository.

## Requirements

There are a few things you need before starting :

- Follow the [Analytics App Getting Started guide](https://docs.ovhcloud.com/it/guides/public-cloud/data-platform/landing-page-getting-started.md) up until [this](https://docs.ovhcloud.com/it/guides/public-cloud/data-platform/getting-started-create-queries.md) point. This is where you expose your API.
- Install [git](https://git-scm.com/).
- Install [Node.js](https://nodejs.org/en/).
- Install [yarn](https://yarnpkg.com/) (recommended) or [npm](https://www.npmjs.com/).
- Install [npx](https://www.npmjs.com/package/npx).
- Have a **text editor**. You'll be writing HTML, CSS, and JavaScript.

:::info
The point of communication between your **Data Platform Project** and your app, is the **Data Platform API** that you exposed in Application Services. That is why it is required to complete the [Getting Started guide](https://docs.ovhcloud.com/it/guides/public-cloud/data-platform/landing-page-getting-started.md) until the part where you expose your data and queries on the API.
:::

## Set-up an application & connect it to Data Platform

### Create an app using an existing template

Clone this [repository](https://github.com/forepaas/getting-started/) and open it:

```bash
git clone https://github.com/forepaas/getting-started.git
cd getting-started/
```

Switch to the branch release/basic

```bash
git checkout release/basic
```

Before installing the Node modules, you'll need to ensure our map-related dependencies are configured for the current environment. Open your package.json file and add the following lines to your dependencies section, or update them if they already exist:

```json
	"dependencies": {
	    // ... other existing dependencies
	    "leaflet": "^1.6.0",
	    "react-leaflet": "^2.7.0",
	    "react-leaflet-markercluster": "^2.0.0"
	  },
```

Install node modules :

```bash
yarn
```

:::warning
If you get an error concerning **certificates** when installing yarn, you should contact your IT department to solve the issue.
:::

Install npx (Skip this step if you have already installed it globaly):

```bash
yarn global add npx
```

Install the Platform modules

```bash
npm run fppm i
```

:::warning
If you run into problems installing the modules, it may be due to your NodeJS configurations. Uninstall and reinstall NodeJS to fix the issue.
:::

:::warning
If the issue persists, it could be due to NodeJS version compatibility. Install NodeJS v16.20.2 to fix the issue.
:::

Run your app :

```bash
yarn start
```

:::info
Open `http://localhost:3333` to check your app. If you see no error but a blank screen, you still need to adjust the app configuration before the panels appear. The blank screen means your app is up & running.
:::

### Connect a git repository to the platform (optional)

To link a git repository to the platform, please follow this [guide](https://docs.ovhcloud.com/it/guides/public-cloud/data-platform/app-services-apps-git-integration.md)

:::info
Now that you've learned how to create and launch your app, it's time to understand its architecture.
:::

[Understand app architecture and configuration files](https://docs.ovhcloud.com/it/guides/public-cloud/data-platform/tutorials-app-development-config.md)

## Go further

If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/it/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project.

Ask questions, give your feedback and interact directly with the team building the Data Platform on the dedicated [Discord channel](https://discord.gg/ovhcloud).

If you need support with your OVHcloud services, create a request in our [Help Centre](https://help.ovhcloud.com/csm?id=csm_get_help).

Join our [community of users](https://community.ovhcloud.com/).