# Compile and run a sample project (/en/realtime-media/video/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 Video SDK features.

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

    
  
      
  
      
  
      
  
      
  
      
  
      
  
## Prerequisites [#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/video/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/video/manage-agora-account) for details.

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

## Project setup [#project-setup]

      
  
      
  
      
  
      
  
      
  
      
  
      
    ### Get the sample project [#get-the-sample-project-6]

    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 [#configure-the-sample-project-6]

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

    ```bash
    npm install
    ```

    
  
      
  
      
  
      
  
      
  
      
  
## Run the sample project [#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/video/manage-agora-account#get-the-app-id), [token](/en/realtime-media/video/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.