Getting GitHub working, in order
You've decided. From here we stop selling it to you and start getting it done. Tick things off as you go, this browser remembers, no account needed.
0 of 8 steps everyone does · next: Decide whether you need this at all
First
Get set up properly
Ten minutes of thinking here saves a week of rebuilding later.
- 03
Create your GitHub account
about 15 minWhy now, You have decided you need it, so the account is the first real move.
Sign up on the free plan. It includes private repositories and unlimited collaborators, so there is nothing to buy at this stage. Use an email address that belongs to the business and that you will still control in five years.
This account will own the definitive copy of your software. Whoever controls the email controls the account.
Done when, You are signed in to GitHub on an account tied to a business email address.
You'll know it worked when sign out and sign back in to confirm you can actually get in unaided.
Open your GitHub accountGoes directly to GitHub's official site.
- 04
Turn on two factor authentication and save the recovery codes
about 15 minWhy now, The account exists and is empty, which is the cheapest possible moment to secure it.
Enable two factor authentication, then save the recovery codes somewhere that is not your phone and not the same laptop. A password manager or a printed copy in a drawer both work.
Losing access to this account means losing the definitive copy of your software. The recovery codes are the only route back if the phone goes in a river.
Done when, Two factor authentication is on and the recovery codes are stored somewhere outside your phone.
You'll know it worked when open your stored recovery codes and confirm you can actually read them.
Work out how to get back into your account
Use this when you cannot sign in to the account that holds your code.
Get back into the account that holds your software.
Works through the official recovery routes in order of what you still control.
- 05
Get your first repository, private
about 25 minWhy now, The account is live and secure, so the code has somewhere safe to land.
If a builder made your app, connect that builder to GitHub and let it create the repository. If you have code already, create an empty repository yourself. Either way, set it to private unless you have a specific reason to publish it.
Private is the right default for anything a business runs on. Public means the entire internet can read it, including anything careless left in the code.
Done when, One repository exists, it contains your code, and its visibility is set to private.
You'll know it worked when open the repository while signed out, in a private browser window. If you can read it, it is public.
The builder that writes your code
A two way connection between the tool that builds your app and the repository that stores it.
It is what makes the GitHub copy real rather than a stale snapshot. Changes made in the builder arrive in the repository, and changes pushed to the repository arrive back in the builder.
- You get
- A live copy of your software in your own account, and the option to work outside the builder later.
- You'll need
- A GitHub account, and a project in the builder.
- Do this
- Connect the builder to GitHub from inside the builder and let it create the repository.
- Check it
- Make a change in the builder, then refresh the repository and see the change listed in the history.
- Then
- Check the repository visibility.
Haven't got it? That's fine, The builder holds the only copy, and your access to your own software depends entirely on that account staying open to you.
Read our take on LovableOfficial source · as of September 2026 · Two way sync documented on the builder's own integration page, verified 10 September 2026.
- 06
Check with your own eyes who can see it
about 10 minWhy now, A repository now exists, so its visibility is a real state rather than an intention.
Open the repository settings and read the visibility setting. Change it if it is not what you intended.
Accidentally public code is the single most common and most expensive mistake here, and it is silent when it happens.
Done when, The visibility setting reads private, or you have deliberately chosen public and know why.
You'll know it worked when the repository page shows a private label next to its name.
Before you build
Work out what you're building
This part happens in ChatGPT, Claude or Gemini, whichever you already use. You come back with one clear request to hand over.
- 01
Decide whether you need this at all
about 10 minWhy now, This is the first thing that decides whether the rest of the path applies to you.
Answer one question honestly: does your business depend on software that was built for it, rather than bought off the shelf. If yes, GitHub belongs in your stack. If everything you use is somebody else's product, close this and come back when that changes.
GitHub stores and tracks code. With no code, it is an empty filing cabinet that makes you feel organised and does nothing else.
Done when, You can say in one sentence what code you have and where it currently lives.
You'll know it worked when if your answer is that a builder holds the only copy of something your business runs on, that is a yes.
Decide whether you need GitHub yet
Use this before you sign up for anything, while you are still deciding whether this belongs in your stack at all.
Get a straight yes or not yet, in your own situation.
Turns the general advice that everyone should use GitHub into an answer about your business.
- 02
Understand what it is before you sign up
about 15 minWhy now, Every later step uses these two words, so they need to mean something first.
Read the two short official pages: one explains that Git is the system that records every change, and the other explains that a repository is simply the folder those changes are recorded in. That is the whole idea.
Most people abandon GitHub because the words are unfamiliar, not because the tool is hard. Ten minutes here removes the fog.
Done when, You could explain to someone else what a repository is and what a commit records.
You'll know it worked when you can read the word commit without needing to look it up.
Then
Get something that actually works
One real, working version, then protect it before you change anything else.
- 07
Make one small change and watch it get recorded
about 20 minWhy now, You have a repository, and the fastest way to understand it is to use it once.
Edit something trivial, such as the description file, and save it. Then open the history and look at the entry that just appeared, with your name, the time, and exactly what changed.
This is the moment the point of GitHub becomes obvious. Until you have seen a change recorded, it is an abstraction.
Done when, You have made one change and can see it listed in the repository history.
You'll know it worked when the history shows your change, who made it and when.
Git on your own computer
The free program that copies a repository down to your machine and sends changes back up.
Only needed once you or someone helping you wants to work on the code outside the browser.
- You get
- Working on the code locally, and taking full copies including the history.
- You'll need
- A repository that already exists.
- Do this
- Install Git only when you have a reason to. Reading and editing in the browser is enough at first.
- Check it
- You can download the repository to your machine and see the files.
- Then
- Take your own copy of the repository.
Haven't got it? That's fine, Nothing breaks. You are simply limited to working through the GitHub website, which is fine for a long time.
Official source · as of September 2026 · GitHub's own explanation of the split between Git and GitHub, verified 10 September 2026.
Have my own repository explained back to me
Use this once a repository exists and you are looking at it wondering what any of it is.
Understand your own software in ordinary language.
Reads your repository back to you in plain English, including which parts matter in an emergency.
Find out what actually changed and when
Use this when something in your software behaves differently and you need to know what moved.
Turn the change history into an answer.
Finds what changed over a period you name and which of it could explain the problem.
- 08
Take a copy you hold yourself
about 20 minWhy now, There is now something in the repository worth having a copy of.
Download a full copy of the repository to your own machine or drive. Do it once now, and put a reminder in the calendar to do it again every few months.
GitHub is very reliable, but the entire reason you are here is not depending on one company staying reachable and staying friendly. A copy you hold is the end of that argument.
Done when, A dated copy of the repository exists somewhere you control that is not GitHub.
You'll know it worked when open the downloaded copy and confirm the files are actually in it.
Only if your build needs it
Add what this particular build requires
None of these apply to every build. Each one says when it applies to yours.
- 09
Give a developer access without handing over your account
Useful laterabout 15 minWhy now, This applies the first time anyone other than you touches the code.
Applies when Only when someone other than you is going to work on the code.
When someone else needs to work on the code, invite them as a collaborator on the repository. Never share your own login. Remove their access the day the work ends.
Sharing a password gives away the account, the history and the ability to lock you out. An invitation gives away only the work.
Done when, The person you are working with has their own access and you have not shared a password.
You'll know it worked when the repository access list shows them by name, and shows you as the owner.
Somebody else to work on the code
A developer, contractor or colleague who will edit the software alongside you.
The collaboration features exist for this and only this. Until there is a second person, none of it applies to you.
- You get
- Reviewed changes, separate access, and a record of who did what.
- You'll need
- A repository, and actual work to hand over.
- Do this
- When the day comes, invite them as a collaborator rather than sharing your login.
- Check it
- Their name appears in the repository access list and yours still shows as owner.
- Then
- Learn what a pull request is before they open one.
Haven't got it? That's fine, You keep working alone, which is the normal state for most owners and costs you nothing.
Official source · as of September 2026 · GitHub's own collaborator invitation documentation, verified 10 September 2026.
Hand the code to a developer without losing control
Use this the first time somebody other than you is going to work on the code.
Let someone work on the code without giving away the account.
Produces the access to grant, how to grant it, and how to remove it when the work ends.
- 10
Learn how a change gets reviewed before it goes live
Useful laterabout 15 minWhy now, Once more than one person touches the code, changes stop being instant and start being proposed.
Applies when Only once you are working with a developer or a team.
Read the official page on pull requests. You do not need to run one today. You need to know the mechanism exists, so that when a developer says they have opened one, you know what you are being asked for.
This is where an owner stops being at the mercy of whoever is writing the code. A change proposed and reviewed is a change you can question before it reaches customers.
Done when, You can say what a pull request is and why you would want one.
You'll know it worked when a developer mentions a pull request and you know what to look at.
Connections
What to connect it to, and what to leave alone
Connecting everything is the expensive mistake. Each of these says what it is, why you'd want it, and whether you want it yet.
Recommended for this build
The builder that writes your code
A two way connection between the tool that builds your app and the repository that stores it.
It is what makes the GitHub copy real rather than a stale snapshot. Changes made in the builder arrive in the repository, and changes pushed to the repository arrive back in the builder.
- You get
- A live copy of your software in your own account, and the option to work outside the builder later.
- You'll need
- A GitHub account, and a project in the builder.
- Do this
- Connect the builder to GitHub from inside the builder and let it create the repository.
- Check it
- Make a change in the builder, then refresh the repository and see the change listed in the history.
- Then
- Check the repository visibility.
Haven't got it? That's fine, The builder holds the only copy, and your access to your own software depends entirely on that account staying open to you.
Read our take on LovableOfficial source · as of September 2026 · Two way sync documented on the builder's own integration page, verified 10 September 2026.
Useful later
Git on your own computer
The free program that copies a repository down to your machine and sends changes back up.
Only needed once you or someone helping you wants to work on the code outside the browser.
- You get
- Working on the code locally, and taking full copies including the history.
- You'll need
- A repository that already exists.
- Do this
- Install Git only when you have a reason to. Reading and editing in the browser is enough at first.
- Check it
- You can download the repository to your machine and see the files.
- Then
- Take your own copy of the repository.
Haven't got it? That's fine, Nothing breaks. You are simply limited to working through the GitHub website, which is fine for a long time.
Official source · as of September 2026 · GitHub's own explanation of the split between Git and GitHub, verified 10 September 2026.
Not needed yet
Somebody else to work on the code
A developer, contractor or colleague who will edit the software alongside you.
The collaboration features exist for this and only this. Until there is a second person, none of it applies to you.
- You get
- Reviewed changes, separate access, and a record of who did what.
- You'll need
- A repository, and actual work to hand over.
- Do this
- When the day comes, invite them as a collaborator rather than sharing your login.
- Check it
- Their name appears in the repository access list and yours still shows as owner.
- Then
- Learn what a pull request is before they open one.
Haven't got it? That's fine, You keep working alone, which is the normal state for most owners and costs you nothing.
Official source · as of September 2026 · GitHub's own collaborator invitation documentation, verified 10 September 2026.
Something not behaving? The problems people actually hit with GitHub, and the prompts that fix them, are on the main page.
Problems and fixes