Questions? hello@viberation.devGet supportBlogDocsChangelog

Colour mode

XGitHub
Get started
← All walkthroughs

Walkthrough · Project build

beginner

Ship your first web project

Step 4 of 6 · linear, one-off

0 of 19 done

  1. Idea
  2. Setup
  3. Stack
  4. 4GitHub
  5. 5Deploy
  6. 6Launch

GitHub

Put your code online, so it is backed up and ready to deploy.

GitHub stores your project and its full history, so a broken laptop is not a lost project. It is also how hosts get your code: once they are connected, every push to GitHub updates your live site. A GitHub account is free.

1. Save your latest changes. create-next-app already made a first commit for you. From your project folder (cd ~/projects/my-project), save what you have changed since:

bash

git add -A
git commit -m "my first changes"

What you should see

A short summary of the files you changed, and a commit ID. If git says nothing to commit, you have not changed anything yet, which is fine. If git asks who you are, set your name and email with git config, then run the commit again.

2. Create a GitHub account at github.com, if you do not have one. Use the same email you gave Git in the Setup step.

3. Make an empty repository. On GitHub, click the + at the top right, then New repository. Name it my-project. Public or Private both work. Leave the README, .gitignore and license options switched off. Your project already has its own, and an extra file on GitHub makes your first push fail.

4. Connect and push. Your new repository page shows a section headed ...or push an existing repository from the command line. Copy those three lines and run them in your project folder. They look like this, with your own username:

bash

git remote add origin https://github.com/YOUR-USERNAME/my-project.git
git branch -M main
git push -u origin main

What you should see

The first time, you are asked to sign in (see below). Then a few lines counting and writing objects, ending with branch main set up to track origin/main. Refresh your repository page on GitHub and your files are there.

Signing in the first time

A window pops up asking you to connect to GitHub. Choose Sign in with your browser, approve it on the page that opens, and the push carries on by itself. Git for Windows remembers you, so this only happens once.

Stuck? Pick a prompt and ask your AI tool

I am trying to put my first project on GitHub and got stuck. What I ran: [paste the commands] What I saw: [paste the full message] Explain what went wrong in plain words and give me the exact commands to fix it, one step at a time. I am a beginner, so do not skip steps.

Open it in your AI tool. Clicking copies the prompt, and ChatGPT and Grok open with it already filled in.

More tools

App builders, in your browser:

Code editors on your computer. Open app only works once it is installed, so use Get it first if you do not have it.

Want the full list? Browse all app builders and coding editors (IDEs).

  • Saved my changes with a commit
  • Created a GitHub account
  • Pushed the code to GitHub
  • Sign in to tick these off and pick up where you left them.

Tools used in this build

Everything this walkthrough reaches for, with the directory entry for each.

  • Models

    Claude

    Anthropic's model family, strong at long-context coding work.

    Freemium
  • CLIs

    Claude Code

    Anthropic's agentic coding tool in your terminal.

    Paid
  • Models

    Gemini

    Google DeepMind's multimodal model family.

    Freemium
  • Models

    GPT

    OpenAI's model family, behind ChatGPT and Codex.

    Freemium
  • Frameworks

    Next.js

    The React framework most AI tools generate best.

    Open source
  • Templates

    shadcn/ui

    Copy-paste React components you own outright.

    Open source
  • Tools

    Supabase

    Postgres, auth, storage and row-level security in one box.

    Freemium
  • Hosting

    Vercel

    Deploy Next.js with a preview URL per pull request.

    Freemium