---
title: Quick Start
slug: oms/quick-start
docTags: 
createdAt: 2022-11-08T14:19:35.000Z
---

This guide assumes you already have Node.js and Git installed on your machine.

### Configure access to Chord's private Github repositories 

Share your Github username with the Chord team to gain access to Chord's Github repositories. You'll need to do two things:

1. Make sure you have access to the [starter repository](https://github.com/chordcommerce/nextjs-starter-performance). [Reach out to Chord for access](mailto\:help@chord.co) with your Github username if you do not.
2. Configure your local npm to install Chord's packages from GitHub Packages:

- Go to [https://github.com/settings/tokens](https://github.com/settings/tokens) and click `Generate new token`. Make sure you select the `read:packages` scope. Copy the token.
- If you don't already have one, create a `.npmrc` file in your home directory (`touch ~/.npmrc`).
- Append the following to `~/.npmrc`, replacing the `<YOUR PERSONAL ACCESS TOKEN>` with the Github token you just created:

:::CodeblockTabs
\~/.npmrc

```shell
//npm.pkg.github.com/:_authToken=<YOUR PERSONAL ACCESS TOKEN>
@chordcommerce:registry=https://npm.pkg.github.com
```
:::

This means that any npm packages with the `@chordcommerce` scope will be installed from Github Packages instead of the npm public registry. If you have any trouble on this step, see Github's documentation on [configuring npm for use with Github Packages](https://docs.github.com/en/free-pro-team@latest/packages/using-github-packages-with-your-projects-ecosystem/configuring-npm-for-use-with-github-packages).

### Create a new site&#x20;

Click the "Use this template" button on the starter Github repository to create a new Github repository in your account with the same files and folders, or fork the repo. Then clone your new repo onto your local machine:

```shell
# with git
git clone git@github.com:<YOUR ACCOUNT>/nextjs-starter-performance.git
# or with the GitHub CLI
gh repo clone <YOUR ACCOUNT>/nextjs-starter-performance
```

### Configure your site's environment

```shell
cp .env.example .env
```

You'll need to populate this `.env` file with some environment variables, including your Chord account and CMS credentials. Talk to the Chord team to get these.

### Start your development server&#x20;

Install project dependencies:

:::CodeblockTabs
yarn

```shell
yarn install
```

npm

```shell
npm install
```
:::

After installation is complete, start the development server:

:::CodeblockTabs
yarn

```shell
yarn dev        # starts site at http://localhost:3000
```

npm

```shell
npm run dev     # starts site at http://localhost:3000
```
:::

You can see your new site at [http://localhost:3000](http://localhost:3000). Hot reload is enabled by default.

**That's it! You're off and running.  ✨**