Git & Custom Themes
Custom Referral SaaSquatch themes leverage the power of Git to make theme customization and collaboration easy for you and your team.
What is git?
Git is a version control system for tracking changes in computer files and coordinating work on those files among multiple people. Using git, teams can work on the same project at the same time without stepping on each other's toes.
Learn More about Git
For a great introduction to the workings of git and Github we recommend checking out this interative tutorial on using git.
GitHub also lets you complete many Git-related actions without using the command line, including: Creating a repository, Forking a repository. For more information on this we recommend the github getting started with git guide.
Referral SaaSquatch and Github
At Referral SaaSquatch we use Github as the basis for tracking and versioning custom themes. In this way, every Referral SaaSquatch custom theme is actually it's own Github repository.
We do this because referral programs are usually a collaboration between a lot of people, such as:
- Creative directors - want to maintain brand guidelines
- Front-end developers - that want pixel perfect, hex-code exact, matching with their other assets
- Copy writers - that want to update each individual piece of text, share message and notification
- Referral SaaSquatch developers - who can help you customize your widget
Git lets all of these people work on the referral program's theme in parallel without ever losing anyone's changes. It also maintains a history so that we can test new wording, layouts and changes, and roll back those changes if they don't produce the desired results.
Using your Theme Repository
Pro and Enterprise customers should contact our support team to get access to your custom theme repository.
- Clone your Github repository
git clone https://github.com/saasquatch/MY_CUSTOM_THEME_NAME
- Modify the templates and assets in your theme
- Commit your changes to your Github repository when you are ready to test them
- Publish your updated theme to your test tenant
- Preview your changes in your development environment configured for your test tenant
- Publish your theme to your live tenant
Changes can be made to your theme using this development process even once your referral program is live. You can test out updates to your theme on your test tenant before pushing them to your live program to make sure that everything works before your customers see the changes.
At its core your custom theme is a series of files and folders organized in a standard layout. Handlebars templates are located in the
templates folder, assets in the
and variables defined in
variables.json schema file.
├── /assets | ├── /css | ├── plaincss.css | └── lesscss.less | ├── /js | └── myscript.js | └── /images | └── logo.png ├── /templates | ├── widget.hbs | └── partial.hbs ├── variables.json └── Readme.md