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

# Quickstart

> Get LaneSync running in under 10 minutes — sign in, install the GitHub App, bootstrap your first repo, and advance a release.

Get from zero to your first governed release on the **hosted LaneSync SaaS** at [lanesync.dev](https://lanesync.dev).

<Note>
  This guide covers the **cloud product**. For Docker Compose or self-hosted deployment, see [Enterprise self-hosting](/enterprise/self-hosting).
</Note>

## Prerequisites

* A [GitHub](https://github.com) account
* Org admin access (or permission to install GitHub Apps on your account)
* At least one repository to track

## Onboard your organization

<Steps>
  <Step title="Sign in to LaneSync">
    Open [lanesync.dev](https://lanesync.dev) and click **Sign in with GitHub**.

    LaneSync uses GitHub OAuth. If you belong to multiple organizations, you will see a **workspace picker** after authentication.
  </Step>

  <Step title="Install the LaneSync GitHub App">
    From the setup wizard, install the LaneSync GitHub App on your GitHub org or personal account.

    Choose repositories to grant access — you can add more repos later. LaneSync needs webhook and repository permissions to sync milestones, PRs, and workflow runs.

    <Tip>
      Use the **full tier** GitHub App if you want LaneSync to create branch rulesets automatically. See [Install the GitHub App](/guides/install-github-app) for tier comparison.
    </Tip>
  </Step>

  <Step title="Run the repo setup wizard">
    LaneSync discovers your repositories and prompts the **repo setup wizard** for any new repository.

    The wizard:

    * Detects your primary language and CI template
    * Bootstraps `sdlc.yaml` at the repo root
    * Pushes GitHub Actions workflow templates
    * Creates branch protection rulesets (full tier)

    Choose **trunk-based** or **release-branch** workflow during setup.
  </Step>

  <Step title="Create your first milestone">
    In GitHub, create a milestone (e.g. `v1.0.0`) with 2–3 issues linked to it.

    Alternatively, create the milestone from the LaneSync dashboard using **Create milestone**.
  </Step>
</Steps>

## Advance through the pipeline

<Steps>
  <Step title="PLANNING → DEVELOPMENT">
    Assign all milestone issues to team members. LaneSync blocks advancement until every issue has an assignee.
  </Step>

  <Step title="DEVELOPMENT → TESTING">
    Merge PRs that close milestone issues. Cut a release branch (e.g. `release/v1.0.0`) unless you configured trunk-based releases.
  </Step>

  <Step title="TESTING → EVIDENCING">
    Wait for required CI checks (from `sdlc.yaml`) to pass on the release branch. LaneSync reads check names live from GitHub.
  </Step>

  <Step title="EVIDENCING → DEPLOYMENT">
    Approve the evidence PR from the dashboard or GitHub. Required reviewers are configured in `sdlc.yaml`.
  </Step>

  <Step title="DEPLOYMENT → DEPLOYED">
    Trigger production deploy after the deploy gate passes. Promotion is manual by default.
  </Step>
</Steps>

## What you should see

| Location                                       | What to expect                                                |
| ---------------------------------------------- | ------------------------------------------------------------- |
| [lanesync.dev](https://lanesync.dev) dashboard | Milestone card with stage pipeline (PLANNING → … → DEPLOYED)  |
| Your GitHub repo                               | `sdlc.yaml` and `.github/workflows/` bootstrapped by LaneSync |
| Pull requests                                  | `SDLC Enforce` status check on protected branches             |

The dashboard auto-syncs every 60 seconds. Click **Refresh** or wait for a real-time push after webhook events.

## Next steps

<CardGroup cols={2}>
  <Card title="Advance a full release" icon="flag" href="/guides/first-release">
    Detailed walkthrough of each stage gate.
  </Card>

  <Card title="Configure sdlc.yaml" icon="file-code" href="/guides/configure-sdlc-yaml">
    Customize checks, artifacts, and reviewers per stage.
  </Card>
</CardGroup>