This is a beginner's guide to using Git to make a SquareBit.io product. Welcome!
To submit product updates you must have Git installed and know the basics of interacting with Git. Don't worry - it's easy to get started!
If you haven't already downloaded and installed Git, read this guide for more information:
If you are new to Git, it is highly recommended that you install a graphical user interface, instead of using the command line.
The guide will assume that you are using the command line, but is still worth reading to understand the concepts. If you use a graphical program to interact with Git, you will want to follow any guide that program offers its users.
First you will clone the product you created. You can find the Git URL on your product page.
Copy the URL in that tab, and clone the product. The
clone command downloads the Git
repository for you so you can make changes.
git clone https://cdn.squarebit.io/squarebit/an-example-product.git
A commit is a change that you tell Git you'd like to make. Until you use the commit command, Git will not pick up on any changes to your project.
First create a file - any file - in the project directory. Before we tell Git to commit the changes,
we have to tell Git the file exists by using
git add. Do the following command:
git add .
Git has now added every file that is in the current directory to its index. Now we can tell Git we are preparing to send our update by committing the changes.
git commit -m "my first change"
-m flag here tells Git we would like to also add a message. This is useful for telling
customers what changed in the commit.
So far we created a file, told Git it existed with
add, and then told Git we are ready
to submit those changes for everyone to see with
commit. The only thing left is to send
the changes with
git push origin master
The push command tells Git we want to publish all of our changes and send them to SquareBit.io. The origin and master keywords tell Git which code base we want to push. This concept isn't important right now. At this point you should get a success message that the changes were accepted.
If you are caught up on the concepts stated, you might want to checkout out a Git graphical user interface. Instead of using a command line you will use a visual program to make changes.
If you like the command line but want to learn more, the official Git docs are pretty great.
Links to both more Git documentation and graphical user interfaces can be found in the following Git introduction guide: