TypeScript

next-enterprise-starter

Production-ready Next.js 16 template with Auth.js authentication, Prisma and PostgreSQL, security hardening, SEO, and unit and end-to-end tests running in CI.

0 stars

0 forks

0 watchers

MIT license

nextjstypescriptnext-authprismapostgresqltailwindcssdockerplaywrightvitestnodemailerprettier

Stack

Next.js 16 (App Router, proxy.ts)React 19TypeScript (strict)Auth.js v5Prisma 6PostgreSQLTailwind CSS 4shadcn/uiZodreact-hook-formVitestTesting LibraryPlaywrightDockerGitHub Actions

Features

Authentication

Email and password sign-in with email verification and password reset
Optional GitHub and Google sign-in
USER and ADMIN roles with an admin page
Route protection in proxy.ts plus server-side guards

Database

Prisma migrations and seed users
Docker Compose with PostgreSQL and Mailpit for a local email inbox

Security

Validated environment variables
Content Security Policy and security headers
Rate limiting
Hashed, single-use email tokens
No account enumeration and open-redirect protection

Testing

63 unit and component tests with Vitest and Testing Library
17 Playwright end-to-end tests
Both suites run in CI against a PostgreSQL service

SEO

pageMetadata() helper for consistent page metadata
Social cards generated with next/og
sitemap.xml with card images, robots.txt, and llms.txt

Operations

Standalone Docker image
/api/health endpoint
Structured JSON logging
Dependabot updates

Quick Start

Clone the repository, or click "Use this template" on GitHub

git clone https://github.com/tec-smith/next-enterprise-starter.git

2
Install dependencies
```
npm install
```
3
Create your environment file
```
cp .env.example .env
```
4
Start PostgreSQL and Mailpit
```
docker compose up -d
```
5
Run migrations and seed the database
```
npm run db:migrate && npm run db:seed
```
6
Start the dev server
```
npm run dev
```
7
Sign in as admin@example.com with the password Password123!

Interested In Contributing?

Reach out to TECSmith about collaborating on this repository, or check out what else is in the works.

Features

Authentication

Email and password sign-in with email verification and password reset
Optional GitHub and Google sign-in
USER and ADMIN roles with an admin page
Route protection in proxy.ts plus server-side guards

Database

Prisma migrations and seed users
Docker Compose with PostgreSQL and Mailpit for a local email inbox

Security

Validated environment variables
Content Security Policy and security headers
Rate limiting
Hashed, single-use email tokens
No account enumeration and open-redirect protection

Testing

63 unit and component tests with Vitest and Testing Library
17 Playwright end-to-end tests
Both suites run in CI against a PostgreSQL service

SEO

pageMetadata() helper for consistent page metadata
Social cards generated with next/og
sitemap.xml with card images, robots.txt, and llms.txt

Operations

Standalone Docker image
/api/health endpoint
Structured JSON logging
Dependabot updates

Quick Start

Clone the repository, or click "Use this template" on GitHub

git clone https://github.com/tec-smith/next-enterprise-starter.git

Install dependencies

npm install

Create your environment file

cp .env.example .env

Start PostgreSQL and Mailpit

docker compose up -d

Run migrations and seed the database

npm run db:migrate && npm run db:seed

Start the dev server

npm run dev