Next.jsReactSaaSStarter

blc-starter-next-b2c — Next.js SaaS Template

By BlackcurrantLabs

A Next.js-based B2C SaaS starter template integrating Prisma, BetterAuth, and Tailwind, with example implementations including login and registration, multi-role home pages, server-side tables, and form validation.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

01

B2C SaaS foundation integrating Next.js, Prisma, BetterAuth, and BetterAuthUI

02

Built-in SSR landing page with login, registration, account buttons, and redirect after login

03

Provides examples of multiple user types (e.g., Admin, User) and their respective home pages

04

Includes table examples with server-side search, pagination, filtering, and sorting, plus a client-side paginated table example

05

Form examples synchronize server-side and client-side validation schemas and use react-hook-form

06

Comes with AGENTS.md and .agent/rules, targeting AI-assisted coding workflows

Template Details

blc-starter-next-b2c is a B2C SaaS project starter template maintained by BlackcurrantLabs, built with Next.js, using Prisma for data access, BetterAuth and BetterAuthUI for authentication, and Tailwind with Shadcn for styling and components. The template is positioned as a fixed combination of the author team's commonly used tech stack, and the README explicitly states that it may not suit all scenarios.

The template's built-in goals include: an SSR landing page with login, registration, and account buttons; static pages such as privacy policy and terms of use; favicon and robots.txt; multiple user types such as Admin and User with their respective home pages; an extensible authenticated API; page areas that are visible when logged out, visible after login, and visible only after validation via custom attributes (maker/checker model); table examples with server-side search, pagination, filtering, and sorting; a client-side paginated table example; and form examples with synchronized server-side and client-side validation. It also provides a JWT-based mobile API flow and runs long tasks via Trigger.dev with real-time status display on the frontend.

The repository includes AGENTS.md and .agent/rules, and the README states it is compatible with opencode, claude code, and antigravity, targeting so-called vibe code usage. If B2B scenarios are needed (users inviting collaboration within an organization), the README suggests switching to the B2B Starter repository from the same organization.

Runtime requirements are Node.js 22 LTS and pnpm 10.x. You need to copy example.env and fill in environment variables for database, authentication, email, and task queue. The tech stack table also lists Resend for email, Tanstack Tables for tables, react-hook-form for forms, and Context API for frontend state management. Deployment options include Vercel, Railway, or self-hosted AWS.

Next.jsSaaSStarter

Is it right for your project?

Use Cases

  • Starting a B2C SaaS project that requires user registration, login, and multi-role home pages
  • Providing a JWT-based authentication API flow for mobile clients
  • Implementing page areas visible only after login or after validation via custom attributes
  • Building data table pages with server-side search, pagination, filtering, and sorting
  • Running long tasks via Trigger.dev and displaying real-time status on the frontend

Suitable For

  • Developers building B2C SaaS with Next.js and Prisma
  • Teams needing ready-made authentication and multi-user-type examples
  • Projects that want to start with AI-assisted coding and reference AGENTS.md rules
  • Users who accept the author's fixed tech stack combination and do not seek adaptation to all scenarios

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Requires Node.js 22 LTS and pnpm 10.x

  2. 2

    Copy example.env to .env and fill in required variables such as SITE_NAME, DATABASE_URL, BETTER_AUTH_SECRET, RESEND_API_KEY, TRIGGER_SECRET_KEY, and ALTCHA_HMAC_SECRET

  3. 3

    Database-related variables include DATABASE_DIRECT_URL, DATABASE_HOST, DATABASE_PORT, DATABASE_USER, DATABASE_PASSWORD, and DATABASE_DB

  4. 4

    Authentication-related variables include BETTER_AUTH_URL; email-related variables include RESEND_FROM_EMAIL

  5. 5

    Provides GET /api/health health check (including database ping) and GET /api/altcha-challenge proof-of-work challenge endpoint

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the Apache-2.0 license in the public repository; the free scope is the code of that version and does not mean external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution are permitted; when distributing, the Apache-2.0 license must be included.
  • Modified files must be prominently marked as changed, and relevant copyright, patent, trademark, and attribution notices must be retained.
  • If the original project includes a NOTICE file, applicable attribution notices in it must be retained when distributing derivative works.
  • The license includes an applicable contributor patent grant; initiating patent litigation as described in the license terminates that patent grant, and no trademark usage rights are granted.
  • The code is provided as-is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • The repository is positioned as a project boilerplate, not a ready-to-launch finished website; you need to customize development according to project requirements.
  • The author explicitly states that this fixed tech stack combination may not suit all use cases; evaluate whether it matches your needs before adopting it.
  • This template is only for B2C scenarios; if you need B2B features such as organizations and invitation-based collaboration within organizations, you need to switch to another B2B Starter repository from the same organization.
  • Before use, you must copy example.env to .env and fill in all required environment variables, otherwise the project will not run properly.
  • Email functionality depends on the third-party service Resend; you need to register an account and provide credentials such as RESEND_API_KEY, which may involve external service fees.
  • Long task functionality depends on the third-party service Trigger.dev; you need to register an account and provide TRIGGER_SECRET_KEY, which may involve external service fees.
  • You need to prepare and configure a database connection such as PostgreSQL (DATABASE_URL and other variables); database hosting or self-hosting costs are borne by the user.
  • The runtime environment requires Node.js 22 LTS and pnpm 10.x; mismatched versions may prevent proper building or running.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; you cannot judge solely based on the code's Apache-2.0 license.
  • External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis

