README.md

Demo & Homepage • Quick Start Guide • Issues

SaaS Starter: A SvelteKit Boilerplate/Template

• Feature Rich: user auth, user dashboard, marketing site, blog engine, billing/subscriptions, pricing page, search, emails, 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, DaisyUI, 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
• Fully Functional Demo
• Quick Start: Full docs from git clone to deployment.

Created by the folks at Critical Moments! Check out our website site for an example deployment of SaaS Starter.

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

Demo

You can explore all the features using our fully functional demo saasstarter.work.

See criticalmoments.io for an example of what’s possible after this template has design, content, and functionality added.

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. GDPR cookie warning for European users.
• Marketing Page with SEO optimization
• Blog engine with rich formatting, RSS and SEO optimization.
• User Dashboard with user profile, user settings, update email/password, billing, and more
• Subscriptions powered by Stripe Checkout
• Pricing page
• Emails: send emails to users, including template support
• Search: lightning fast site search, without a backend
• 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.

Introduction Blog Post

What to learn why we picked the technologies we did, and how to keep your fork lightning fast as you add content? Check out our blog post on the process. Yes, it's hosted on a SaaS Starter fork!

Tech Stack

• Web Framework: SvelteKit
• CSS / Styling
  • Framework: TailwindCSS
  • Component library: DaisyUI
• 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, pricing and blog
• 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

Create a Copy of the Template

To get started, create your own copy of the project for development. There are two options:

• "Use this template": use this Github button if you want to build your own project using CMSaasStarter as a starter template and you aren't planning on contributing work back to the public open source project. See Github Docs.
• "Fork": use this button if you want contribute some or all of your work back to the public open source project. It will keep the full commit history, and be easier to create PRs back to CMSaasStarter.

Setup Local Development

On your development machine:

git pull [Your Repo Created Above]
cd CMSaasStarter ## or your repo name if different
npm install
## Create an env file. You'll replace the values in this in later steps.
cp local_env_template .env.local
## Run the project locally in dev mode, and launch the browser
npm run dev -- --open

Note: some features won't work until you complete the rest of the setup steps below!

Developer Tools

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. Github disables CI on new repos by default, so be sure to go into the Github Actions page for your repo and enable workflows.

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).

Installing extensions in your editor can automatically format-on-save, show linting/type issues inline, and run your test cases:

• 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_run

# Optional: check for misspelled words. Uncomment line below after installing misspell tool https://github.com/client9/misspell?tab=readme-ov-file#install
# misspell -error ./src README.md

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 Project

• Create a Supabase account
• Create a new Supabase project in the console
• Wait for the database to launch
• Create your user management tables in the database
  • Go to the SQL Editor page in the Dashboard.
  • Paste the SQL from database_migration.sql in this repo to create your user/profiles table and click run.
• Enable user signups in the Supabase console: sometimes new signups are disabled by default in Supabase projects
• Go to the API Settings page in the Dashboard. Find your Project-URL (PUBLIC_SUPABASE_URL), anon (PUBLIC_SUPABASE_ANON_KEY) and service_role (PRIVATE_SUPABASE_SERVICE_ROLE).
  • For local development: create a .env.local file:

    PUBLIC_SUPABASE_URL=https://your-project.supabase.co
    PUBLIC_SUPABASE_ANON_KEY=your-anon-key
    PRIVATE_SUPABASE_SERVICE_ROLE=your service_role secret
    

  • For production, add these two keys to your deployment environment (see below). We suggest you encrypt your service role.
• Auth Callback
  • Set your default callback URL for auth in the Supabase Auth console. For example, for the demo page we added: https://saasstarter.work/auth/callback . Also add that same URL to the the “allowed redirect URL” list in the Supabase auth console further down the page.
  • Add a link to the redirect URL allow list which allows parameters to your auth callback. For example we added the following for the demo page: https://saasstarter.work/auth/callback?*
  • Also add any local development URLs you want to use in testing to the list for your dev environment. For example, we added the following for local development: http://localhost:5173/auth/callback and http://localhost:5173/auth/callback?*.
  • Test that the "sign up" and "forgot password" emails link back to your domain correctly by checking the have a redirect_to parameter to your yourdomain.com/auth/callback. If they link to the base URL or another page, double check you have the config above set correctly.
• OAuth Logins
  • Decide which oauth logins you want to support, and set them up in the Supabase Auth console under “Auth Providers”. Be sure to provide them the Supabase callback URL. Also be sure to set any platform specific permissions/settings to retrieve their email as part of the login (for example, for Github it's under Account Permissions > Email Address > Read Only Access
  • Edit oauthProviders list in /src/routes/(marketing)/login/login_conf.ts with the list of providers you chose. If you don’t want any OAuth options, make this an empty array.
  • Test each provider to ensure you setup the client ID, client secret and callback correctly for each
• Auth Email SMTP
  • Supabase has a limit of 4 emails per hour on their development server. You should Configure a Custom SMTP sending emails from your own domain.
  • Customize the email templates in the Supabase Auth console to include your product name and branding
• Test authentication
  • Open the /login page in your browser, and ensure you can sign up, confirm email, log in, and edit your account.

Setup Stripe

• 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_plans.ts 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

We have two documented options for deploying SaaS Starter: Cloudflare Pages and Vercel. However, it can be hosted anywhere you can host a SvelteKit app.

Our official demo is hosted on Cloudflare Pages, and deployed each time the main branch is updated.

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.

Deploy to Vercel

Deploy using Vercel's deploy button:

Here is a demo of of Saas Starter hosted on Vercel: vercel.saasstarter.work

Deploy Alternatives

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.

Setup Emailer -- Optional

SaaS Starter includes email capabilities for sending emails to users and admins.

These are optional and disabled by default. See email docs for details on how to enable and customize them.

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.

• Describe your site with a name, description and base URL in in src/config.ts:. These values are used for SEO.
• Content
  • Add actual content for marketing homepage
  • Add actual content for your blog (or delete the blog)
    • Update all fields in src/routes/(marketing)/blog/posts.ts, and replace the post pages under src/routes/(marketing)/blog/posts to align to the urls from posts.ts.
    • Alternatively remove the blog by removing the src/routes/(marketing)/blog directory, and remove any links to the blog in the header and footer. You can always bring it back later.
  • 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, pricing page or blog, 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), but the more specific these are the better.
  • This done automatically for blog posts from posts.ts metadata
• Style
  • Create a new DaisyUI Theme matching your brand or use one of the built in themes from DaisyUI (see tailwind.config.js)
  • 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
  • The Authentication UI should automatically update based on your DaisyUI style, but check out the login in pages, and further design tweaks can be made in src/routes/(marketing)/login/login_config.ts (see Auth UI for options).
• Site Search: any prerendered content will automatically be indexed by the site search. To exclude a page, add it to excludePaths in src/lib/build_index.ts.
• Functionality
  • Add actual SaaS functionality!
  • Replace the admin dashboard with real content (/src/routes/(admin)/account/+page.svelte).
  • Add API endpoints and database tables as needed to deliver your SaaS product.

Community Extensions

The open source community is extending and improving SaasStarter!

These extensions are reference implementations of commonly needed features. We don't integrate them into the main branch to keep our dependencies minimal and simplify maintenance. However, if you need them you can cherry pick into your fork/repo:

• Internationalization: branch, and instructions
• Dark mode theme: branch, and instructions

Icons Credits

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.