# Code

Connect GitHub and manage repositories.

Source: https://faros.sh/docs/use/code/


Code connects GitHub repositories to your Faros workspace. It provides repository resources and connection workflows that other capabilities can use when they need source code.

[Get started: connect a repository](https://faros.sh/docs/use/code/quickstart/).

## When to use Code

Use Code to connect the GitHub identity and repositories needed by your work. Inspect the repository connection before starting a workflow that depends on reading or updating source.

## How it fits together

App Studio uses Code for project repositories. GitHub remains the source hosting system and enforces the permissions of the connected credential.

## Before you start

Code enabled and a GitHub credential with access to the intended repositories. Select the workspace where you intend to create or use resources. [Enable the provider](https://faros.sh/docs/use/workspaces/enable-provider/) if needed.

## Availability and permissions

Check your hub’s catalog and deployed versions. Actions are subject to workspace access and provider-specific authorization; connected services also enforce their own permissions.

## Where your data lives

Resource handles belong to your workspace. Git content lives at GitHub; commit and checkout bundles are handled by the provider.

## Start here

- [Quickstart](https://faros.sh/docs/use/code/quickstart/)
- [Troubleshooting](https://faros.sh/docs/use/code/repositories/#troubleshooting)
- [API reference](https://faros.sh/docs/reference/providers/code/)
- [Self-host Code](https://faros.sh/docs/self-hosting/providers/code/)

[Implementation reference](https://github.com/faroshq/faros/blob/main/providers/code/README.md).


## In this section

- [Connect GitHub and create a repository](https://faros.sh/docs/use/code/quickstart/): Verify your source-control connection in the selected workspace.
- [Repositories, collaborators, and builds](https://faros.sh/docs/use/code/repositories/): Manage source-control resources without losing upstream context.