Next.jsReact启动器

next-frontend-template — Next.js 启动器模板

作者 kawaiiRE

基于 Next.js、React 与 TypeScript 的前端模板，与后端保持独立，通过版本化健康检查接口与 PocketBase 后端模板对接。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图
桌面端首页1 / 2
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-14查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

Next.js / React / TypeScript 前端模板，与后端保持独立

02

内置健康检查示例，预期对接 PocketBase 的 /api/v1/health 路由

03

提供 integration:check 命令验证前后端 API 版本与服务标识一致

04

包含集中式路由与样式、带类型服务、presenter、聚焦组件与测试

05

未预装全局状态库，README 说明需要时再引入 MobX 与 mobx-react-lite

06

提供架构、安全、测试与部署文档供修改边界前阅读

模板详细介绍

这是一个 Next.js / React / TypeScript 前端模板，README 说明其刻意与后端保持独立，不携带 Vue、Nuxt、Pinia、Vuestic 或 Fastify 的约定。模板保留了集中式路由与样式、带类型的服务、presenter、聚焦组件、测试与部署相关的组织方式。

使用流程为：将整个文件夹复制到新的外层文件夹中，重命名包并更新 src/config/site.ts、src/content/copy.ts 与 .env.example，然后执行 corepack yarn install --immutable，复制 .env.example 为 .env.local，再运行 corepack yarn dev。模板自带一个健康检查示例，README 建议按领域逐个替换。

前端预期在 POCKETBASE_URL 上访问版本化的 PocketBase 健康检查路由 /api/v1/health。配套的 pocketbase-backend-template 实现了该路由，但本仓库与后端之间没有文件系统依赖。先启动后端模板，再以指向它的 POCKETBASE_URL 启动前端，然后运行 corepack yarn integration:check，该命令会直接调用 PocketBase 并调用 Next.js 的 /api/health 桥接，验证两者暴露相同的 API 版本与服务标识。

模板未安装全局状态库，README 说明起始模板不需要；若某个功能确实需要共享的可变浏览器状态，可添加 MobX 与 mobx-react-lite，按领域组织 store，并在客户端 provider 中创建。README 未提供性能、生产就绪程度或具体框架小版本之外的更多说明。

Next.jsReact启动器

适合你的项目吗？

适用场景

  • 作为独立前端项目起步，配合 PocketBase 后端模板使用
  • 按领域逐个替换内置健康检查示例，搭建实际业务界面
  • 运行 integration:check 验证前后端服务版本与标识一致性
  • 在需要共享可变浏览器状态时按 README 指引引入 MobX store

适合人群

  • 希望前后端仓库分离、各自独立部署的团队
  • 使用 Next.js、React 与 TypeScript 并需要集中式路由与样式约定的项目
  • 计划以 PocketBase 作为后端并需要版本化健康检查对接的项目
  • 需要带类型服务、presenter 与测试结构的起始模板的开发者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    将整个文件夹复制到新的外层文件夹，不要把应用文件放在外层旁边或从同级项目导入

  2. 2

    重命名包并更新 src/config/site.ts、src/content/copy.ts 与 .env.example

  3. 3

    运行 corepack yarn install --immutable，复制 .env.example 为 .env.local，再运行 corepack yarn dev

  4. 4

    先启动 pocketbase-backend-template，再以指向它的 POCKETBASE_URL 启动前端，然后运行 corepack yarn integration:check

  5. 5

    修改边界或部署行为前阅读 docs/architecture.md、docs/security.md、docs/testing.md 与 docs/deployment.md

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
  • 前端预期在 POCKETBASE_URL 上访问版本化的 PocketBase 健康检查路由 /api/v1/health，需要自行提供或部署兼容该路由的后端服务。
  • 运行 integration:check 前必须先启动 pocketbase-backend-template，并将 POCKETBASE_URL 指向它，否则无法完成集成校验。
  • 使用时需将整个文件夹复制到新的外层文件夹，不要把应用文件放在外层旁边或从同级项目导入。
  • 需要重命名包并更新 src/config/site.ts、src/content/copy.ts 与 .env.example 才能用于自己的项目。
  • 安装与开发依赖 corepack yarn 命令，并需复制 .env.example 为 .env.local 后运行。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

The frontend expects the versioned PocketBase health route at `/api/v1/health` on `POCKETBASE_URL`. The separate `pocketbase-backend-template` implements it, but this repository has no filesystem dependency on that backend.

