SaaSBox
Search…
Commandline Interface
Edit your templates locally and push to your app.
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 and push templates (Full Tutorial)

Getting Started

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

Template #1 - Default Light Theme

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

Template #2 - Dark Theme

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

Template #3 - Tailwind UI

1
git clone [email protected]:saasbox-templates/with-tailwindui.git
Copied!
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:
1
{
2
"apikey": "e6125403603450f0c8701a34ddf14ae66e6",
3
"appid": "42652a13-66a3-4dd3-960e-243dc0160ee6"
4
}
Copied!
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:
1
sbox -d -a .
Copied!
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.

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.