️️A minimal template for web app 🎃

From Zero to Service, Build with Best Practices, Minimal Code, and Essential Tools

📜 Read The Docs 📜

Installing this template automatically sets up the following libraries/tools. By saving you significant effort, it allows you to focus entirely on writing your product code.🤗

App	Next.js	Tailwind CSS	NextAuth.js	React Hook Form
	Zod	OpenTelemetry	Prisma	PostgreSQL
	Stripe
Tools	TypeScript	pnpm	Biome	Prettier
	Knip	EditorConfig	lefthook	Docker
Testing	Vitest	Testing Library	Playwright	Testcontainers
Others	GitHub Actions	Renovate	VSCode	Copilot Edits

Please read the features provided by this template first! 👉 Challenges Solved

Prerequisites

• Node.js v20 or higher
• Docker

Installation

When installing the repository, you can skip the setup section, as the init script will do the equivalent of setup.

Using CLI (recommended)

$ npx create-app-foundation@latest

The CLI creates a project directory and run internal/init script so it's easy to get started.

Using GitHub Template

This repo is a GitHub template, so click the "Use this template" button to create your repo. Then, you need to execute the below to finish setting it up.

$ node .internal/setup/init.mjs

Opt-out

The following items will be asked whether they are required when the project is initialized:

• Sample Application Code
• Dockerfile
• E2E Testing
• Observability feature
• Stripe

Setup

# enable corepack
$ npm run setup
# install deps
$ pnpm i
# create ".env" and modify environment variables
$ cp .env.sample .env

Development

$ pnpm dev

Debugging Stripe

1. Create a subscription here and get price_id.

2. Modify the environment variables. The test API key is here.

STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
STRIPE_PRICE_ID=

3. Install stripe CLI to bypass the webhook.

4. Execute the following command in another terminal.

$ stripe listen --forward-to localhost:3000/api/payment/webhook

5. After signing in, you can go to the http://localhost:3000/me/payment page to see how to make a payment.

Production

$ pnpm db:up
$ pnpm build
$ pnpm start

Observability

This template uses Jaeger as a tracing platform. The local environment doesn't require TRACE_EXPORTER_URL environment value.

# open Jaeger
$ open http://localhost:16686/

Test

Unit Test

$ pnpm test
$ pnpm test:watch

E2E Test

A build task must be executed before running tests to bypass JWT logic.

# install chrome
$ pnpm exec playwright install chrome
# build using test environments since it needs to change encode/decode functions of next-auth
$ pnpm build:test

$ pnpm test:e2e
$ pnpm test:e2e:ui

Database

$ pnpm db:migrate
$ pnpm db:reset
# view the database items
$ pnpm db:studio

Links

• Database ER diagram
• Web App Template