Feature-first 边界
业务能力按 feature 聚合，app 层只负责组合路由与入口，让目录本身就是协作协议。
查看演示 →从工程基础设施开始，而不是从空白开始。
一个把目录边界、数据层、测试与主题系统预先搭好的 Next.js 启动模板。 Feature-first 结构、类型安全请求层与 Vitest 回归能力开箱即用，可直接在此基础上开始业务开发。
app/ // route composition
features/home/ // sections + view logic
features/demo/ // visual demos
service/http-* // client / server instances
components/ // shared UI + atmosphere
styles/tailwind.css // theme variablesroute → feature → service → test
pnpm workspace + Turborepo 管线就绪
Feature-first 结构保持业务边界清晰
client-only / server-only 双实例隔离
Vitest + MSW 预置回归能力
当前页面的光晕与动效只是演示皮肤，可整体替换或移除，不影响目录边界、数据层与测试基建。
导航、Footer 与 Demo 页面共享同一套主题 token，替换皮肤时只需调整 token 与组件样式。
能力索引
六项能力对应模板的核心分层，每项都附有可运行的演示入口，验证后再决定是否保留。
类型安全数据层
ky HTTP、Zod 响应校验与 React Query hooks 形成清晰分层，请求与 UI 自然解耦。
查看演示 →双实例运行时
client-only / server-only 文件级边界，把运行时差异变成结构而不是组件内部判断。
查看演示 →测试基建就绪
Vitest + MSW 预置完成，组件、状态与请求回归从第一天开始可验证。
查看演示 →类型化 RPC 通道
hc<AppType> 直连 Hono 服务，前后端接口同步演进，减少契约漂移。
查看演示 →主题化视觉系统
CSS Variables 主题 token、亮暗模式与五套预置主题统一驱动，换肤只需调整 token，无需改动组件结构。
查看演示 →工作流程与架构视图
从定义 feature 到测试收口的四步工作流，配合目录结构视图，说明每层代码的落位规则与依赖方向。
src/
├── app/ # 只组合路由与 metadata
├── features/ # 视图 + 数据层 + 模型
├── service/ # HTTP / RPC / SSE 运行时实例
├── components/ # 共享 UI 与 provider
└── styles/ # token 与全局样式目录即协议：app 只组合路由，feature 承载业务，service 隔离运行时差异，components 与 styles 提供共享基础。
定义 feature
先在 feature 内落位视图、数据与模型，再决定哪些能力需要共享。
组合路由
App Router 只暴露稳定入口，让路由成为最薄的一层组合代码。
接入 service
浏览器与服务端实例分离，读取环境能力时不污染 UI 组件实现。
测试收口
用纯逻辑测试与组件行为测试关闭回归，让模板从示例升级为可复用基础设施。
Demo 导览
四个代表性演示分别对应请求层、数据驱动布局、主题 token 与状态管理，可直接跳转到真实页面逐项验证。
快速开始
命令、技术栈与职责映射保持在同一节奏中，方便从浏览过渡到真正启动项目。
git clone https://github.com/kkfive/nextjs-start-template.git my-project克隆模板仓库cd my-project && pnpm install安装依赖（pnpm workspace）pnpm dev启动全部应用（Turborepo 并行）