使用 Next.js App Router 与 TypeScript 的最小项目结构
template-nextjs-starter — Next.js 启动器模板
作者 naijacloud
面向 Naijacloud 部署的极简 Next.js App Router 启动模板,包含一个页面、一个 JSON API 路由与健康检查端点。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
内置 /api/hello JSON 路由与 /healthz 健康检查端点
无 Dockerfile,由 Naijacloud 自动识别并执行构建与启动命令
默认欢迎页支持明暗两种外观,并列出连接仓库、添加域名等后续步骤
仅需一个环境变量 SITE_NAME 控制页面标题与页头
采用 MIT 许可,可免费使用、修改、商用和分发该版本代码
模板详细介绍
这是一个基于 Next.js App Router 与 TypeScript 的最小启动器,仓库定位是「ready to deploy on Naijacloud」。项目只包含一个页面、一个位于 /api/hello 的 JSON 路由,以及一个位于 /healthz 的健康检查端点,适合作为新项目或部署验证的起点。
部署方式上,仓库没有提供 Dockerfile,而是依赖 Naijacloud 平台自动识别 Next.js 并执行 npm ci && npm run build,随后在 $PORT 上运行 npm run start。README 说明可以从公开仓库直接构建并获得 HTTPS 地址,无需连接 GitHub,之后也可以把服务切换到自己 fork 的仓库。
默认页面是 Naijacloud 的欢迎页,提供明暗两种外观,并列出后续步骤(连接仓库、添加域名、数据库或存储)。要替换成自己的应用,需修改 app/page.tsx;回链 Naijacloud 的链接集中在 lib/naijacloud.ts。环境变量方面,README 只列出 SITE_NAME,用于页面标题和页头,默认值为 My app,并在请求时读取。
需要注意的限制:模板本身不含数据库、认证或支付等业务模块,这些属于后续自行添加的范围;README 未说明除 SITE_NAME 之外的环境变量。许可为 MIT,免费范围仅指该版本代码,演示图片、字体、图标等第三方素材以及域名、托管、数据库等外部服务需另行核对各自许可与费用。
适合你的项目吗?
适用场景
- 在 Naijacloud 上快速验证 Next.js 项目的构建与部署流程
- 作为新 Next.js App Router 项目的起始代码,替换 app/page.tsx 后继续开发
- 需要一个可直接访问的 /healthz 健康检查端点用于服务探活
- 需要一个返回 JSON 的示例 API 路由来演示前后端接口调用
适合人群
- 希望以最小结构起步的 Next.js 开发者
- 准备在 Naijacloud 上部署并验证 Next.js 应用的个人或团队
- 需要 TypeScript 与 App Router 默认配置的示例项目参考者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
本地运行:克隆仓库后执行 cp .env.example .env、npm install、npm run dev
- 2
部署:可通过 README 中的 Deploy 按钮或 naijacloud.com/new 链接从公开仓库构建,无需连接 GitHub
- 3
环境变量:SITE_NAME 用于页面标题和页头,默认值为 My app,在请求时读取
- 4
替换内容:修改 app/page.tsx 换成自己的页面,Naijacloud 回链位于 lib/naijacloud.ts
- 5
许可:代码为 MIT,分发时需保留版权声明与许可声明;第三方素材与外部服务需单独核对
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
- 部署依赖 Naijacloud 平台:README 说明无需连接 GitHub,由 Naijacloud 从公开仓库构建并提供 HTTPS 地址,之后可将服务切换到自己 fork 的仓库。
- 项目不含 Dockerfile,构建与启动由 Naijacloud 平台自动识别 Next.js 后执行 npm ci && npm run build 与 npm run start,并监听 $PORT。
- 默认页面为 Naijacloud 欢迎页,回链 Naijacloud 的链接集中在 lib/naijacloud.ts,替换页面时需一并处理。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
No GitHub connection needed; you can switch the service to your own fork later.
README 原文
No Dockerfile: Naijacloud detects Next.js, runs `npm ci && npm run build`, then `npm run start` on `$PORT`
README 原文
https://github.com/naijacloud/template-nextjs-starter/blob/main/LICENSEhttps://github.com/naijacloud/template-nextjs-starter/blob/main/README.mdthe links back to Naijacloud live in `lib/naijacloud.ts`
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-12。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 80 / 100
- 技术栈
- Next.js · React
- 网站类型
- 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-10-12
- 截图检查日期
- 2026-10-12
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-13
查看当时使用的来源资料
SHA-256: 0ab914f2d7e40616212fecc51a41396e7fbc2a7804402507fd3842c3a98f621f
2026-10-12T13:43:17.450Z
来源文件 / 仓库# Next.js starter A minimal Next.js 15 App Router app with one page, an API route and a health check. [](https://naijacloud.com/new?template=nextjs-starter&ref=template-nextjs-starter) ## Deploy Click **Deploy** above, or open <https://naijacloud.com/new?template=nextjs-starter&ref=template-nextjs-starter>. Naijacloud builds it from this public repo and gives you a live HTTPS address. No GitHub connection needed; you can switch the service to your own fork later. ## 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, runs `npm ci && npm run build`, then `npm run start` on `$PORT` - A Naijacloud welcome page (light and dark) with your next steps: connect your repo, add a domain, a database or storage. Replace `app/page.tsx` with your own app; the links back to Naijacloud live in `lib/naijacloud.ts` ## Environment variables | Name | What it's for | Default | | --- | --- | --- | | `SITE_NAME` | Shown in the page title and header (read at request time) | `My app` | ## Run it locally ```sh git clone https://github.com/naijacloud/template-nextjs-starter cd template-nextjs-starter cp .env.example .env npm install npm run dev ``` ## License MIT
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

ai-website-cloner-template
Clone any website with one command using AI coding agents
Next.js · 启动器

Next.js SaaS Starter
Next.js SaaS Starter 是 Next.js 官方维护的 SaaS 起点模板,定位介于学习资源和可直接部署的脚手架之间。
Next.js · SaaS

Next.js Commerce
Next.js Commerce 是 Vercel 团队维护的电商启动模板,基于 Next.js App Router 构建,采用服务端渲染、React Server Components、Server Actions …
Next.js · 电商

Next-js-Boilerplate
Next-js-Boilerplate 是一个面向 Next.js 16、Tailwind CSS 4 和 TypeScript 的启动器,核心定位是开发者体验优先。
Next.js · 启动器

tailwind-nextjs-starter-blog
tailwind-nextjs-starter-blog 是一个面向个人技术博客的 Next.js 与 Tailwind CSS 启动模板,其 v2 版本基于 App Router 与 React Server Comp…
Next.js · 博客

next-forge
Production-grade Turborepo template for Next.js apps.
Next.js · 启动器
