Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/saasfly/saasfly

Your Next SaaS Template or Boilerplate ! A magic trip start with `bun create saasfly` . The more stars, the more surprises
https://github.com/saasfly/saasfly

bun enterprise-boilerplate i18n kysely landingpage monorepo nextauth nextjs14 postgresql prisma saas-boilerplate serverless shadcn shadn-ui stripe tailwindcss turborepo typescript vercel zustand

Last synced: 28 days ago
JSON representation

Your Next SaaS Template or Boilerplate ! A magic trip start with `bun create saasfly` . The more stars, the more surprises

Awesome Lists containing this project

README

        



# Saasfly
saasfly%2Fsaasfly | Trendshift

[![GitHub Actions Workflow Status][check-workflow-badge]][check-workflow-badge-link] [![GitHub License][github-license-badge]][github-license-badge-link] [![Discord][discord-badge]][discord-badge-link] [![Saasfly][made-by-nextify-badge]][made-by-nextify-badge-link]
[![Chinese](https://img.shields.io/badge/-Chinese-red.svg)](README_zh.md)
[![German](https://img.shields.io/badge/-German-yellow.svg)](README_de.md)
[![Vietnamese](https://img.shields.io/badge/-Vietnamese-yellow.svg)](README_vi.md)
![COMMIT_ACTIVITY](https://img.shields.io/github/commit-activity/m/saasfly/saasfly?style=for-the-badge">)
[![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Fsaasfly%2Fsaasfly&labelColor=%23f47373&countColor=%23263759)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Fsaasfly%2Fsaasfly)

An easy-to-use and enterprise-grade Next.js boilerplate.

You don't need to buy templates anymore; Saasfly provides a complete, open-source solution for building SaaS applications quickly and easily.

> **[Nextify](https://nextify.ltd)** provides a complete Enterprise SaaS solution. Contact us at [[email protected]](mailto:[email protected]) if you're interested in discussing your project, or if you'd simply like to have a conversation with us, please feel free to reach out.

> โค๏ธ We provide **free technical support and deployment services to non-profit organizations**.
>
> ๐Ÿ™Œ All profits obtained from our open source projects will be **entirely dedicated to supporting open source initiatives and charitable causes**.

## โšก Live Demo

Try it out for yourself!

Demo Server (Location: Washington - USA):

See more documentation at

## ๐ŸŒŸ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=saasfly/saasfly&type=Timeline)](https://star-history.com/#saasfly/saasfly&Timeline)

## Sponsors





Take Control of All Your Twitter Assets






Add your logo here


## ๐Ÿš€ Getting Started

### ๐Ÿ–ฑ One Click Template

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fsaasfly%2Fsaasfly&env=NEXT_PUBLIC_APP_URL,NEXTAUTH_URL,NEXTAUTH_SECRET,STRIPE_API_KEY,STRIPE_WEBHOOK_SECRET,POSTGRES_URL,GITHUB_CLIENT_ID,GITHUB_CLIENT_SECRET,RESEND_API_KEY,RESEND_FROM&install-command=bun%20install&build-command=bun%20run%20build&root-directory=apps%2Fnextjs)

### ๐Ÿ“‹ Prerequisites

Before you start, make sure you have the following installed:

1. [Bun](https://bun.sh/) & [Node.js](https://nodejs.org/) & [Git](https://git-scm.com/)

1. Linux

```bash
curl -sL https://gist.github.com/tianzx/874662fb204d32390bc2f2e9e4d2df0a/raw -o ~/downloaded_script.sh && chmod +x ~/downloaded_script.sh && source ~/downloaded_script.sh
```

2. MacOS

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git
brew install oven-sh/bun/bun
brew install nvm
```

2. [PostgreSQL](https://www.postgresql.org/)
1. You can use Vercel Postgres or a local PostgreSQL server(add POSTGRES_URL env in .env.local)
```bash
POSTGRES_URL = ''
```

### Installation

To get started with this boilerplate, we offer two options:

1. Use the `bun create` command(๐ŸŒŸStrongly recommend๐ŸŒŸ):

```bash
bun create saasfly
```

2. Manually clone the repository:

```bash
git clone https://github.com/saasfly/saasfly.git
cd saasfly
bun install
```

### Setup

Follow these steps to set up your project:

1. Set up the environment variables:

```bash
cp .env.example .env.local
// (you must have a database prepared before running this command)
bun db:push
```

2. Run the development server:

```bash
bun run dev:web
```

3. Open [http://localhost:3000](http://localhost:3000) in your browser to see the result.

4. (Optional alpha)`bun run tailwind-config-viewer` Open [http://localhost:3333](http://localhost:3333) in your browser to see your Tailwind CSS configuration

## ๐Ÿฅบ Project Roadmap

1. Admin Dashboard Page (in alpha !!!)
2. only provide static page now and we plan to integrate with headless arch
3. You can provide your admin account and change **ADMIN_EMAIL="[email protected],[email protected]"** in .env.local and access host:port/admin/dashboard
4. Based on security concerns, we will not provide online demos for the time being.
2. Consider integrating Payload CMS.

## โญ Features

### ๐Ÿญ Frameworks

- **[Next.js](https://nextjs.org/)** - The React Framework for the Web (with **App Directory**)
- **[NextAuth.js](https://next-auth.js.org/)** - Authentication for Next.js
- **[Kysely](https://kysely.dev/)** - The type-safe SQL query builder for TypeScript
- **[Prisma](https://www.prisma.io/)** - Next-generation ORM for Node.js and TypeScript, used as a schema management tool
- **[React-email](https://react.email/)** - A React renderer for creating beautiful emails using React components

### ๐Ÿฎ Platforms

- **[Vercel](https://vercel.com/)** โ€“ Deploy your Next.js app with ease
- **[Stripe](https://stripe.com/)** โ€“ Payment processing for internet businesses
- **[Resend](https://resend.com/)** โ€“ Email marketing platform for developers

### ๐Ÿฏ Enterprise Features

- **[i18n](https://nextjs.org/docs/app/building-your-application/routing/internationalization)** - Support for internationalization
- **[SEO](https://nextjs.org/docs/app/building-your-application/optimizing/metadata)** - Search engine optimization
- **[MonoRepo](https://turbo.build/)** - Monorepo for better code management
- **[T3 Env](https://env.t3.gg/)** - Manage your environment variables with ease

### ๐Ÿฐ Data Fetching

- **[trpc](https://trpc.io/)** โ€“ End-to-end typesafe APIs made easy
- **[tanstack/react-query](https://react-query.tanstack.com/)** โ€“ Hooks for fetching, caching and updating asynchronous data in React

### ๐Ÿฒ Global State Management

- **[Zustand](https://zustand.surge.sh/)** โ€“ Small, fast and scalable state management for React

### ๐Ÿ’ UI

- **[Tailwind CSS](https://tailwindcss.com/)** โ€“ Utility-first CSS framework for rapid UI development
- **[Shadcn/ui](https://ui.shadcn.com/)** โ€“ Re-usable components built using Radix UI and Tailwind CSS
- **[Framer Motion](https://framer.com/motion)** โ€“ Motion library for React to animate components with ease
- **[Lucide](https://lucide.dev/)** โ€“ Beautifully simple, pixel-perfect icons
- **[next/font](https://nextjs.org/docs/basic-features/font-optimization)** โ€“ Optimize custom fonts and remove external network requests for improved performance

### ๐Ÿด Code Quality

- **[TypeScript](https://www.typescriptlang.org/)** โ€“ Static type checker for end-to-end type safety
- **[Prettier](https://prettier.io/)** โ€“ Opinionated code formatter for consistent code style
- **[ESLint](https://eslint.org/)** โ€“ Pluggable linter for Next.js and TypeScript
- **[Husky](https://typicode.github.io/husky)** โ€“ Git hooks made easy

### ๐Ÿ‘ Performance

- **[Vercel Analytics](https://vercel.com/analytics)** โ€“ Real-time performance metrics for your Next.js app
- **[bun.sh](https://bun.sh/)** โ€“ npm alternative for faster and more reliable package management

### ๐Ÿ˜ Database

- **[PostgreSQL](https://www.postgresql.org/)** โ€“ The world's most advanced open source database

## ๐Ÿ“ฆ Apps and Packages

- `web`: The main Next.js application
- `ui`: Shared UI components
- `db`: Database schema and utilities
- `auth`: Authentication utilities
- `email`: Email templates and utilities

## ๐Ÿ“œ License

This project is licensed under the MIT License. For more information, see the [LICENSE](./LICENSE) file.

## ๐Ÿ™ Credits

This project was inspired by shadcn's [Taxonomy](https://github.com/shadcn-ui/taxonomy) and t3-oss's [create-t3-turbo](https://github.com/t3-oss/create-t3-turbo).

## ๐Ÿ‘จโ€๐Ÿ’ป Contributors



Made with [contrib.rocks](https://contrib.rocks).

[check-workflow-badge]: https://img.shields.io/github/actions/workflow/status/saasfly/saasfly/ci.yml?label=ci
[github-license-badge]: https://img.shields.io/badge/License-MIT-green.svg
[discord-badge]: https://img.shields.io/discord/1204690198382911488?color=7b8dcd&link=https%3A%2F%2Fsaasfly.io%2Fdiscord
[made-by-nextify-badge]: https://img.shields.io/badge/made_by-nextify-blue?color=FF782B&link=https://nextify.ltd/

[check-workflow-badge-link]: https://github.com/saasfly/saasfly/actions/workflows/check.yml
[github-license-badge-link]: https://github.com/saasfly/saasfly/blob/main/LICENSE
[discord-badge-link]: https://discord.gg/8SwSX43wnD
[made-by-nextify-badge-link]: https://nextify.ltd