Skip to content

An example repo for a saas website that includes auth, subscriptions, emails, storybook, e2e testing + more

Notifications You must be signed in to change notification settings

kcoulsy/saas-starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TeamApp

This is an app bootstrapped according to the init.tips stack, also known as the T3-Stack.

Lint Test Build E2E CodeQL Vercel
Statements Branches Functions Lines
Statements Branches Functions Lines

Node Version

This project uses node 20.x and npm 10.x. It is recommended to use nvm to set your environment to these specific versions.

Project Setup

  1. Clone the repo
  2. Copy .env.example to .env and add appropriate variables
  3. npm i
  4. npm run dev

Sentry

You will need to setup a sentry project and add the follow secrets to github at https://github.com/[your org]/[your repo]/settings/secrets/actions

Add the 3 secrets

SENTRY_PROJECT
SENTRY_ORG
SENTRY_AUTH_TOKEN

You will need to create an auth token at https://[sentry org].sentry.io/settings/auth-tokens/ The project is the name of the project, not the project id. By default it will be something like javascript-nextjs

You will also need to add SENTRY_DSN and SENTRY_AUTH_TOKEN to your env file.

Storybook

You can view the projects storybook on chromatic by Clicking this link

What integrations do I need to setup

Database

This web app uses a postgres db - we suggest you spin one up at railway. And set the provided url in your .env as DATABASE_URL

Axiom

Axiom is integrated through vercel. Add the integration here - it will automatically set the .env value for the deployment.

Chromatic

The storybook stories are linked on chromatic. To publish to chromatic locally you need the .env key CHROMATIC_PROJECT_TOKEN

How do I deploy this?

Vercel

We recommend deploying to Vercel. It makes it super easy to deploy NextJs apps.

  • Push your code to a GitHub repository.
  • Go to Vercel and sign up with GitHub.
  • Create a Project and import the repository you pushed your code to.
  • Add your environment variables.
  • Click Deploy
  • Now whenever you push a change to your repository, Vercel will automatically redeploy your website!

Useful resources

Here are some resources that we commonly refer to:

About

An example repo for a saas website that includes auth, subscriptions, emails, storybook, e2e testing + more

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published