shaadkit
Next.js · React / 启动器 · 作者 shaadcode
ShaadKit 是作者个人维护的 Next.js 前端启动器，集成 Mantine、next-intl、Storybook、Vitest 与 Playwright 等工具，提供一套可直接开始写业务代码的工程基线。
模板详细介绍
ShaadKit 是一个面向现代 Web 应用的 Next.js 前端启动器，由作者 Seyed Mojtaba Shadab（ShaadCode）维护。它把作者在多个项目中反复使用的工具、约定与架构整理成一套基线，目标是把 create-next-app 之后需要手动完成的配置、约定统一、工具接入、测试搭建和 UI 基础设施等步骤提前完成，让开发者可以直接进入产品功能的开发。
技术栈以 Next.js 与 React 19 为核心，使用 TypeScript 编写，UI 层采用 Mantine v9，样式基于 PostCSS 与 CSS Modules。国际化由 next-intl 提供，组件开发与文档使用 Storybook 10，测试覆盖 Vitest 与 Playwright，代码质量由 ESLint（Antfu Config）和 Stylelint 负责，包管理器为 Bun，并集成 Bundle Analyzer 与 React Compiler。
作者在 README 中说明，ShaadKit 是一个基础而非完成的应用，核心依赖学习曲线平缓，既可用于 MVP，也可随项目扩展；虽然主要聚焦前端，但经过少量调整也可用于全栈项目。仓库采用 MIT 许可证。
主要特点
- 以 Bun 作为包管理器，提供安装与开发脚本
- 集成 Mantine v9 与 PostCSS / CSS Modules 作为 UI 与样式方案
- 内置 next-intl，支持国际化并可用于管理站点静态文案
- 集成 Storybook 10，包含 MCP 与 A11y 插件，支持组件驱动开发
- 使用 Vitest 与 Playwright 覆盖单元测试与真实浏览器测试
- 配置 ESLint（Antfu Config）与 Stylelint，并集成 Bundle Analyzer 与 React Compiler
适用场景
- 启动新的 Next.js 前端项目，希望跳过重复的工程配置阶段
- 需要国际化能力，并希望用 next-intl 统一管理站点静态文案
- 采用组件驱动开发流程，需要 Storybook 与可访问性检查
- 希望从项目初期就具备单元测试与端到端测试能力
- 需要分析并优化打包体积，同时使用 React Compiler 自动优化
适合人群
- 熟悉 Next.js、React 与 TypeScript，希望快速进入业务开发的开发者
- 需要一套固定工程约定与工具链的个人项目或小团队
- 计划从 MVP 起步、后续可能扩展为更大规模前端项目的团队
- 接受作者技术选型（Mantine、next-intl、Bun 等）并希望直接复用该基线的开发者
使用前需要核对
- 使用 git clone https://github.com/shaadcode/shaadkit.git 克隆仓库并进入目录
- 使用 bun install 安装依赖，使用 bun dev 启动开发服务器
- 开发服务器默认运行在 http://localhost:3000
- 项目采用 MIT 许可证，仓库中提供了 LICENSE 文件
- README 说明 ShaadKit 是基础而非完成的应用，主要聚焦前端，全栈使用需要自行调整
本介绍由 AI 根据目录元数据和仓库 README 整理，实际功能以原仓库为准。
功能与适用范围
目录记录的用途为启动器，主要技术栈为Next.js、React。功能是否完整实现，需要在源码和演示中进一步确认。
- Next.js
- React
- 启动器