# Compile and run a sample project (/en/realtime-media/rtc/build/join-and-manage-channels/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 RTC SDK features.

This page shows how to compile, configure, and run the RTC SDK JavaScript sample project.

    
  
      
  
      
  
      
  
      
  
      
  
      
  
## Prerequisites

      
  
      
  
      
  
      
  
      
  
      
  
      
* A [supported browser](../../reference/supported-platforms#desktop-browsers).
* A JavaScript package manager such as [npm](https://www.npmjs.com/package/npm).

    
  
      
  
      
  
      
  
      
  
      
  
{ /*
  - If a firewall is deployed in your network environment, refer to [Connect through restricted networks with Cloud Proxy](/en/realtime-media/rtc/manage-agora-account) to use Agora services normally.
  */ }

* A camera and a microphone

* A valid Agora account and project. Please refer to [Agora account management](/en/realtime-media/rtc/manage-agora-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/realtime-media/rtc/manage-agora-account#get-the-app-id), [token](/en/realtime-media/rtc/manage-agora-account#generate-temporary-tokens), and channel name and join the channel.

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