# Onboarding Step 2: Connect GitHub (/docs/projects/onboarding-github)



Reached if you picked **GitHub repository** in
[step 1](/docs/projects/onboarding-source).

## Flow [#flow]

1. **Install the Layers GitHub App** (only if you haven't already) —
   a popup opens to GitHub to grant the app access. You can install it
   on your personal account or on any GitHub Org where you're an admin.
2. **Pick repo** — list of repos the installation has access to. The
   wizard lets you switch between installations if you have more than
   one.
3. **Pick branch** — defaults to the repo's default branch.

## After continue [#after-continue]

Clicking **Continue** sends you to [Confirm details](/docs/projects/onboarding-confirm),
where the analysis actually runs. No analysis happens on this screen.

## What gets analyzed [#what-gets-analyzed]

Layers pulls the chosen branch and runs a server-side analysis pipeline
that extracts brand/app context. Analysis content is ingested through
Layers' onboarding service; the exact file set is implementation-specific
and may change. Source files are not retained beyond the duration of
analysis unless you enable App Machina.

## Reconnecting or changing repos [#reconnecting-or-changing-repos]

After onboarding, manage the GitHub connection from
[Project settings → GitHub](/docs/projects/settings-github).