Convert existing local project into git project


How to turn a local folder into a git versioned project and push to GitHub

3 Jan, 2021 · 2 min read

I’m pretty sure we’ve all been here at some stage, you have a local folder with a quick project. The project soon turns out to be pretty useful so you actually wanted version control on it.

So how do we convert this folder into a git versioned project and even push it to GitHub?

First of all, we should have this local project somewhere on our computer, for me, it’s a folder called local-gitter which contains a very basic website.

Local gitter folder structure

Creating the GitHub project

Now let’s head over to GitHub and create a new empty project.

GitHub new project

On the next screen, you can fill out the name of your project, and add a description.

You can optionally choose to create it with a readme or gitignore file.

GitHub new repo settings

Once we have this repository, it’s important to note the URL.

GitHub repo url

Pushing our existing files to this repository

Now let’s open our favorite terminal and follow these steps

  • Navigate to the project folder.
  • git init (start new git project)
  • touch .gitignore (add ignore the file, add files you don’t want in git here)
  • git add . or git add ${all relevant files} (the dot adds everything, else add all files you want in git)
  • git commit -m "first message" (Make it a good message)
  • git remote add origin [email protected]:rebelchris/local-gitter.git (change with your URL)
  • git push -u origin master

Note: The gitignore file is super useful to not push stuff like node_modules for instance, always make sure to add these in the gitignore.

And we are done, now if we head over to GitHub we should see all the files we just committed.

GitHub with all our files

Thank you for reading, and let’s connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next 📖

Undo wrong Git changes

30 Jul, 2022 · 3 min read

Undo wrong Git changes

Git basics: Changing your last commit message

19 Jul, 2022 · 2 min read

Git basics: Changing your last commit message

Join 2099 devs and subscribe to my newsletter