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

# Getting started with Base Code

> Work on your existing GitHub code in Base Code: connect your GitHub account, choose a repository, and make your first change on a branch with a live preview.

[Base Code](https://base44.com/base-code) gives your team a shared cloud environment for your existing GitHub code, with no local setup, while GitHub stays the source of truth. Connect a repository and describe a change in the AI chat, and the AI gets your project running and writes the code on its own branch, so your changes stay there until your pull request is merged.

If you built your app in Base44, keep building it in the app editor and [connect it to GitHub](https://docs.base44.com/developers/app-code/local-development/github.md) to sync its code.

![Base Code making a change from the AI chat on a working branch, with the project files and the Preview updating](https://mintcdn.com/base44/14mHcwtsjgXgI4LR/images/base-code-hero-animated.gif?s=e70877ead77d357b9f715e8ee11adb45)

Using Base Code

> [card] [Ready to get started?](https://app.base44.com/base-code)
>
> Open Base Code and sign in to Base44, or create a free account.

***

## Step 1 | Connect your GitHub account

Base Code works directly in your GitHub repositories, so it needs access to the ones you want to work on.

> [!WARNING]
>
> **Before you connect:**
>
> * **Role:** You need an Editor role or higher in the workspace.
> * **Project:** Your project must be a web or full-stack project in a GitHub repository. In a monorepo, the project at the root of the repository must qualify, and a mobile app in a subfolder is fine.
> * **GitHub access:** You need a GitHub account with write access to the repository, or Base Code can [make your own copy](#paste-a-link) of one you can't push to.

If your GitHub account is already connected, continue to [choosing a repository](#choosing-a-repository).

**To connect your account:**

1. Go to [Base Code](https://app.base44.com/base-code) and sign in to Base44, or create a free account.
2. Click **Connect GitHub**.
3. Sign in to GitHub if prompted, then authorize **Base44 Builder**.
4. Select the GitHub account or organization, then follow the prompts to install or configure **Base44 Builder**. Choose which repositories it can reach:

   * **All repositories:** Every repository in the account, including new ones. Choose this on your own GitHub account if you plan to [fork or copy repositories](#paste-a-link), so Base44 can reach each new copy.
   * **Only select repositories:** Only the repositories you pick. Include each repository you want to work on.

   > [!NOTE]
   >
   > If you aren't an owner of the GitHub organization, GitHub sends your request to the organization's owners and you see **Waiting for approval**. After an owner approves it, click **Connect GitHub** again.

***

## Step 2 | Choose a repository

Pick the repository you want to work on in **Connect your repository**. If you can't push to it, Base Code can make your own copy of it on GitHub.

> [!NOTE]
>
> Setting up your project doesn't change your repository. Base Code keeps its setup files on the Base44 side, so it doesn't commit them or create a setup branch.

> [tab] From your account
>
> **To choose a repository from your account:**
>
> 1. Open **Connect your repository** in [Base Code](https://app.base44.com/base-code):
>    * **Your first repository:** If your repository isn't among the ones shown, click **Other repos**.
>    * **Another repository:** Click the repository drop-down at the top of the sidebar, then click **Add repository**. On mobile, it's called **Add new repository**.
> 2. Select a repository.
> 3. Keep the selected **Branch** or select another.
> 4. Click **Connect**.

> [tab] Paste a link
>
> **To choose a repository by pasting a link:**
>
> 1. Open **Connect your repository** in [Base Code](https://app.base44.com/base-code):
>    * **Your first repository:** If your repository isn't among the ones shown, click **Other repos**.
>    * **Another repository:** Click the repository drop-down at the top of the sidebar, then click **Add repository**. On mobile, it's called **Add new repository**.
> 2. Click **Paste a link**.
> 3. Paste the GitHub repository URL.
> 4. Continue based on your access:
>    * **You have write access:** Keep or change the selected **Branch**, then click **Connect**.
>    * **You don't have write access:** Under **Your copy on GitHub**, keep or change the suggested name, then choose a copy. Your pull requests target your copy, not the original repository.
>      * **Fork (public):** Linked to the original, so you can send changes back to it. Click **Fork and connect**.
>      * **Private copy:** Only you can see and edit it, and it isn't linked to the original. Click **Copy and connect**.

> [!TIP]
>
> If your repository is already shown on the Base Code start screen, you can select it and click **Open in Base** instead. Base Code connects it on its default branch.

If you can't connect or edit your repository, choose what applies:

> [accordion] My repository isn't listed
>
> If your repository isn't listed in **Connect your repository**, give Base44 access to it on GitHub.
>
> **To update repository access:**
>
> 1. Give **Base44 Builder** access to the repository on GitHub.
> 2. Reopen **Connect your repository** in Base Code.

> [accordion] My repository's organization isn't approved
>
> If you see "Your workspace's GitHub policy doesn't allow this import", or Base44 says your repository isn't in an approved GitHub organization, your workspace doesn't allow repositories from that organization. Ask someone who [manages your workspace's GitHub organizations](#managing-github-organizations) to connect the organization and mark it **Allowed**, then try again.
>
> The same rule applies to a [fork or private copy](#paste-a-link). Base Code creates it in your own GitHub account, so that account must also be in your workspace's connected organizations and marked **Allowed**.

> [accordion] I can't make changes or create a branch
>
> If your project shows a **Read only** badge, or Base Code asks for GitHub access when you click **Create branch**, your GitHub account isn't connected or doesn't have write access to the repository. In a read-only project, you can still discuss it in the AI chat and switch branches.
>
> **To connect your GitHub account:**
>
> 1. Go to [Base Code](https://app.base44.com/base-code).
>
> 2. Click the connect button Base Code shows you:
>    * **In a read-only project:** Open the project, then click **Connect account** in the **Connect your GitHub account** banner.
>    * **When you create a branch:** Click **Connect to GitHub**.
>
> 3. Authorize **Base44 Builder** on GitHub.
>
> 4. (Optional) If you were creating a branch, click **Create branch** again.
>
> > [!NOTE]
> >
> > If you see **GitHub write access required** or "Your GitHub account can't push to this repo", your account is connected but doesn't have write access. Ask a repository admin to give your GitHub account write access, then click **Recheck permissions**, or try creating the branch again. You can also connect [your own copy](#paste-a-link) of the repository instead.

***

## Step 3 | Make your first change

After you connect a repository, your project opens in the Base Code editor, and the AI sets it up on the branch you connected, showing each step as it goes. Setup is done when your project appears in **Preview**. If a step fails, click **Fix setup** to have the AI fix it.

Then describe your first change on the Base Code start screen. Base Code creates a branch for it and names it for you.

Setup is free. After that, each request uses your workspace's [credits](https://docs.base44.com/Account-and-billing/Credits.md#how-credits-are-used).

**To make your first change:**

1. Go to [Base Code](https://app.base44.com/base-code) when setup finishes in the AI chat.

2. If you've connected several repositories, select the one you want to change in the repository drop-down at the top of the sidebar.

3. (Optional) Select the branch to start from in the drop-down next to **Create new branch from**.

4. Describe the change you want to make in the prompt box. For example:

   ```text theme={null}
   Add a dark mode toggle to the settings page,
   and remember the choice between visits.
   ```

5. Click **Create branch**. If Base Code asks for GitHub access, see [I can't make changes or create a branch](#i-cant-make-changes-or-create-a-branch).

   ![The Base Code home screen with a dark mode request in the prompt box and Create branch outlined](https://mintcdn.com/base44/Los6Grrnm9gT0VmU/images/base-code-first-change-create-branch.png?fit=max\&auto=format\&n=Los6Grrnm9gT0VmU\&q=85\&s=cb0545d17de7a364a275ef7a6ec5fad4)

   Creating your first branch

6. Review the change in **Preview** once it appears, then ask the AI chat for any adjustments.

7. When you're happy with the change, [open a pull request](https://docs.base44.com/base-code/branches-and-pull-requests.md#opening-a-pull-request) so your team can review it on GitHub.

> [!NOTE]
>
> **How your project runs:**
>
> * **Saved after each reply:** When the AI finishes each reply, Base Code commits and pushes its changes to your working branch on GitHub.
> * **Preview, not hosting:** Base Code provides a development preview, not production hosting. To release your changes or connect a custom domain, use your project's existing deployment process and hosting provider.
> * **Your own stack:** Your project keeps its own database, authentication, and routing. Connecting a repository doesn't add any Base44 database, login, or code to your project. To add a database, authentication, or CI/CD, ask the AI chat to add it with your project's own stack, and [add any connection strings or API keys as secrets](https://docs.base44.com/base-code/making-changes.md#adding-secrets).
> * **Coming back:** When you come back to Base Code, your project environment starts back up. If it needs rebuilding, Base Code rebuilds it from the latest commit on your GitHub branch, so you only get back the changes that reached GitHub. Before you leave, let the AI finish its reply.

***

## Managing GitHub organizations

Connect your team's GitHub organizations to your workspace so everyone in it can work on their repositories. Connected organizations belong to your workspace, so apps keep syncing even if the person who connected one leaves.

> [!WARNING]
>
> **Who can manage GitHub organizations:**
>
> * **Plan:** You need a [Builder plan](https://base44.com/pricing) or higher to manage GitHub organizations.
> * **Role:** Only workspace owners and admins can add an organization. On an Enterprise plan (Business or Enterprise), they can also choose who else can add organizations under **Who can connect organizations**.

In Base Code, everyone works through their own GitHub connection, so the **Choose how your team writes to GitHub** setting in your workspace settings doesn't apply.

**To add a GitHub organization:**

1. Click your workspace name at the bottom left of your account.
2. Click **Settings**.
3. Click **GitHub** under **Build tools**.
4. Click **Add organization** under **Connected organizations**.
5. Sign in to GitHub if prompted, then authorize **Base44 Builder**.
6. Choose the account or organization, then install **Base44 Builder**.

   > [!NOTE]
   >
   > If you aren't an owner of the GitHub organization, GitHub sends your request to the organization's owners. After an owner approves it, click **Add organization** again.

**To manage GitHub organizations:**

1. Click your workspace name at the bottom left of your account.
2. Click **Settings**.
3. Click **GitHub** under **Build tools**.
4. Choose what you want to do:
   * **Filter organizations:** Use the filter in **Connected organizations** to show **All**, **Active**, or **Disconnected** organizations.
   * **Choose which organizations new apps can use:** Use **Allowed** next to each organization. Once any organization isn't allowed, members can connect repositories only from organizations that are, and you and other owners and admins can still connect any repository. Changing **Allowed** doesn't affect apps already using that organization.
   * **Disconnect an organization:** Click the **Actions** icon next to the organization, click **Disconnect organization**, then click **Disconnect**. Apps tied to that organization's workspace connection stop syncing with GitHub, and the confirmation lists them. **Base44 Builder** stays installed on GitHub, so you can reconnect the organization later.

***

## FAQs

> [accordion] How do I apply a coupon code?
>
> A Base Code coupon makes AI chat requests free for everyone in your workspace for 30 days, while the model is set to **Auto**. You can apply it before or after connecting a repository.
>
> You can apply 1 coupon per workspace. Each code also works in only a limited number of workspaces, so if you see "This code has reached its redemption limit", try another code.
>
> **To apply a coupon:**
>
> 1. Go to [Base Code](https://app.base44.com/base-code).
> 2. Enter your coupon code:
>    * **Before connecting a repository:** Click **Have a coupon?** at the top right, then enter your code in the dialog.
>    * **After connecting a repository:** Enter your code in the field under **Have a coupon?**.
> 3. Click **Apply**.

> [accordion] Why isn't my repository in All apps?
>
> You'll find each repository you connect in the repository drop-down at the top of the Base Code sidebar, not in **All apps**. A repository shows in **All apps** only if you add it to a folder.

> [accordion] Where can I learn about privacy and data use?
>
> Base44's [Privacy Policy](https://base44.com/privacy-policy) explains how personal information is collected and used. [Privacy and security](https://docs.base44.com/Community-and-support/Privacy-and-security.md) covers AI model training and your data controls.


## Related topics

- [Getting started as an enterprise admin](https://docs.base44.com/Enterprise/getting-started-admin.md)
- [Migrating a project to Base44](https://docs.base44.com/Getting-Started/migrating-an-existing-app.md)
- [Using Base44 built-in integrations](https://docs.base44.com/Integrations/built-in-integrations.md)
- [Using integrations](https://docs.base44.com/Integrations/Using-integrations.md)
- [Hiring a Base44 partner](https://docs.base44.com/Getting-Started/Hiring-a-partner.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.