⚠️ Not ready for use yet!

SaaS Kit

SaaS Kit is an open source, fast, and free to host SaaS template / boilerplate

• Feature Rich: user auth, user dashboard, marketing site, billing/subscriptions, pricing page, and more.
• Lightning Performance: fast pre-rendered pages which score 100/100 on Google PageSpeed.
• Delighful Developer Experience: tools you'll love working with, including SvelteKit, Tailwind, shadcn-svelte, Postgres, and Supabase.
• Extensible: all the tools you need to make additional marketing pages, UI components, user dashboards, admin portals, database backends, API endpoints, and more.
• Hosting: Our suggested hosting stack is free to host, cheap to scale, easy to manage, and includes automatic deployments.
• MIT Open Source
• Quick Start: Full docs from git clone to deployment.

Based on CriticalMoments/CMSaasStarter by the folks at Critical Moments!

Make mobile apps? Improve conversion rates and ratings with Critical Moments.

(I'm not affiliated with Critical Moments, but I love their work and wanted to make it easier for others to use their template.)

Features

Everything you need to get started for a SaaS company:

• User Authentication: Sign up, sign out, forgot password, email verification, and oAuth. Powered by Supabase Auth.
• Marketing Page with SEO optimization
• User Dashboard with user profile, user settings, update email/password, billing, and more.
• Subscriptions powered by Stripe Checkout
• Pricing page
• Contact-us form
• Billing portal: self serve to change card, upgrade, cancel, or download receipts
• Onboarding flow after signup: collect user data, and select a payment plan
• Style toolkit: theming and UI components
• Responsive: designed for mobile and desktop.
• Extensible: all the tools you need to make additional marketing pages, UI components, admin portals, database backends, API endpoints, and more.

Tech Stack

• Web Framework: SvelteKit
• CSS / Styling
  • Framework: TailwindCSS
  • Component library: shadcn-svelte
• Suggested Hosting Stack
  • Host + CDN: Cloudflare Pages
  • Serverless compute: Cloudflare Workers
  • Authentication: Supabase Auth
  • Database: Supabase Postgres
• Payments
  • Stripe Checkout
  • Stripe Portal

Suggested Hosting Stack

There’s no cost for using this template. The costs below reflect our suggested hosting stack.

• $0/mo — Supabase free tier, Cloudflare free tier.
  • Pros:
    • Free!
    • Can scale to thousands of users.
    • Unlimited static page requests.
    • 100k serverless functions/day.
  • Cons:
    • Does not include database backups. The frugal among you could hook up pgdump backups on lambda/S3 for a few cents per month.
    • Will auto-pause your database when not in use for 7 days.
  • Who it’s for:
    • This tier is perfectly functional for a hobby project, or pre-revenue company (up to 50,000 monthly active users). It’s easy to scale up once revenue starts, but it’s also fine to keep at this scale indefinitely.
• $30/mo - Supabase Pro, Cloudfare Workers Paid
  • Pros:
    • Database backups.
    • Never pauses database.
    • Over 1M serverless functions per day, with linear pricing for additional invocations.
  • Cons:
    • none
  • Who it’s for:
    • I suggest moving to this once you have paid customers or investors.

Performance / Best Practices

The selected tech stack creates lightning fast websites.

• Pre-rendering (static generation) for marketing pages and pricing
• Instant navigation: the best of CSR + SSR in one. SSR your first page for fastest possible initial load times. For subsequent pages, the content is pre-loaded and rendered with CSR, for instant rendering.
• CDN optimized, for high edge-cache hit ratios
• Edge-functions for dynamic APIs/pages
• Svelte and Tailwind compile out unused HTML, CSS and JS at deploy time for smaller pages
• Linting to find accessibility and syntax issues

The result is a perfect Google PageSpeed Insights score in all categories!

Quick Start

Get Started (Local Development)

This repo is a template, so you can click the green "Use this template" button on Github to create your own repo with this code. Then clone your repo locally and follow these steps:

## First fork the project on Github
git clone <your-repo-from-this-template>
cd <your-repo-dir> ## or your fork name if different
npm install
## Create an env file. You'll replace the values in this in later steps.
cp .env.example .env.local
## Run the project locally in dev mode, and launch the browser
npm run dev -- --open

Developer Environment

The repo includes CI scripts designed for GitHub Actions. These confirm you don’t break your build, you use proper code formatting, and code linting and typechecking passes.

You can manually run these scripts yourself; npm run build for the build, npm run format:check to check formatting, npm run lint for the linting, npm run check for typechecking, and npm run test for testing (if you add tests).

If you're using VSCode, go to the extensions tab and install the recommended extensions. Those should be:

• Svelte for Svelte and accessibility issues: VSCode or other editors
• ESLint for type checking and linting: VSCode and other editors
• Vitest for testing if you add tests: VSCode or other editors

To catch build, formatting, linting and test issues before you commit changes, we suggest the following local git hook. It will run before you commit, stop you from breaking the build, and show any issues that are found. Add the lines below to an executable git hook script at the location .git/hooks/pre-commit.

#!/bin/sh
set -e
npm run format:check
npm run lint
npm run build
npm run check
npm run test

Finally: if you find build, formatting or linting rules too tedious, you can disable enforcement by deleting the CI files (.github/workflows/*) and remove the git hook (.git/hooks/pre-commit).

Setup Supabase

Local Development

This repo is ready to run locally with Supabase CLI. Supabase CLI is installed locally after running npm install above.

Having Docker Desktop installed is the only prerequisite for using Supabase CLI. Make sure Docker Desktop is running before running the commands below.

To start Supabase locally run:

npx supabase start

"This takes time on your first run because the CLI needs to download the Docker images to your local machine. The CLI includes the entire Supabase toolset, and a few additional images that are useful for local development (like a local SMTP server and a database diff tool)." [1]

[1] https://supabase.com/docs/guides/cli/getting-started?queryGroups=platform&platform=npm#running-supabase-locally

Now you can access your local Supabase Studio dashboard at http://localhost:54323.

At the end of the starting process, Supabase CLI will output values you'll need to set in your .env.local file for local development. You can also print this information at any time by running npx supabase status.

npx supabase status -o env --override-name api.url="PUBLIC_SUPABASE_URL" --override-name auth.anon_key="PUBLIC_SUPABASE_ANON_KEY" --override-name auth.service_role_key="PRIVATE_SUPABASE_SERVICE_ROLE"

See /supabase/config.toml for the local Supabase configuration. Here is a list of settings you'll probably want to change in the default configuration:

• project_id
• auth.external.<providers_you_want_to_support>

As a next step, you'll apply the initial database migration to your local Supabase instance:

npx supabase db reset

Going to Production

To start you'll need at least a free Supabase account and a Supabase project created for your app.

After you have your account, you can login with the CLI:

npx supabase login

Follow the instructions from the CLI to authenticate with your Supabase account.

Next, you can proceed to link your local Supabase project to your hosted Supabase project. This will allow you to deploy your local database schema to your hosted project.

npx supabase link

Follow the instructions from the CLI to link your local project to your hosted project.

Finally, you can deploy your local database schema to your hosted project.

npx supabase db push

Setup Stripe Billing

• Create a Stripe account
• Create a product and price Tiers
  • Create your products and their prices in the Dashboard or with the Stripe CLI.
  • SaaS Starter works best if you define each tier as a separate product (eg, SaaS Starter Free, Saas Starter Pro, Saas Starter Enterprise). Include a monthly and annual price for each product if you want to support multiple billing periods.
  • You do not need to create a free plan in Stripe. The free plan is managed within the app.
• Setup your environment
  • Get your Secret API key, and add it as an environment variable PRIVATE_STRIPE_API_KEY (.env.local locally, and Cloudflare environment for prod). Be sure to use test keys for development, and keep your production/live keys secret and secure.
• Optional: theme your Stripe integration
  • Change the colors and fonts to match your brand here
• Update your pricing plan data to align to your stripe data
  • See /src/routes/(marketing)/pricing/pricing.js and Fill in all fields for each plan. stripe_price_id and stripe_product_id should only be omitted on a single “free” plan. Multiple free plans are not supported.
    • The product in Stripe can contain several prices for the same product (annual, monthly, etc). The stripe_price_id you choose to put in this json will be the default we use for the checkout experience. However, if you have more prices configured for a product configured, the user can switch between them in the management portal.
  • Set the defaultPlanId to the plan the user will see as their “current plan” after signup, but before subscribing to a paid plan (typically “free”). It should align to the plan with no stripe_price_id.
  • if you want an item highlighted on /pricing, specify that plan ID in /src/routes/(marketing)/pricing/+page.svelte
• Update your portal configuration
  • Open stripe portal config and make the following changes
    • Disallow editing email under customer information (since we allow editing in primary portal)
    • Optional: setup a custom domain so Stripe pages use your own domain
• Repeat steps in production environment

Deploy To Cloudflare

Cloudflare Pages and Workers is one of the most popular options for deploying SvelteKit and we recommend it. Follow Cloudflare’s instructions to deploy in a few clicks. Be sure to select “SvelteKit” as framework, and the rest of the defaults will work.

When prompted: add environment variables for your production environment (PUBLIC_SUPABASE_URL, PUBLIC_SUPABASE_ANON_KEY, PRIVATE_SUPABASE_SERVICE_ROLE, and PRIVATE_STRIPE_API_KEY).

Optional: enable Cloudflare Analytics for usage metrics.

If you prefer another host you can explore alternatives:

• SvelteKit official adapters including Netlify, Vercel, and Node
• Community adapters including Github pages, AppEngine, Azure, and more
• Supabase if you want one host for everything. Note: they do charge $10 a month for custom domains, unlike Cloudflare.

Add your content!

After the steps above, you’ll have a working version like the demo page. However, it’s not branded, and doesn’t have your content. The following checklist helps you customize the template to make a SaaS homepage for your company.

• Set a name for your site in src/config.ts:WebsiteName
• Content
  • Add actual content for marketing homepage
  • Add any pages you want on top of our boiler plate (about, terms of service, etc). Be sure to add links to them in the header, mobile menu header, and footer as appropriate (src/routes/(marketing)/+layout.svelte).
  • Note: if you add any dynamic content to the main marketing page or pricing page, be sure to set prerender = false in the appropriate +page.ts file. These are currently pre-rendered and served as static assets for performance reasons, but that will break if you add server side rendering requirements.
• Update SEO content
  • Update title and meta description tags for every public page. We include generic ones using your site name (src/config.ts:WebsiteName), but the more specific these are the better.
• Style
  • Create a new shadcn-svelte theme matching your brand (see src/app.css)
  • Update the marketing page layout src/routes/(marketing)/+layout.svelte: customize design, delete unwanted pages from header and footer
  • Style: make it your own look and feel.
  • Update the favicon in the /static/ directory
• Functionality
  • Add actual SaaS functionality!
  • Replace the admin dashboard with real content (/src/routes/(app)/dasboard/+page.svelte).
  • Add API endpoints and database tables as needed to deliver your SaaS product.

Icons

Homescreen Icons are from Solar Broken Line Icons and Solar Linear Icons via CC Attribution License.

Sponsor

We hope you enjoy SaaS Starter! If you build mobile apps, please check out its sponsor/creator, Critical Moments. We can help improve your mobile app conversions, improve your app rating, and mitigate major bugs and outages.