{"id":13406078,"url":"https://github.com/apptension/saas-boilerplate","last_synced_at":"2025-05-14T01:10:37.984Z","repository":{"id":38770873,"uuid":"255566762","full_name":"apptension/saas-boilerplate","owner":"apptension","description":"SaaS Boilerplate - Open Source and free SaaS stack that lets you build SaaS products faster in React, Django and AWS. Focus on essential business logic instead of coding repeatable features!","archived":false,"fork":false,"pushed_at":"2024-09-27T11:29:33.000Z","size":22758,"stargazers_count":2224,"open_issues_count":41,"forks_count":265,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-10-29T15:19:14.491Z","etag":null,"topics":["aws","aws-esc","backend","boilerplate","business","cdk","django","docker","frontend","hacktoberfest","pipeline","product","python","react","saas","serverless","stack","typescript","vitejs","workers"],"latest_commit_sha":null,"homepage":"https://apptension.com/saas-boilerplate","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apptension.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-14T09:31:26.000Z","updated_at":"2024-10-29T13:44:22.000Z","dependencies_parsed_at":"2023-09-29T11:05:37.859Z","dependency_job_id":"628157e3-6457-482b-b428-4394524d5c41","html_url":"https://github.com/apptension/saas-boilerplate","commit_stats":{"total_commits":951,"total_committers":48,"mean_commits":19.8125,"dds":0.8391167192429022,"last_synced_commit":"7e6d8e10f2b16cf82e576c7b6ef8462c5379d6de"},"previous_names":["apptension/aws-boilerplate"],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apptension%2Fsaas-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apptension%2Fsaas-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apptension%2Fsaas-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apptension%2Fsaas-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apptension","download_url":"https://codeload.github.com/apptension/saas-boilerplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248367125,"owners_count":21092107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-esc","backend","boilerplate","business","cdk","django","docker","frontend","hacktoberfest","pipeline","product","python","react","saas","serverless","stack","typescript","vitejs","workers"],"created_at":"2024-07-30T19:02:20.290Z","updated_at":"2025-04-11T09:21:45.096Z","avatar_url":"https://github.com/apptension.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","business"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./.github/images/saas-bp-logo.png\" alt=\"SaaS Boilerplate powered by Apptension\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eBuild SaaS products faster in React, Django and AWS.\u003c/h1\u003e\n\u003ch2 align=\"center\"\u003eA complete SaaS starter kit based on a battle-tested stack with out-of-the-box features every SaaS should have\u003c/h2\u003e\n\n\u003ch4 align=\"center\"\u003e\n  \u003ca href=\"https://github.com/apptension/saas-boilerplate\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/apptension/saas-boilerplate?style=for-the-badge\" alt=\"Version\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/apptension/saas-boilerplate\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/apptension/saas-boilerplate?style=for-the-badge\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://twitter.com/apptension\"\u003e\n    \u003cimg src=\"https://img.shields.io/twitter/follow/apptension?style=for-the-badge\u0026logo=twitter\" alt=\"Follow Us on Twitter\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://discord.apptension.com\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/1122849885335597088?style=for-the-badge\u0026logo=discord\" alt=\"Chat with us on Discord\"\u003e\n  \u003c/a\u003e\n\u003c/h4\u003e\n\n---\n\n📖 [**SaaS Boilerplate Documentation**](https://docs.demo.saas.apptoku.com/)\n\n🌟 [**SaaS Boilerplate Page**](https://www.apptension.com/saas-boilerplate?utm_source=readme-file\u0026utm_medium=referral\u0026utm_campaign=SaaS%20Boilerplate\u0026utm_term=SaaS%20Boilerplate)\n\n🚀 [**SaaS Boilerplate Demo**](https://app.demo.saas.apptoku.com/)\n\n---\n\nSupercharge your SaaS development with our comprehensive starter kit, designed to accelerate your project and save you\nvaluable time and resources. Our battle-tested boilerplate eliminates the need for extensive configuration and\ndevelopment work, allowing you to focus on innovation from day one.\n\nSaaS Boilerplate includes essential features that every SaaS application requires, such as frontend, backend API, admin\npanel, and workers. With a scalable AWS-based architecture and continuous deployment, you can easily deploy multiple\nenvironments representing different stages in your pipeline.\n\nSay goodbye to weeks of setup and coding. Our proven stack and ready-to-use features empower you to jumpstart your\nproject and prioritize building your product's intellectual property. Unlock your SaaS potential faster than ever before\nand seamlessly transition from setup to innovation.\n\n## Getting started\n\n### Requirements\n\n- Install [Docker](https://docs.docker.com/get-docker)\n- Install [Node.js](https://nodejs.org/en/download/) version 18 or above (which can be checked by running `node -v`).\n  You can use [nvm](https://github.com/nvm-sh/nvm) or [n](https://github.com/tj/n) for managing multiple Node versions installed on a single machine.\n- Install [pnpm](https://pnpm.io/installation) version 9 or above (which can be checked by running `pnpm --version`)\n- (Windows only) Install [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install)\n\n#### Optional\n\n- Install [Python](https://www.python.org/downloads/) version 3.11 (which can be checked by running `python3 --version`) and [PDM](https://github.com/pdm-project/pdm/#installation) version 2.3 or above (which can be checked by running\n  `pdm --version`)\n  - You need this one if you want to run `pdm install` command in `packages/backend` or `packages/workers` outside\n    docker container\n  - You can use [`pyenv`](https://github.com/pyenv/pyenv) for managing multiple Python versions installed on a single machine.\n\n### Fresh installation\n\n#### Setup using CLI starter kit\n\nYou can use a special CLI tool to run a new local instance of the SaaS Boilerplate as soon as possible. It will clone\nthe repository and take care of setting up the environment. Run the following command in the directory where you would\nlike to create a new project:\n\n**_Using `npm`:_**\n\n```bash\nnpm init saas-boilerplate PATH\n```\n\n**_Using `pnpm`:_**\n\n```bash\npnpm create saas-boilerplate PATH\n```\n\n**_Using `yarn`:_**\n\n```bash\nyarn create saas-boilerplate PATH\n```\n\n\u003e :information_source: Where `PATH` is a directory name where to initialize project.\n\u003e\n\u003e :warning: **The init directory needs to be empty!**\n\n#### Manual setup\n\nFor the manual setup clone this repository and follow the steps in\n[Getting started guide](https://docs.demo.saas.apptoku.com/getting-started/run-project/run-new-project#manual-setup).\n\n### Run existing project\n\n\u003e :warning: **If you are using a Windows machine**, it's mandatory to have **WSL 2** (Windows Subsystem for Linux)\n\u003e installed on your system to run the commands for installing dependencies and running the application.\n\n#### Install dependencies\n\nThe project is configured to use pnpm workspaces, which means that you can install `node_modules` of all packages in\nrepository, with single command:\n\n```sh\npnpm install\n```\n\n### Start the app\n\nStart both: backend and webapp\n\n```sh\npnpm saas up\n```\n\n#### Start backend\n\n```sh\npnpm saas backend up\n```\n\n#### Start webapp\n\n```sh\npnpm saas webapp up\n```\n\n#### Local documentation\n\nIn order to run your local documentation server execute following command:\n\n```sh\npnpm saas docs up\n```\n\n## Features\n\n\u003cdetails open\u003e\n\u003csummary\u003e\nThis boilerplate includes plenty of ready to use features that you can adjust to you needs:\n\u003c/summary\u003e \u003cbr /\u003e\n\n  \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/auth\"\u003e\n    \u003cimg src=\"./.github/images/features/auth.png\" alt=\"Authentication and authorization\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003cdetails open\u003e\n    \u003csummary\u003e\n      \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/auth\"\u003eAuthentication and authorization\u003c/a\u003e\n    \u003c/summary\u003e\u003cbr/\u003e\n    \u003cul\u003e\n      \u003cli\u003eUser registration and login, including Facebook and Google OAuth\u003c/li\u003e\n      \u003cli\u003eBasic user data like name, surname, and user role for authorization\u003c/li\u003e\n      \u003cli\u003eUser email address verification via a transactional email\u003c/li\u003e\n      \u003cli\u003ePassword change and password recovery within the app flow\u003c/li\u003e\n      \u003cli\u003eUser management panel in Django admin\u003c/li\u003e\n      \u003cli\u003eTwo-factor authentication\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\n  \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/emails\"\u003e\n    \u003cimg src=\"./.github/images/features/emails.png\" alt=\"Emails\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003cdetails open\u003e\n    \u003csummary\u003e\n      \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/emails\"\u003eEmails\u003c/a\u003e\n    \u003c/summary\u003e\u003cbr/\u003e\n    \u003cul\u003e\n      \u003cli\u003eA set of ready-to-send transactional emails (new user verification, password recovery, subscription renewals, errors, etc.)\u003c/li\u003e\n      \u003cli\u003eAbility to schedule emails at a given time\u003c/li\u003e\n      \u003cli\u003eSending test emails directly from a Storybook\u003c/li\u003e\n      \u003cli\u003eInternationalization support out of the box\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\n  \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/payments\"\u003e\n    \u003cimg src=\"./.github/images/features/payments.png\" alt=\"Payments\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003cdetails open\u003e\n    \u003csummary\u003e\n      \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/payments\"\u003ePayments\u003c/a\u003e\n    \u003c/summary\u003e\u003cbr/\u003e\n    \u003cul\u003e\n      \u003cli\u003eIntegration with Stripe services and its dashboard\u003c/li\u003e\n      \u003cli\u003eNo customer payment method data is stored locally\u003c/li\u003e\n      \u003cli\u003eSupport for multiple payment methods and their management (storing for future use and removal)\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\n  \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/payments#subscription-management\"\u003e\n    \u003cimg src=\"./.github/images/features/subscriptions.png\" alt=\"Subscriptions\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003cdetails open\u003e\n    \u003csummary\u003e\n      \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/payments#subscription-management\"\u003eSubscriptions\u003c/a\u003e\n    \u003c/summary\u003e\u003cbr/\u003e\n    \u003cul\u003e\n      \u003cli\u003eAbility to charge users immediately or to set up recurring payments\u003c/li\u003e\n      \u003cli\u003eSubscription plans support and ability to freely modify current plans\u003c/li\u003e\n      \u003cli\u003eFree trial subscription plan, a grace period for credit card issues\u003c/li\u003e\n      \u003cli\u003eSuperadmin panel enables customer management (i.e. refunds) without the Stripe dashboard\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\n  \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/multi-tenancy\"\u003e\n    \u003cimg src=\"./.github/images/features/multitenancy.png\" alt=\"Multi-tenancy\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003cdetails open\u003e\n    \u003csummary\u003e\n      \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/multi-tenancy\"\u003eMulti-tenancy\u003c/a\u003e\n    \u003c/summary\u003e\u003cbr/\u003e\n    \u003cul\u003e\n      \u003cli\u003eStart immediately with a default tenant provided upon account creation\u003c/li\u003e\n      \u003cli\u003eAdd new tenants as needed to manage multiple entities within a single account\u003c/li\u003e\n      \u003cli\u003eUtilize three default roles ”Owner, Admin, and Member” to control tenant activities and collaboration\u003c/li\u003e\n      \u003cli\u003eSecurely invite and manage new members within each tenant\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\n  \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/cms\"\u003e\n    \u003cimg src=\"./.github/images/features/cms.png\" alt=\"CMS integration (Contentful)\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003cdetails open\u003e\n    \u003csummary\u003e\n      \u003ca href=\"https://docs.demo.saas.apptoku.com/introduction/features/cms\"\u003eCMS integration \u0026#40;Contentful\u0026#41;\u003c/a\u003e\n    \u003c/summary\u003e\u003cbr/\u003e\n    \u003cul\u003e\n      \u003cli\u003eIntegration with Contentful service\u003c/li\u003e\n      \u003cli\u003eExample content model (image, title, and description)\u003c/li\u003e\n      \u003cli\u003eReady to use CMS with a free plan\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\n---\n\n\u003c/details\u003e\n\n... and more\n\nThe full list with the descriptions can be found in the [features documentation](https://docs.demo.saas.apptoku.com/introduction/features/).\n\n## Tech stack\n\nFront-end stack:\n\n- [React](https://github.com/facebook/react)\n- [GraphQL](https://graphql.org/)\n- [Apollo Client](https://github.com/apollographql/apollo-client)\n- [tailwindcss](https://github.com/tailwindlabs/tailwindcss)\n- [shadcn/ui](https://github.com/shadcn-ui/ui)\n- [styled-components](https://github.com/styled-components/styled-components) (optional)\n- [jest](https://github.com/jestjs/jest)\n- [Storybook](https://github.com/storybookjs/storybook)\n- [Vite](https://github.com/vitejs/vite)\n\nBack-end stack:\n\n- [Python](https://www.python.org/)\n- [Django](https://github.com/django/django)\n- [Django REST Framework](https://github.com/encode/django-rest-framework)\n- [Graphene Django](https://github.com/graphql-python/graphene)\n- [dj-stripe](https://github.com/dj-stripe/dj-stripe/)\n- [Postgres](https://www.postgresql.org/)\n\nInfrastructure:\n\n- [NX](https://github.com/nrwl/nx)\n- AWS infrastructure written in [AWS CDK](https://github.com/aws/aws-cdk)\n- Github or Bitbucket\n\n3rd party services:\n\n- Stripe\n- Contentful\n- Sentry\n- SonarCloud\n- OpenAI\n\nThe [detailed stack description](https://docs.demo.saas.apptoku.com/introduction/stack-description) is available in the documentation.\n\n## How was the SaaS Boilerplate created?\n\nIn our experience in Apptension, we have built hundreds of web and mobile applications over the years and saw a bunch of standard features. For example, all applications (or at least 99% of them) need a login, email templating, payments and subscriptions, CMS integration, and more.\n\nA broader list of elements that can be implemented in projects in this way was created after building dozens of different types of SaaS products. We analyzed them and noticed many common parts appeared virtually unchanged. So we created SaaS Boilerplate that is the base, and while it requires design or functional customization for a specific SaaS product, it dramatically reduces development time.\n\nThat's why you don't have to start by writing the code for that login or payment function. Instead, you can use off-the-shelf elements in those places and focus on creating the rest of the features unique to the project.\n\nThe development process is ongoing as we continually add new features and improve existing ones. We started with AWS Boilerplate, which evolved into the current SaaS Boilerplate. It originally contained only infrastructure (a configured AWS account) and was a template for the project, which had blanks for the back-end and front-end.\n\nWe saw that it was already a handy and very well-received tool, so the next natural step was to add more elements to it – front-end, back-end, and pack the relevant features that were most often repeated in different projects, including logging, CRUD, payments, integration with content pool, etc.\n\nOur idea was that it shouldn't be just the code itself because SaaS Boilerplate also contains our know-how – because we gathered everything needed for development and around development in one package. So you don't have to think about choosing code formatting, matching different tools and their subsequent configuration, etc. Moreover, such a package is proven and battle-tested – you can just upload it to the cloud and start so-called heavy development.\n\n## Who are we?\n\nWe're [Apptension](https://apptension.com?utm_source=readme-file\u0026utm_medium=referral\u0026utm_campaign=SaaS%20Boilerplate\u0026utm_term=SaaS%20Boilerplate), a team that turns ideas into world-class software using expertise in technology, design, and product management. We work with founders, investors, and creative agencies to help them bring uncommon ideas to the market.\n\nOur partners value our outside-the-box thinking, clear and honest communication, and reliability – even in the most dynamic and time-compressed projects. Among our clients – plenty of early-stage startups, as well as international tech behemoths like Netflix and Uber. We live and breathe tech – and we're darn good at it.\n\nTo bring even more value to our partners, we create bespoke tools (like SaaS Boilerplate), allowing us to shorten time-to-market while avoiding technical debt.\n\n## License\n\nSaaS Boilerplate is licensed under the [MIT License](./LICENSE).\n\n## Contributing to SaaS Boilerplate\n\nWe welcome contributions from anyone interested in improving SaaS Boilerplate. Please keep in mind that this project follows a [Code of Conduct](./CODE_OF_CONDUCT.md) to ensure a welcoming community for all.\n\nFor more detailed information on how to contribute to this project, please refer to our [Contributing Guide](./CONTRIBUTING.md).\n\nIf you have any questions about contributing, please join our [Discord server](https://discord.apptension.com) - we are happy to help you!\n\nThank you for considering contributing to SaaS Boilerplate!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapptension%2Fsaas-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapptension%2Fsaas-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapptension%2Fsaas-boilerplate/lists"}