按 Feature-Sliced Design 划分 app、widgets、features、entities、shared、processes 六层,并规定严格导入方向
nextjs-fsd-template — Next.js 后台模板
作者 devTugu
Next.js 16 后台模板,采用 FSD 分层架构,内置 RBAC 权限 UI 与 TanStack 表格,需搭配同作者 NestJS 后端使用。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 4
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
基于 permissionCodes 的 RBAC 界面控制,SUPER_ADMIN 与细粒度权限码并存
用户、角色、权限三套 CRUD,含 sheet 表单与分组权限选择器
TanStack Query v5 + TanStack Table v8 + react-hook-form/Zod + shadcn/ui 技术组合
Axios 封装 Nest 响应格式与 JWT 刷新,附带架构文档和 ADR
模板详细介绍
这是一个 Next.js 16 App Router 后台管理模板,最鲜明的特点是按 Feature-Sliced Design 组织 src 目录:app、widgets、features、entities、shared、processes 六层,并规定了严格的单向导入规则。页面路由只做薄壳,用户、角色、权限等业务能力放在 features,表格列和 API hooks 归 entities,侧边栏、数据表等组合块归 widgets。仓库内附有架构说明和三份 ADR,适合想在实际项目里落地 FSD 的团队参考。
功能层面覆盖登录、仪表盘统计,以及用户、角色、权限三块 CRUD。数据请求用 TanStack Query v5,表格用 TanStack Table v8,表单是 react-hook-form 加 Zod,UI 基于 shadcn/ui 和 Tailwind CSS 4,HTTP 层用 Axios 处理 Nest 风格响应封装和 JWT 刷新。权限控制依赖 GET /auth/me 返回的 permissionCodes:SUPER_ADMIN 拥有全部权限,其余按钮和路由按 USER_READ、ROLE_CREATE 这类编码判断。
需要留意的是,它并非独立可跑的前端,必须搭配同作者的 nestjs-fsd-template 后端(本地 3001 端口,MySQL 加可选 Redis),仓库也把它定位为配套前端。README 提到 production-ready 并给出上线检查清单,但 CI 中的 E2E 只是 stub,完整端到端测试要在本地同时启动两个仓库。许可证状态在资料中标记为 review,使用前建议自行核对 LICENSE 文件。
适合你的项目吗?
适用场景
- 需要一套带权限管理界面的后台前端骨架,并愿意同时采用配套 NestJS 后端
- 团队想在实际项目中实践 Feature-Sliced Design,需要可参考的目录与导入约束
- 以用户、角色、权限为核心的中后台系统,希望复用现成的表格、表单和 sheet 交互
适合人群
- 使用 Next.js 16 App Router 与 TypeScript 的前端团队
- 已决定或愿意引入 nestjs-fsd-template 作为 API 的项目
- 熟悉或愿意学习 FSD 分层、TanStack 生态与 shadcn/ui 的开发者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
必须先启动 nestjs-fsd-template 后端(本地 3001 端口,需 MySQL,Redis 可选),前端单独无法完整运行
- 2
前端配置 NEXT_PUBLIC_API_BASE_URL 指向 /api/v1,后端 CORS_ORIGIN 需与前端地址精确匹配
- 3
种子管理员账号为 [email protected] / Admin123!,仅用于本地开发,上线前务必更换
- 4
CI 中的 E2E 为 stub,完整 Playwright 测试需本地同时运行前后端
- 5
仓库标注 production-ready 并附上线清单,但许可证状态为 review,正式使用前请核对 LICENSE 与安全文档
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可,允许免费使用、修改、分发和商用,仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明
额外费用与待核对事项
- README未提供图片素材的许可信息
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
[MIT](LICENSE)
README 原文
https://github.com/devTugu/nextjs-fsd-template/blob/main/LICENSEhttps://github.com/devTugu/nextjs-fsd-template/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 82 / 100
- 技术栈
- Next.js · React
- 网站类型
- 后台
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-06-11
- 截图检查日期
- 2026-09-07
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

next-shadcn-dashboard-starter
Free, open source, AI-friendly admin dashboard template built with Next.js 16, shadcn/ui, Tailwind CSS, and Ty…
Next.js · 后台

Studio Admin · Radix UI
Modern Admin Dashboard Template built with Shadcn UI and Next.js 16
Next.js · 后台

free-nextjs-admin-dashboard
TailAdmin is a Next.js and Tailwind CSS free, open-source admin dashboard template. Provides developers with t…
Next.js · 后台

materio-mui-nextjs-admin-template-free
An enterprise-grade Next.js admin dashboard template. Made with developer experience first: Next.js v14 (App R…
Next.js · 后台

nextjs-postgres-nextauth-tailwindcss-template
Admin dashboard template.
Next.js · 后台

shadcn-dashboard-landing-template
Accelerate your development with a sleek, open-source admin dashboard and landing page built on Vite-React, Ne…
Next.js · 后台
