React启动器

react-pwa — React 启动器模板

作者 suren-atoyan

React 19 + Vite 6 + MUI 6 的 PWA 启动器,集成路由、状态管理、测试与 CI。

看看你的网站会是什么样

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

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

演示站首页的真实桌面布局。

全部页面与视图 2

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

采集于 2026-09-27查看来源

值得关注的模板亮点

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

01

React 19 + Vite 6 + TypeScript,基于 MUI 6 的组件体系

02

内置 PWA 支持:离线缓存、可安装、自动更新(配置在 vite.config.ts)

03

React Router v7 路由 + Jotai 原子状态管理

04

开箱即用的暗色/亮色主题切换,基于 MUI Theme

05

集成 Vitest 单元测试、Playwright E2E 测试和 GitHub Actions 工作流

06

统一的项目结构,组件按 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启动器

适合你的项目吗?

适用场景

  • 快速搭建 React 19 + MUI 的 PWA 应用原型
  • 需要一个已集成路由、状态管理、测试和 CI 的完整启动项目
  • 开发需要离线可用、可安装到桌面的 Web 应用
  • 团队希望统一代码风格和组件组织方式

适合人群

  • 熟悉 React 和 TypeScript 的开发者
  • 接受 MUI 作为 UI 基础、Jotai 作为全局状态方案的项目
  • 需要 PWA 功能(离线、安装)的 Web 应用
  • 希望开箱即用测试和代码质量工具链的团队

上手与定制指南

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

  1. 1

    克隆仓库后执行 npm install 即可启动。

  2. 2

    开发服务器用 npm run dev,生产构建用 npm run build。

  3. 3

    环境变量需放在 .env 文件中,前缀 VITE_,模板在 env/ 目录。

  4. 4

    本地 HTTPS 预览用 npm run https-preview。

  5. 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 原文

Permission is hereby granted, free of char

许可证原文
https://github.com/suren-atoyan/react-pwa/blob/master/LICENSEhttps://github.com/suren-atoyan/react-pwa/blob/HEAD/README.md

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 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。

这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。

反馈内容错误

看看同类模板

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