https://github.com/akshayark97/next-app-template-demo
A production-ready Next.js starter with auth, PostgreSQL, Redis, AI, file storage, email, testing, and deployment workflows already configured.
https://github.com/akshayark97/next-app-template-demo
ai-sdk anthropic biomejs drizzle-orm neondb nextjs playwright postgresql react-email reactjs resend shadcn-ui stack-auth tailwindcss typescript upstash-redis vercel-blob vitest
Last synced: 3 days ago
JSON representation
A production-ready Next.js starter with auth, PostgreSQL, Redis, AI, file storage, email, testing, and deployment workflows already configured.
- Host: GitHub
- URL: https://github.com/akshayark97/next-app-template-demo
- Owner: akshayark97
- License: mit
- Created: 2026-05-31T14:55:57.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-22T16:46:27.000Z (10 days ago)
- Last Synced: 2026-06-22T18:05:13.838Z (10 days ago)
- Topics: ai-sdk, anthropic, biomejs, drizzle-orm, neondb, nextjs, playwright, postgresql, react-email, reactjs, resend, shadcn-ui, stack-auth, tailwindcss, typescript, upstash-redis, vercel-blob, vitest
- Language: TypeScript
- Homepage: https://next-app-template-demo.vercel.app
- Size: 396 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Next.js App Template
A production-ready fullstack Next.js starter. Clone it, configure your env vars, and start building your app — not infrastructure.
## Tech stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16, React 19, TypeScript |
| Database | Neon (Postgres) + Drizzle ORM |
| Auth | Stack Auth |
| Caching | Upstash Redis |
| Storage | Vercel Blob |
| AI (optional) | Vercel AI SDK (bring your own provider) |
| Email | Resend + React Email |
| i18n | next-intl (English, Japanese, German) |
| Deployment | Vercel |
| Testing | Vitest + Playwright |
| Tooling | Biome, Tailwind CSS v4, shadcn/ui |
## Getting started
```bash
# 1. Clone the repo
git clone https://github.com/your-org/your-repo my-app
cd my-app
# 2. Install dependencies
npm install
# 3. Copy the example env file and fill in your values
cp .env.example .env.local
# 4. Run database migrations
npm run db:migrate
# 5. (Optional) Seed the database with placeholder data
npm run db:seed
# 6. Start the dev server
npm run dev
```
Open [http://localhost:3000](http://localhost:3000) to see the starter landing page.
## Environment variables
Copy `.env.example` to `.env.local`. All variables are optional — the app will start without them, but features that depend on them will be disabled or stub out.
| Variable | Used for |
|---|---|
| `DATABASE_URL` | Neon Postgres connection string |
| `NEXT_PUBLIC_STACK_PROJECT_ID` | Stack Auth |
| `NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY` | Stack Auth |
| `STACK_SECRET_SERVER_KEY` | Stack Auth |
| `UPSTASH_REDIS_REST_URL` | Redis caching |
| `UPSTASH_REDIS_REST_TOKEN` | Redis caching |
| `BLOB_READ_WRITE_TOKEN` | Vercel Blob uploads |
| `BLOB_BASE_URL` | Vercel Blob image rendering |
| `RESEND_API_KEY` | Transactional email |
| `_API_KEY` | AI features (optional) — only if you wire up an LLM provider, e.g. `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY` |
## Building your app
1. **Rebrand** — Edit `src/lib/site-config.ts` to set your app `name`, `description`, and `repoUrl`. These feed the navbar, page title, landing-page buttons, and emails from one place. Also update `name` in `package.json`.
2. **Rename the domain model** — The example table is called `resources`. Rename it (or replace it) in `src/db/schema.ts` and regenerate the migration with `npm run db:generate`.
3. **Update the landing page** — Replace `src/app/(site)/[locale]/page.tsx` with your actual home page, and edit the copy in `messages/*.json`.
4. **Add your routes** — Create localized pages under `src/app/(site)/[locale]/`. Server actions live in `src/app/actions/`.
5. **Wire up AI (optional)** — The Vercel AI SDK is included but provider-agnostic. Pick a provider, install its adapter (e.g. `npm install @ai-sdk/openai`), then uncomment and configure `src/ai/summarize.ts`. Skip this entirely if your app doesn't need AI — it returns a stub by default.
6. **Customise email** — Update `src/email/templates/notification-template.tsx` with your branding.
## Internationalization (i18n)
Localized with [next-intl](https://next-intl.dev) using URL-based locale routing. Ships with **English (`en`)**, **Japanese (`ja`)**, and **German (`de`)** — `en` is the default. Visiting `/` redirects to the visitor's best-match locale (e.g. `/en`), and the navbar includes a language switcher.
Message catalogs live in `messages/.json`, and message keys are type-checked against `messages/en.json`.
**Add a new language** (e.g. French):
1. Add `"fr"` to `locales` in `src/i18n/routing.ts`.
2. Copy `messages/en.json` → `messages/fr.json` and translate the values.
3. Add a display name in `src/i18n/locale-names.ts` (e.g. `fr: "Français"`).
Routing, the language switcher, and message loading pick it up automatically.
**A few conventions:**
- Use `Link` / `useRouter` from `@/i18n/navigation` for localized routes (they keep the locale prefix); use plain `next/link` for non-localized paths like Stack Auth's `/handler/*`.
- Localized pages live under `src/app/(site)/[locale]/`; the auth handler stays non-localized under `src/app/(auth)/` so Stack Auth keeps its fixed `/handler` path.
## Scripts
```bash
npm run dev # Start dev server (Turbopack)
npm run build # Production build
npm run typecheck # TypeScript check
npm run lint # Biome lint + format check
npm run lint:fix # Auto-fix lint issues
npm run db:generate # Generate Drizzle migration
npm run db:migrate # Apply migrations
npm run db:seed # Seed placeholder data
npm run test # Unit tests (Vitest)
npm run test:e2e # E2E tests (Playwright)
```
## Project structure
```
src/
app/ # Next.js App Router pages and server actions
ai/ # AI utilities
cache/ # Redis client
components/ # Shared UI components
db/ # Drizzle schema, migrations, seed
email/ # Email sending logic and React Email templates
i18n/ # next-intl config (routing, navigation, request, locale names)
lib/ # Shared data-access helpers
stack/ # Stack Auth client/server config
proxy.ts # next-intl locale middleware
messages/ # Translation catalogs (en.json, ja.json, de.json)
test/
unit/ # Vitest unit tests
e2e/ # Playwright E2E tests
```