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

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

    ## Prerequisites [#prerequisites-8]

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

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

    * A microphone

    * A valid Agora account and project. Please refer to [Agora account management](../../manage-agora-account.md) for details.

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

    ## Project setup [#project-setup-8]

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

    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-7]

    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-8]

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

       ```bash
       npm run dev
       ```

    2. On the demo page, enter your [App ID](../../manage-agora-account.md), [token](../../manage-agora-account.md), and channel name and join the channel.

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