SaaSBox
Search…
⌃K

Commandline Interface (developers only)

Edit your templates locally and push to your app.
The easiest way to edit your pages is to change them right through the github editor and deploying automatically. If this suits you better please view the relevant guide here.
The more flexible, and powerful option for developers is to use commandline interface. SaaSBox CLI is ideal for editing your templates locally on your computer and pushing them to your application with a single command. Find out more about the CLI below.
SaaSBox CLI lets you check out a template via git, and edit your templates locally, then push your template to your SaaS and make it live.
The benefit of this approach is that you can maintain different versions of your template as a development project, and have the convenience of using a dev studio or editor to edit your pages.
Pushing your changes to your SaaS re-creates the same template in the application, pushing your template description, Pug files and static assets.

How to get started, installation and push templates (Full Tutorial)

The full setup for NodeJS and installing the CLI

Getting Started

Installing the CLI:
npm install saasbox-cli
Checking out available templates:

Template #1 - Default Light Theme

git clone [email protected]:saasbox-templates/with-atis-light.git
This template comes with a user dashboard with pointers to how you can integrate a nocode application.

Template #2 - Dark Theme

git clone [email protected]:saasbox-templates/with-atis-dark.git

Template #3 - Tailwind UI

git clone [email protected]:saasbox-templates/with-tailwindui.git
NOTE: Email us at [email protected] with your github username as "our client" to access the Tailwind UI based template under the client access license terms in their license.

Licensing

These templates were created to work with SaaSBox, using designs bought from template publishers.
To remove any doubt for you to use them in your projects, it is best to buy a one time license from these 3rd party providers:
  • For Template #1, and #2, go to https://shuffle.dev
  • For Template #3, go to https://tailwindui.com
The additional components and drag and drop tools they provide will be handy to customize your SaaS frontend pages.

Adding your API Keys:

Go to "Inbound API Keys" section of your SaaS dashboard. Click on "Generate API Key"
Inbound API keys are used for making any request into SaaSBox, such as pushing a template.
Create a new file in your user home directory called sbox.config.json. As an example this files resides in /Users/yourname/sbox.config.json on a Mac.
Copy paste your API key and Application ID as follows:
{
"apikey": "e6125403603450f0c8701a34ddf14ae66e6",
"appid": "42652a13-66a3-4dd3-960e-243dc0160ee6"
}
This file will be read by the sbox cli and used for API credentials.
Edit your frontend files and push from inside your template directory:
sbox -d -a .
Here, "." represents current directory, and -d means deploy. Deploy will deploy the template, however it will not make it go "live". If you want to both deploy and make your template live, a "-a" or "--active" option needed as well.

Overview of the template directory structure. Pushing your first update and asset

Check out how the template directory contains, and deploy your first update

Next Steps

Congratulations! You have edited and pushed your SaaS template, and the template is maintained on your local computer. It is highly recommended to create a git repo and track versions of your SaaS template.