> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/open-source/use-harness-open-source/gitspaces/get-started/quickstart.md).

# Quickstart Guide

Create a Gitspace for a **Node.js app**. Use it to write code, test changes, and publish changes to your remote repository.

### Before you begin <a href="#pre-requisite" id="pre-requisite"></a>

#### Installation <a href="#installation" id="installation"></a>

Gitspaces are available when you install **Harness Open Source**. Go to the [installation guide](/open-source/new-to-harness-open-source/quick-start.md) to install Harness Open Source.

### Sample application <a href="#sample-application" id="sample-application"></a>

Create a Gitspace for the sample application in the [Node.js demo repository](https://github.com/harness-community/demo-repo-nm). Fork the repository to make changes during this exercise.

#### Create a Gitspace <a href="#creating-a-gitspace" id="creating-a-gitspace"></a>

1. **Sign up** for or **Login** to Harness Open Source, and create a [new project](/open-source/new-to-harness-open-source/quick-start.md). You will see Gitspace available in the sidenav.

![](/files/UfO1As8E7feqACeszQ2z)

2. Click on **"Get Started Now"**. To create a Gitspace using the sample app:
   * Choose the **Other Public Git Repositories** tab.
   * Repository URL is <https://github.com/harness-community/demo-repo-nm> (enter URL of your fork if you forked it). Make sure the URL exactly matches the clone URL for the repository since any extra characters can cause an error.
   * Leave the default branch **main** selected.
   * Select the IDE and click on **Create Gitspace**. For this Quickstart, choose **VS Code Browser**, which will open up the Gitspace in a new browser tab
3. After clicking on **Create Gitspace**, you’ll be redirected to the **Gitspace Details** page, where you can view the events and logs as the Gitspace is being created. Once it is ready, you can open the Gitspace by clicking the **Open VS Code Online** button at the top right of the page.
4. In the new browser tab, click on **"Yes, I trust the authors"** and **"Mark Done"** to get started. You can then start coding in the IDE as you normally would.

#### Developing in Gitspace <a href="#developing-in-gitspace" id="developing-in-gitspace"></a>

Now, let’s install dependencies for the sample app and run it. We will also make changes to it and commit back to the fork.

**Run sample app**

1. Open a new terminal. ![](/files/YNFrlM1IJFzvkclm0XAE)
2. All dependencies, packages, tools and libraries needed for this application were installed while provisioning the Gitspace based on the config in [devcontainer.json](https://github.com/harness-community/demo-repo-nm/blob/main/.devcontainer/devcontainer.json). To run the sample app, run the following command in the terminal:

   ```bash
      npm run dev
   ```

   Your application will be available at proxy host 3000. You will see a message at the bottom right of your IDE with a link to open the app in browser. ![](/files/b1hA3tvgQGoF799dvC3h)

The application shows the Harness canary in a variety of fun situations and poses.

**Making changes to sample app**

To make changes to the application, you should have forked it first and then created a Gitspace for the fork.

Steps to make changes and commit to source control:

1. You can make some changes to `haikus.json` such as delete one of the canary sections below. Save the file.

```
    { 
      "text": "traffic in bangalore,\ncondiser fying to work",        
      "image": "canary-flying.png"            
    },
```

2. In the Terminal, configure your GitHub credentials
   * `git config --global user.email "you@example.com"`
   * `git config --global user.name "Your Name"`
3. Now that you've made a few changes, you can use the integrated terminal or the source view to commit your work. We will use the **Source Control** view for this example. ![](/files/5LQV8TMfBuvxvD0lHi9H)
4. To stage your changes, click `+` next to the `haikus.json` file, or next to **Changes** if you've changed multiple files and you want to stage them all.
5. To commit your staged changes, type a commit message describing the change you've made, then click **Commit**.
6. Now **Sync Changes**, it will redirect you to login and authorize to your GitHub. After authorization, your changes will be committed to your fork.

You can now use Harness Open Source Gitspaces for development.