README 原文

Start `pocketbase-backend-template` first, then start this frontend with `POCKETBASE_URL` pointing to it. Once both are running, execute `corepack yarn integration:check` here. The check calls PocketBase directly and then calls the Next.js `/api/health` bridge, validating that both services expose the same API version and service identity. See `docs/integration.md` for the complete workflow.

README 原文

1. Copy this entire folder to a new wrapper folder. Do not place application files beside the wrapper or import from sibling projects.

README 原文

2. Rename the package and update `src/config/site.ts`, `src/content/copy.ts`, and `.env.example`.

README 原文

3. Run `corepack yarn install --immutable`, copy `.env.example` to `.env.local`, then run `corepack yarn dev`.

README 原文
https://github.com/kawaiiRE/next-frontend-template/blob/main/LICENSEhttps://github.com/kawaiiRE/next-frontend-template/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-14。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 85 / 100
技术栈
Next.js · React
网站类型
启动器
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2026-10-11
截图检查日期
2026-10-14

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: codex-user-requested-batch-review-20261015 · 2026-10-15

查看当时使用的来源资料

SHA-256: df34096075953efab6daf8ec4f004a653a7ae1ec46e6c7d2b2fcd0cf7228c993

2026-10-14T23:50:48.043Z

来源文件 / 仓库
# Next.js frontend template

[![CI](https://github.com/kawaiiRE/next-frontend-template/actions/workflows/ci.yml/badge.svg)](https://github.com/kawaiiRE/next-frontend-template/actions/workflows/ci.yml)

[Live demo](https://next-template.rachida.dev) | [PocketBase backend template](https://github.com/kawaiiRE/pocketbase-backend-template)

A production-minded Next.js 16 / React 19 / TypeScript frontend that is deliberately independent from its backend. It keeps the useful discipline of the Nuxt starter—central routes and styling, typed services, presenters, focused components, tests, and safe deployment—without carrying Vue, Nuxt, Pinia, Vuestic, or Fastify conventions into React.

## Start a project

1. Copy this entire folder to a new wrapper folder. Do not place application files beside the wrapper or import from sibling projects.
2. Rename the package and update `src/config/site.ts`, `src/content/copy.ts`, and `.env.example`.
3. Run `corepack yarn install --immutable`, copy `.env.example` to `.env.local`, then run `corepack yarn dev`.
4. Replace the health example one domain slice at a time. Keep route, contract, repository, service, presenter, component, and test changes synchronized.

The frontend expects the versioned PocketBase health route at `/api/v1/health` on `POCKETBASE_URL`. The separate `pocketbase-backend-template` implements it, but this repository has no filesystem dependency on that backend.

## Run with the PocketBase template

Start `pocketbase-backend-template` first, then start this frontend with `POCKETBASE_URL` pointing to it. Once both are running, execute `corepack yarn integration:check` here. The check calls PocketBase directly and then calls the Next.js `/api/health` bridge, validating that both services expose the same API version and service identity. See `docs/integration.md` for the complete workflow.

## Commands

- `corepack yarn integration:check` — verify the live Next.js-to-PocketBase connection

- `corepack yarn dev` — local development
- `corepack yarn format:write` — format files
- `corepack yarn check` — formatting, lint, types, tests, and production build
- `corepack yarn start` — serve the production build

No global store is installed because the starter does not need one. If a real feature requires shared mutable browser state, add MobX and `mobx-react-lite`, keep stores domain-based, and create each store inside a client provider.

Read `docs/architecture.md`, `docs/security.md`, `docs/testing.md`, and `docs/deployment.md` before changing boundaries or deployment behavior.

## Contributing and security

Contributions are welcome; see `CONTRIBUTING.md`. Report security issues privately by following `SECURITY.md` rather than opening a public issue.
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

ai-website-cloner-template

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 Starter 是 Next.js 官方维护的 SaaS 起点模板，定位介于学习资源和可直接部署的脚手架之间。

Next.js · SaaS

Next.js Commerce

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-Boilerplate 是一个面向 Next.js 16、Tailwind CSS 4 和 TypeScript 的启动器，核心定位是开发者体验优先。

Next.js · 启动器

tailwind-nextjs-starter-blog

tailwind-nextjs-starter-blog

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

Next.js · 博客

next-forge

next-forge

Production-grade Turborepo template for Next.js apps.

Next.js · 启动器