--- title: Quick Start slug: oms/shopify/developer-tools/gatsby/quick-start docTags: createdAt: 2022-11-08T14:21:27.000Z --- Chord has a starter that allows you to get a fully functional ecommerce site up and running in a few minutes. Our starter is built on the Gatsby framework, so we'll use the Gatsby CLI. This guide assumes you already have Node.js and Git installed on your machine. If you don't, there are some helpful instructions in [Gatsby's documentation](https://www.gatsbyjs.com/tutorial/part-zero/). ### 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 at [https://github.com/chordcommerce/gatsby-starter-performance](https://github.com/chordcommerce/gatsby-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 `` with the Github token you just created: :::CodeblockTabs \~/.npmrc ```shell //npm.pkg.github.com/:_authToken= @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 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:/gatsby-starter-performance.git # or with the GitHub CLI gh repo clone /gatsby-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 Shopify storefront access token and credentials to your Contentful space. Talk to the Chord team to get these. ### Start your development server Install project dependencies: :::CodeblockTabs yarn ```shell yarn install ``` npm ```shell npm install --legacy-peer-deps ``` ::: After installation is complete, start the development server: :::CodeblockTabs yarn ```shell yarn start # starts site at http://localhost:8000 ``` npm ```shell npm start # starts site at http://localhost:8000 ``` ::: You can see your new site at [http://localhost:8000](http://localhost:8000/). Hot reload is enabled by default. **That's it! You're off and running. ✨**