no-charge, royalty-free, irrevocable copyright license

Original License Text

This is a boilerplate for starting new projects.

Original README

This may not fit every use case.

Original README

If you need B2B (Users have Orgs, invite within org to collaborate), start from other repo at

Original README

Copy `example.env` to `.env` and fill in required values.

Original README

- `RESEND_API_KEY`

Original README

- `TRIGGER_SECRET_KEY`

Original README

- `DATABASE_URL`

Original README

- Node.js 22 LTS

Original README
https://github.com/BlackcurrantLabs/blc-starter-next-b2c/blob/main/LICENSEhttps://github.com/BlackcurrantLabs/blc-starter-next-b2c/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 88 / 100
Technologies
Next.js · React
Website type
SaaS · Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-01-30
Screenshot last checked
2026-10-03

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Next.js as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 0e1f022560e4847989271867003e8888467f458fffe928af6a46bf76607683a7

2026-10-03T07:16:43.778Z

Source file / repository
# Blackcurrant Stack Starter Next B2C

This is a boilerplate for starting new projects. 
B2C SaaS starter template built with Next.js 15+, Prisma, BetterAuth, and Tailwind 4.
It's an opionated set of frameworks and tools hand picked for our general use cases.
This may not fit every use case.

*Vibe code* friendly, includes `AGENTS.md` and `.agent/rules` 
compatible with opencode, claude code, antigravity.

If you need B2B (Users have Orgs, invite within org to collaborate), start from other repo at [B2B Starter](https://github.com/BlackcurrantLabs/blc-starter-next-b2b)

## Stack

| Category                   | Technology/Tool                      |
|----------------------------|--------------------------------------|
| Framework                  | NextJS                               |
| ORM                        | Prisma, Typescript backend           |
| Authentication             | BetterAuth + BetterAuthUI            |
| Styling                    | Tailwind                             |
| Components                 | Shadcn,                              |
| Frontend State Management  | Context API                          |
| Emails                     | Resend                               |
| Long running Jobs          | Trigger.dev                          |
| Deployment                 | Vercel / Railway / AWS (self-hosted) |
| Tables                     | Tanstack Tables                      |
| Forms                      | react-hook-form                      |

## Goals

1. Landing page fully customised as per project, hosted with SSR with sign-in, sign-up and account button if already logged in. Redirect to user home if logged in.
2. Static pages like privacy policy and terms of use
3. Favicon, Robots.txt
4. Multiple user types with their own home page like Admin, User
5. Extensible APIs with auth that can be used with mobile clients
6. Parts of website that the users can see without a login
7. Parts of website that the user can only see after a login
8. Parts of website that the user can see only after custom attribute passes verification (maker/checker model)
9. Best in class DX with end to end typesafety
10. Support for long running jobs via trigger.dev with realtime job status in frontend
11. Admin side custom permissions and actions
12. A working template of table with serverside search, pagination, filtering, sorting
13. A working template of table with client side pagination
14. A working template of ideal implementation of forms following best practises with serverside and clinetside validation, synced schema
15. JWT based flow for mobile clients using apis

## Requirements

- Node.js 22 LTS
- pnpm 10.x

## Environment Variables

Copy `example.env` to `.env` and fill in required values.

Required:
- `SITE_NAME`
- `DATABASE_URL`
- `DATABASE_DIRECT_URL`
- `DATABASE_HOST`
- `DATABASE_PORT`
- `DATABASE_USER`
- `DATABASE_PASSWORD`
- `DATABASE_DB`
- `BETTER_AUTH_SECRET`
- `BETTER_AUTH_URL`
- `RESEND_API_KEY`
- `RESEND_FROM_EMAIL`
- `TRIGGER_SECRET_KEY`
- `ALTCHA_HMAC_SECRET`

## Operational Endpoints

- `GET /api/health` — health check (includes DB ping)
- `GET /api/altcha-challenge` — ALTCHA proof-of-work challenge

# Ecosystem Tools

## Form Builder
Build with https://www.shadcn-form.com/playground

## Placeholder Blocks
https://www.hyperui.dev/
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.