# Next.js starter

> A minimal Next.js 15 App Router app with one page, an API route and a health check.

A small Next.js 15 app to build on, with TypeScript, the App Router, a JSON API route and a health check. Click Deploy and Naijacloud builds it from the public repo and gives you a live HTTPS address. No GitHub connection needed.

- Use case: Starter
- Stack: Next.js
- Code: https://github.com/naijacloud/template-nextjs-starter (branch `main`)
- Deploy: https://naijacloud.com/new?template=nextjs-starter&ref=template-nextjs-starter
- Free tier: fits (1 app per workspace)
- Last verified on Naijacloud: 9 Oct 2026
- Page: https://naijacloud.com/templates/nextjs-starter

## What's inside

- Next.js 15 with the App Router and TypeScript
- A JSON route at /api/hello and a health check at /healthz
- No Dockerfile. Naijacloud detects Next.js, builds it and starts it on $PORT
- SITE_NAME is read at request time, so changing it needs no rebuild

## What you get after deploying

- A live address at https://nextjs-starter.naijacloud.app with HTTPS
- Build and runtime logs, metrics and redeploys from the dashboard

## Environment variables

| Name | What it is for | Default |
| --- | --- | --- |
| `SITE_NAME` | Shown in the page title and header | `My app` |

## Run it locally

```bash
git clone https://github.com/naijacloud/template-nextjs-starter
cd template-nextjs-starter
cp .env.example .env
npm install
npm run dev
```

Learn how it works: [Deploy a web service](https://naijacloud.com/docs/deploy/web-services)

All templates: https://naijacloud.com/templates