React 19 + Vite 6 + TypeScript,基于 MUI 6 的组件体系
react-pwa — React 启动器模板
作者 suren-atoyan
React 19 + Vite 6 + MUI 6 的 PWA 启动器,集成路由、状态管理、测试与 CI。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 2
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
内置 PWA 支持:离线缓存、可安装、自动更新(配置在 vite.config.ts)
React Router v7 路由 + Jotai 原子状态管理
开箱即用的暗色/亮色主题切换,基于 MUI Theme
集成 Vitest 单元测试、Playwright E2E 测试和 GitHub Actions 工作流
统一的项目结构,组件按 index/component/types/styled/utils 组织
模板详细介绍
React-PWA 是一个面向现代 Web 应用的 React 启动器,由 Vite 6 驱动,使用 React 19 和 TypeScript,并预置了 MUI 6 组件库。它把路由(React Router v7)、状态管理(Jotai)、主题切换、通知系统、错误边界、快捷键等常见需求整合进一套有观点的项目结构中,目标是让开发者跳过繁琐的配置,直接开始写业务代码。
项目目录按 components、config、error-handling、hooks、pages、routes、sections、theme、utils 划分,每个组件有统一的文件组织方式。开发工具链完整:Vitest 做单元测试,Playwright 做端到端测试,ESLint、Prettier、TypeScript 检查,Husky 配合 lint-staged 在提交前自动校验,还支持本地 HTTPS 预览。README 声称 Lighthouse 全绿,最大 chunk 约 65KB,初次加载约 0.6 秒,但这些性能数据需要你在自己的环境中复测。
这个模板适合想用 React 19 + MUI 快速搭建 PWA 的开发者,尤其是需要离线支持、安装到设备、明暗主题切换的项目。不过它带有明显的技术选型倾向,如果你不想用 MUI 或 Jotai,替换成本会比较高。另外,README 没有说明 PWA 的 service worker 具体配置细节,自动更新策略也需要你在 vite.config.ts 里确认。上线前建议检查依赖版本、环境变量模板和构建产物。
适合你的项目吗?
适用场景
- 快速搭建 React 19 + MUI 的 PWA 应用原型
- 需要一个已集成路由、状态管理、测试和 CI 的完整启动项目
- 开发需要离线可用、可安装到桌面的 Web 应用
- 团队希望统一代码风格和组件组织方式
适合人群
- 熟悉 React 和 TypeScript 的开发者
- 接受 MUI 作为 UI 基础、Jotai 作为全局状态方案的项目
- 需要 PWA 功能(离线、安装)的 Web 应用
- 希望开箱即用测试和代码质量工具链的团队
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
克隆仓库后执行 npm install 即可启动。
- 2
开发服务器用 npm run dev,生产构建用 npm run build。
- 3
环境变量需放在 .env 文件中,前缀 VITE_,模板在 env/ 目录。
- 4
本地 HTTPS 预览用 npm run https-preview。
- 5
注意:PWA 的自动更新策略需在 vite.config.ts 中确认,README 未给出具体配置。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证明确允许免费使用、修改、分发和商用,仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明于所有副本或实质性部分
额外费用与待核对事项
- README未说明封面图等演示素材的授权范围
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
The above copyright notice and this permission notice shall be included in all
许可证原文
[MIT](./LICENSE)
README 原文
https://github.com/suren-atoyan/react-pwa/blob/master/LICENSEhttps://github.com/suren-atoyan/react-pwa/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 85 / 100
- 技术栈
- React
- 网站类型
- 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-01-22
- 截图检查日期
- 2026-09-04
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 React。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。
ant-design-pro
Ant Design Pro 是 Ant Design 官方推出的企业级中后台前端脚手架,基于 React 19、Umi Max 4 和 antd 6 构建,内置 TypeScript 支持。
React · 后台

react-boilerplate
react-boilerplate 是一个为有一定 React 和 Redux 经验的开发者设计的启动器,目标是快速搭建可扩展、离线优先的 Web 应用。
React · 启动器

fastapi-react
fastapi-react 是一个基于 Cookiecutter 的模板,用于快速搭建 FastAPI 与 React(TypeScript)的全栈项目。
React · 后台

shadcn-landing-page
Free Landing page template using Shadcn, React, Typescript and Tailwind
React · 企业官网
start-ui-web
Start UI [web] 是 BearStudio 团队维护的一个有主见的全栈启动器,用于快速搭建 Web 应用。
React · 启动器

React-Landing-Page-Template
A simple react one page landing page templates for startups/companies
React · 企业官网
