> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ergomake.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Set up your first preview

Every time a developer opens a pull request, Ergomake deploys a preview environment and adds a link to your pull request.

Your team can use those links to test your application and show your work to others.

<img className="block dark:hidden" src="https://mintcdn.com/ergomake/ScIiHhWeo4EpJxNG/images/pr-comment-light.png?fit=max&auto=format&n=ScIiHhWeo4EpJxNG&q=85&s=19ecab34ccaf7da37289dd431f1f0d5e" alt="PR comment light" width="2010" height="1570" data-path="images/pr-comment-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/ergomake/ScIiHhWeo4EpJxNG/images/pr-comment-dark.png?fit=max&auto=format&n=ScIiHhWeo4EpJxNG&q=85&s=4ce8a77940be2168f442e87e56c3a48c" alt="PR comment dark" width="1994" height="1564" data-path="images/pr-comment-dark.png" />

After you merge your pull-request, the environment gets destroyed.

## Getting started

1. [Log into the Ergomake dashboard](https://app.ergomake.dev).

2. Select the desired organization and click the "Add Repository" button.

3. During the installation process, you'll be prompted to give it access to the repository for which you want to generate previews.
   **Make sure to select all the repositories you need**.

   > ⚠️ Ergomake can't generate previews if it doesn't have access to a repository.

4. Click the `Configure` button in the [dashboard](https://app.ergomake.dev). When you do that, Ergomake will create a PR for you with an example configuration file.
   Update this compose file with your application's configurations so that we can spin up previews for *your* application.

5. Merge Ergomake's PR once you're happy with how the preview looks.

## Configuring your previews

Learn how to configure previw environments for your application.

<CardGroup cols={2}>
  <Card title="Create your first preview" icon="1" href="/your-first-preview">
    Learn how to integrate with GitHub pull requests to create your first
    automatic preview.
  </Card>

  <Card title="Environment variables and secrets" icon="key" href="/configurations/environment-variables">
    How to manage environment variables for build and runtime.
  </Card>

  <Card title="Networking" icon="network-wired" href="/configurations/networking">
    Learn about how Ergomake routes requests to and within environments.
  </Card>

  <Card title="Multiple repositories" icon="rectangle-vertical-history" href="/configurations/multiple-repos">
    Learn how to setup Ergomake if you need to spin-up previews with
    multiple repos.
  </Card>

  <Card title="Databases and other third-party software" icon="database" href="/configurations/third-party-software">
    Learn how to set up databases and other pieces of third-party software
    upon which your preview environment depends.
  </Card>

  <Card title="Seeding" icon="seedling" href="/configurations/seeding">
    Learn how to seed your databases.
  </Card>
</CardGroup>