Demo & Homepage • Quick Start Guide • Issues
- Feature Rich: user auth, user dashboard, marketing site, blog engine, 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, 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.
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.
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
- 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.
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!
- 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
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.
- Pros:
- $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.
- Pros:
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!
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.
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!
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
).
- 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.
- For local development: create a
- 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
andhttp://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.
- Set your default callback URL for auth in the Supabase Auth console. For example, for the demo page we added:
- 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
- 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
- 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.
- Open the
- 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.
- Get your Secret API key, and add it as an environment variable PRIVATE_STRIPE_API_KEY (
- 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
- See
- 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
- Open stripe portal config and make the following changes
- Repeat steps in production environment
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.
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 using Vercel's deploy button:
Here is a demo of of Saas Starter hosted on Vercel: vercel.saasstarter.work
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.
SaaS Starter includes an admin emailer for sending yourself email notifications when important events happen. This let's you monitor your app and respond to users without watching the database.
If you setup the admin emailer, it will email you when users create their profile or the 'Contact Us' form is submitted. You can add additional calls to sendAdminEmail() for any other events you want to monitor.
To setup, set the email address to which admin emails will be sent in the env var PRIVATE_ADMIN_EMAIL
. That's all that's required if you host on Cloudflare Pages! If you host elsewhere, provide email SMTP credientials in your environment variables: PRIVATE_SMTP_HOST
, PRIVATE_SMTP_PORT
, PRIVATE_SMTP_USER
, PRIVATE_SMTP_PASS
. You can use any SMTP providers such as Gmail, Sendgrid, AWS SES, Resend, or Mailgun.
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 undersrc/routes/(marketing)/blog/posts
to align to the urls fromposts.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.
- Update all fields in
- 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
- Update title and meta description tags for every public page. We include generic ones using your site name (
- 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).
- Create a new DaisyUI Theme matching your brand or use one of the built in themes from DaisyUI (see
- 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.
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
Homescreen Icons are from Solar Broken Line Icons and Solar Linear Icons via CC Attribution License.
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.