Cloning the boilerplate

In this guide, we will go through the process of setting up a SaaS application using SaaSKit.

Prerequisites

Before we start, make sure you have the following installed:

• Node.js (>= 18.0.0)
• PNPM (>= 8.0.0)
• Git (>= 2.0.0)

Clone the boilerplate

To get the codebase on your machine, clone the repository using Git:

git clone [email protected]:saas-kits/remix-boilerplate.git

The above command will clone the repository into a directory named remix-boilerplate. You can change the directory name to whatever you want.

Add your own remote

Once you have cloned the repository, you can add your own remote to it:

cd remix-boilerplate
git remote remove origin
git remote add origin <your-git-repo-url>
git remote add upstream [email protected]:saas-kits/remix-boilerplate.git

This will remove the default remote and add your own remote to the repository. You can now push your code to your own remote.

Fetching new changes

If you want to fetch the latest changes from the upstream repository, you can run the following command:

• Make sure you don't have any uncommitted changes before running the above command.
• Make sure you run the above command from the root of the repository.

git fetch upstream

This might result in merge conflicts. If it does, you can resolve them manually.

Installing dependencies

Once you have cloned the repository, you can install the dependencies using PNPM:

pnpm install

For application to properly run, we will need to add some environment variables.

Adding environment variables

Copy the .env.example file to .env:

cp .env.example .env

We will need to add the following environment variables:

DATABASE_URL=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
RESEND_API_KEY=
HOST_URL=
SESSION_SECRET=
 
 
## Stripe
STRIPE_WEBHOOK_SECRET=
STRIPE_PUBLIC_KEY=
STRIPE_SECRET_KEY=

We will go through each of these environment variables in detail.

Let's start with the Database URL in the next section.