Git Product home page Git Product logo

paulgrunt / saas-starter-kit Goto Github PK

View Code? Open in Web Editor NEW

This project forked from boxyhq/saas-starter-kit

0.0 0.0 0.0 5.86 MB

๐Ÿ”ฅ Enterprise SaaS Starter Kit - Kickstart your enterprise app development with the Next.js SaaS boilerplate ๐Ÿš€

Home Page: https://boxyhq.com/blog/enterprise-ready-saas-starter-kit

License: Apache License 2.0

JavaScript 2.67% TypeScript 97.11% CSS 0.22% Procfile 0.01%

saas-starter-kit's Introduction

BoxyHQ Banner

โญ Enterprise SaaS Starter Kit

Github stargazers Github issues license Twitter LinkedIn Discord

The Open Source Next.js SaaS boilerplate for Enterprise SaaS app development.

Please star โญ the repo if you want us to continue developing and improving the SaaS Starter Kit! ๐Ÿ˜€

๐Ÿ“– Additional Resources

Video - BoxyHQ's SaaS Starter Kit: Your Ultimate Enterprise-Compliant Boilerplate
Blog - Enterprise-ready Saas Starter Kit

Next.js-based SaaS starter kit saves you months of development by starting you off with all the features that are the same in every product, so you can focus on what makes your app unique.

๐Ÿ› ๏ธ Built With

๐Ÿš€ Deployment

Deploy with Vercel Deploy to Heroku Deploy to DO

โœจ Getting Started

Please follow these simple steps to get a local copy up and running.

Prerequisites

  • Node.js (Version: >=18.x)
  • PostgreSQL
  • NPM
  • Docker compose

Development

1. Setup

  • Fork the repository
  • Clone the repository by using this command:
git clone https://github.com/<your_github_username>/saas-starter-kit.git

2. Go to the project folder

cd saas-starter-kit

3. Install dependencies

npm install

4. Set up your .env file

Duplicate .env.example to .env.

cp .env.example .env

5. Create a database (Optional)

To make the process of installing dependencies easier, we offer a docker-compose.yml with a Postgres container.

docker-compose up -d

6. Set up database schema

npx prisma db push

7. Start the server

In a development environment:

npm run dev

8. Start the Prisma Studio

Prisma Studio is a visual editor for the data in your database.

npx prisma studio

9. Testing

We are using Playwright to execute E2E tests. Add all tests inside the /tests folder.

Update playwright.config.ts to change the playwright configuration.

Install Playwright dependencies
npm run playwright:update
Run E2E tests
npm run test:e2e

Note: HTML test report is generated inside the report folder. Currently supported browsers for test execution chromium and firefox

Fully customizable boilerplate out of the box, see images below ๐Ÿ‘‡๐Ÿ‘‡๐Ÿ‘‡

saas-starter-kit-poster

๐Ÿฅ‡ Features

  • Create account
  • Sign in with Email and Password
  • Sign in with Magic Link
  • Sign in with SAML SSO
  • Sign in with Google [Setting up Google OAuth]
  • Sign in with GitHub [Creating a Github OAuth App]
  • Directory Sync (SCIM)
  • Update account
  • Create team
  • Invite users to the team
  • Manage team members
  • Update team settings
  • Webhooks & Events
  • Internationalization
  • Audit logs
  • Roles and Permissions
  • Dark mode

โžก๏ธ Coming Soon

  • Billing & subscriptions
  • Unit and integration tests

โœจ Contributing

Thanks for taking the time to contribute! Contributions make the open-source community a fantastic place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Please try to create bug reports that are:

  • Reproducible. Include steps to reproduce the problem.
  • Specific. Include as much detail as possible: which version, what environment, etc.
  • Unique. Do not duplicate existing opened issues.
  • Scoped to a Single Bug. One bug per report.

Contributing Guide

๐Ÿคฉ Community

  • Discord (For live discussion with the Open-Source Community and BoxyHQ team)
  • Twitter / LinkedIn (Follow us)
  • Youtube (Watch community events and tutorials)
  • GitHub Issues (Contributions, report issues, and product ideas)

๐ŸŒ Contributors

Made with contrib.rocks.

๐Ÿ›ก๏ธ License

Apache 2.0 License

saas-starter-kit's People

Contributors

dependabot[bot] avatar deepakprabhakara avatar devkiran avatar niwsa avatar saptarshee94 avatar nathantarbert avatar snyk-bot avatar g3root avatar cristuker avatar ukrocks007 avatar shartrooper avatar emmacode avatar rohitmondal03 avatar yacineahmaich avatar kkumar-gcc avatar shubhamsingh-s34 avatar belkhoujaons avatar jatingodnani avatar aniruddhagawali avatar dhoni77 avatar young-einstein10 avatar kunal144 avatar kiran-alex avatar gitstart-boxyhq avatar vivekboii avatar vrmartins avatar steven-tey avatar shreyas0924 avatar shiva-sai-ssb avatar m5r avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.