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/workflowsCI 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.