Cofounder Docs

GitHub

Understand how managed GitHub repositories are created during onboarding.

GitHub

During onboarding, Cofounder creates two managed GitHub repositories:

  • an app repository
  • a marketing repository

These repositories are private and auto-initialized during provisioning.

Role

GitHub is where the code lives.

  • the app repository holds the main product codebase
  • the marketing repository holds the site, launch pages, and growth surface

What Cofounder Sets Up

After the repositories are created, Cofounder also seeds:

  • baseline repository config
  • initial folder structure
  • .github/workflows CI files

How GitHub Connects To The Rest Of The Stack

The managed GitHub repositories are what the managed Vercel projects get linked to during onboarding.

They are also the repositories the engineering agents work against when they open branches, make changes, and put up pull requests.

Repository Access And Invites

If you cannot open the managed repositories in GitHub, make sure your Cofounder account is signed in with GitHub or linked to the GitHub account that should receive access.

Agents work through Cofounder's connected repository context. If GitHub is not connected, do not use an agent as a workaround by asking it to clone a private repo manually. Connect GitHub through the in-app sign-in or account-linking flow, then use the supported repository access flow instead.

Organization admins can invite a GitHub user to the managed app and marketing repositories from Settings > Advanced under Get access to managed repos. Enter the user's GitHub username and Cofounder will send repository collaborator invites for the managed repositories. The user should then accept the GitHub invites from GitHub.

Import Your Own Repo

Some workspaces also let you replace the managed app repo or marketing repo with a repo you already own.

That flow lives in Settings > Advanced.

It covers:

  • choosing whether the repo is for the app or marketing site
  • selecting the GitHub repo
  • making sure the Cofounder GitHub app is installed
  • linking the managed Vercel project to that repo
  • setting the root directory
  • syncing env vars

For app repos, it can also keep managed Supabase env wiring, migrations, and the prod branch setup aligned.

Next Steps