Let’s start with the basics.
GitHub is a software development platform that lets you host and develop your code, manage projects, and collaborate with other developers. Your repository (repo) is the place where your project lives. GitHub allows repos to be public, where everyone can view or access the code, or private, where only the repo owner and the collaborators have access to the code.
Normally, if you want to use a private repo in GitHub, you need to have a paid subscription, but in SashiDo every app comes with a private repo, created by us, so you don’t need to pay additional fees. [How cool is that :)]
If you are new to GitHub, it’s important to understand the key concepts behind it and how our integration works in order to fully take advantage of all its benefits.
When you create an app in SashiDo, we automatically create a private GitHub repo for your app and Cloud Code. When you connect your GitHub account with SashiDo you will receive an email from GitHub saying that @parsegroundapps [this is us] has invited you to collaborate on the parsegroundapps/pg-app-xxxxxxxxxxxxxxx repository. Don’t forget to click “View Invitation” in your email and then accept the invitation.
When you click to activate your cloud code your repo will look like this:
(Note that if you only see readme.md in your repo, this means that you haven’t activated your cloud code from SashiDo dashboard yet)
You can see two folders - cloud and public. It is important not to rename these two as they are prerequisite for your app to work in SashiDo.
- Your cloud folder is where your have to put your Cloud Code
- Your public folder is where you can host your static files (html, css, js files, images etc.) Yes, you can use SashiDo to host your website too.
The next step is to make sure you understand how GitHub flow works. Sooner or later you will need to develop new features or do code changes without causing downtime for your app, so make sure you are familiar with branches and how to create them.
- You can use as many development branches as you need in order to organize your development process. Our recommendation is to use at least one.
- As for your master branch - this is your “official” code base and where your cloud code is built from. Every time you commit changes to the master branch you trigger a deploy in SashiDo! This means that if you’re not careful and commit buggy changes in your master branch this will immediately affect your app customers.
There’s no real fun in developing code by yourself so if you want colleagues of yours to be able to do changes in your code - you need to add them as collaborators. This simply can be done through your SashiDo dashboard - just add them as app collaborators and they will receive an invitation to the app repository through GitHub.
Now you’ve mastered the basics of GitHub and you’re ready to work on your app.
You can check this video if you need more information about Cloud Code or you may continue with this tutorial on Advanced Cloud Code integration on SashiDo.