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

# Quickstart

> Connect a GitHub repository and take a translation through to a pull request.

<Steps>
  <Step title="Sign up with GitHub">
    Sign up at [gitlocalize.com](https://gitlocalize.com) and authorize the GitLocalize GitHub app.

    <Frame>
      <img src="https://mintcdn.com/gitlocalize/lskpih6euvpzy4qL/images/signup-home.png?fit=max&auto=format&n=lskpih6euvpzy4qL&q=85&s=9d03b70275012a2ba7de425887d4c29b" alt="The GitLocalize home page" width="1000" height="404" data-path="images/signup-home.png" />
    </Frame>
  </Step>

  <Step title="Connect a repository">
    Click **Add repository**, then choose the repository, its source and target paths, and its
    languages.

    <Frame>
      <img src="https://mintcdn.com/gitlocalize/lskpih6euvpzy4qL/images/repositories-list.png?fit=max&auto=format&n=lskpih6euvpzy4qL&q=85&s=a11d3345c7ef2e3a3651f5514d790b2d" alt="The Repositories page with the Add repository button" width="2000" height="814" data-path="images/repositories-list.png" />
    </Frame>

    Each field is described in [Repositories](/repositories); the path syntax
    in [Paths and languages](/paths).
  </Step>

  <Step title="Wait for the first sync">
    GitLocalize pulls the matching files and parses them into segments. On a large repository this
    takes hours rather than minutes — see [Syncing](/syncing).
  </Step>

  <Step title="Translate a file">
    Open a file in the editor. Source and translation sit side by side, and untranslated segments are
    highlighted.

    <Frame>
      <img src="https://mintcdn.com/gitlocalize/lskpih6euvpzy4qL/images/diff-management.png?fit=max&auto=format&n=lskpih6euvpzy4qL&q=85&s=d4a0ab0db1adfe43dbe7f08a56d029be" alt="The split-view editor" width="1874" height="1048" data-path="images/diff-management.png" />
    </Frame>
  </Step>

  <Step title="Send it for review">
    **Create Review Request** sends the file to a Language Moderator. Once approved it becomes a pull
    request against your repository — see [Reviews and pull requests](/reviews).
  </Step>
</Steps>

## Next

<CardGroup cols={2}>
  <Card title="How it works" icon="circle-nodes" href="/how-it-works">
    Segments, linking, and why translations stay in step with the source.
  </Card>

  <Card title="Roles and notifications" icon="users" href="/roles">
    Add translators and moderators, and see what each can do.
  </Card>
</CardGroup>