Skip to main content

F1. Put your code on GitHub

What this page helps you do

Put your project in GitHub so it has a real home, a change history, and a place for deploy automation.

Why it matters

If your app only exists on one laptop, it is not launch-ready. You need a stable place for the code, a history of changes, and a way to share and review updates.

You should already have

  • a local project folder
  • a GitHub account

Skip this page if

  • the project is already in GitHub and pushed successfully

Then go to B1. Already have GitHub.

What to do

  1. Create a new GitHub repository.
  2. Initialize git if the project is not already using it.
  3. Add a useful .gitignore.
  4. Commit the current working version.
  5. Push the project to GitHub.
  6. Add a short README.md that explains what the app is.

At minimum, you want:

  • a default branch
  • a remote origin
  • a repeatable way to clone the project on another machine

Simple example:

git init -b main
git add .
git commit -m "Initial commit"
git remote add origin git@github.com:your-name/your-repo.git
git push -u origin main

Use one GitHub repo per app unless you already understand why a monorepo is the better fit.

Common mistakes

  • pushing secrets along with the first commit
  • having no README, so even the builder forgets the setup a month later
  • only pushing part of the app and leaving important config local

Next step

Go to F4. Run your app locally.

Advanced notes

If the repo is private, that is fine. The important part is that the code is versioned, backed up, and shareable with future-you.