# Compile and run a sample project (/en/realtime-media/broadcast-streaming/build/set-up-your-project/compile-run-sample-project/javascript)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Agora provides [Open-source sample projects on GitHub](https://github.com/AgoraIO/API-Examples-Web) to demonstrate the implementation of basic and advanced Video SDK features.

This page shows how to compile, configure, and run the Video SDK ReactJS sample project.

## Prerequisites

* A [supported browser](reference/supported-platforms).

* A JavaScript package manager such as [npm](https://www.npmjs.com/package/npm).

* A camera and a microphone

* A valid Agora account and project. Please refer to [Agora account management](/en/introduction/account) for details.

* Installed [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)

## Project setup

### Get the sample project

Run the following command to clone the GitHub repository locally:

```bash
git clone https://github.com/AgoraIO/API-Examples-Web
```

The GitHub examples repository provides the following projects:

| Description                  | Path                  |
| :--------------------------- | :-------------------- |
| Feature demos                | `/Demo`               |
| Extension demos              | `/ExtensionDemo`      |
| Vue framework examples       | `/vue/api-examples`   |
| **React framework examples** | `/react/api-examples` |

### Configure the sample project

Navigate to `/react/api-examples` and run the following command to install the dependencies.

```bash
npm install
```

## Run the sample project

1. Use the following command to run the sample project.

   ```bash
   npm run dev
   ```

2. On the demo page, enter your [App ID](/en/introduction/account), [token](/en/introduction/account), and channel name and join the channel.

The channel name must be the same as the channel ID you used to generate the token.