基于 Vite 构建,使用 React 与 TypeScript,并启用 SWC
React-Starter-Project — Vite 启动器模板
作者 FelixFern
基于 Vite 的 React + TypeScript 启动模板,集成 TanStack Router、TanStack Query、Tailwind CSS 与 Shadcn UI,并附带数据请求、分页、路由参数等示例。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 2
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
集成 TanStack Router 路由与 TanStack Query 服务端状态管理
内置 Tailwind CSS 与 Shadcn UI,便于搭建界面
提供数据获取、分页、路由参数和自定义 Hooks 等示例代码
使用 Biome.js 作为 Linter,并配置 GitHub Actions CI 与 Pre-commit Hooks
模板详细介绍
这是一个面向 React 前端项目的启动模板,使用 Vite 构建,采用 TypeScript 与 SWC。作者在 README 中说明,模板提供了他常用的 React 项目目录结构,并预配置 Prettier 以改善开发体验。技术栈方面,项目使用 React、TanStack Router 负责路由、TanStack Query 管理服务端状态、Axios 用于数据请求,并集成 Tailwind CSS 与 Shadcn UI 组件库。
模板内置若干可直接参考的示例:数据获取、数据分页、路由、TanStack Router 参数用法以及自定义 Hooks。工具链上使用 Biome.js 作为 Linter,并通过 GitHub Actions 配置了 Linter 的 CI,同时包含 Pre-commit Hooks。README 中列出的后续改进方向包括 JWT 认证会话 Hooks、数据表格示例、表单示例和 TanStack 路径参数用法,这些内容当前尚未包含。
使用前提为 Node.js v18.16 及以上版本,并搭配 npm、yarn 或 pnpm 等包管理器;VS Code 用户建议安装 Biome.js 扩展。示例数据来自 Pokemon API。项目采用 MIT 许可,允许免费使用、修改、商用和分发该版本代码,但演示图片、字体、图标等第三方素材需按各自许可核对,域名、托管、数据库等外部服务可能另外收费。
适合你的项目吗?
适用场景
- 需要快速初始化一个 React + TypeScript 前端项目结构
- 希望在项目中使用 TanStack Router 与 TanStack Query 并参考示例写法
- 需要 Tailwind CSS 与 Shadcn UI 组合的界面开发起点
- 想参考数据获取、分页和自定义 Hooks 的实现方式
适合人群
- 熟悉 React 与 TypeScript、希望减少初始配置的前端开发者
- 计划使用 TanStack 路由与查询方案的项目
- 需要预置 Linter、CI 和提交钩子的团队或个人项目
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
需要 Node.js v18.16 及以上版本,并准备 npm、yarn 或 pnpm 之一
- 2
VS Code 用户建议安装 Biome.js 扩展
- 3
可通过 GitHub 的 Use this template 创建新仓库,或直接 git clone 仓库
- 4
安装依赖后使用包管理器运行 dev 脚本启动开发
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 使用该模板需要本机安装 Node.js v18.16 或更高版本,并准备 npm、yarn 或 pnpm 之一作为包管理器,否则无法安装依赖和启动开发。
- VS Code 用户若想获得 README 所述的 Linter 开发体验,需要额外安装 Biome.js 扩展;其他编辑器用户不受此条约束。
- 数据获取示例依赖外部 Pokemon API(pokeapi.co),该服务由第三方提供,可用性、访问频率和条款由该服务方决定,不属于本项目代码许可范围。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
Node.js v18.16 and up with package manager (npm, yarn, or pnpm)
README 原文
Biome.js VSC Extension (for VS Code User)
README 原文
https://github.com/FelixFern/React-Starter-Project/blob/main/LICENSEhttps://github.com/FelixFern/React-Starter-Project/blob/main/README.md[Pokemon APIs](https://pokeapi.co/) by Paul Hallet (used for data fetching example)
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 86 / 100
- 技术栈
- Vite · React
- 网站类型
- 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2025-08-29
- 截图检查日期
- 2026-10-03
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Vite。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
审核声明: [email protected] · 2026-10-04
查看当时使用的来源资料
SHA-256: d1059025d58ac73344c5b4b05a5c7760e194fe1388829d3fc4c0829bd06966bb
2026-10-03T18:54:16.181Z
来源文件 / 仓库<div style={{display:"flex"; justfiy-content:"center"; width: "100vw"}}>
<img src="https://github.com/FelixFern/React-Starter-Project/assets/28957554/8119e7d8-1394-4ccd-babf-5a8afc0dc577" alt="react" width="100"/>
</div>
# ⚛ Felix's React Starter Project - Vite + React + Typescript with SWC
This template provides a minimal setup to get React working in Vite to build your app with ease, this template provides you with how I usually structure my React project directories and preconfigured Prettier to give you good DX when developing a frontend application. This project also includes [Shadcn UI](https://ui.shadcn.com/) and [Tailwind CSS](https://tailwindcss.com/) to help you build your UI as quickly as possible.
<div style={{display: "flex"; column-gap: "1rem", justify-content: "center", margin-top: "1rem"}}>
<img width="500" alt="image" src="https://github.com/FelixFern/React-Starter-Project/assets/28957554/ffc1a46a-cbcd-4083-81a1-a69ced8758d9">
<img width="500" alt="image" src="https://github.com/FelixFern/React-Starter-Project/assets/28957554/ac4876e5-0b9f-4190-af42-7573924c104a">
</div>
## Pre-requisite
- Node.js v18.16 and up with package manager (npm, yarn, or pnpm)
- Biome.js VSC Extension (for VS Code User)
## Dependencies Used
- React v18.2.0 with Typescript
- Axios (for Data Fetching)
- Tanstack Router (for Routing): https://tanstack.com/router/latest
- Tanstack Query (for Server Side State): https://tanstack.com/router/latest
- Tailwind CSS (CSS Alternative): https://tailwindcss.com/
- Shadcn (Component Library): https://ui.shadcn.com/
## How to use
1. Click the "Use this template" button and select "Create a new repository", after that you can change the name of the project as you like
<img width="1547" alt="Screenshot 2024-02-07 at 20 35 32" src="https://github.com/FelixFern/React-Starter-Project/assets/28957554/0547b4e5-be4b-46bf-824b-4a89dc276b76"/>
or, you can directly clone this repository using this command,
```
git clone https://github.com/FelixFern/React-Starter-Project
```
2. Then, install all the needed dependencies using your desired package manager,
```
pnpm install
```
3. After that, you can start using this template and edit as you like! and to start the project use
```
pnpm run dev
```
## 🟩 Features / Examples Included
1. Fetching Data Example ✅
2. Data Pagination Example ✅
3. Routing ✅
4. Tanstack Router Params Usage ✅
5. Custom Hooks ✅
6. Biome.js for Linter ✅
7. CI for Linter with Github Actions ✅
8. Pre-commit Hooks
## 🟧 Next Improvement
1. JWT Auth Session Hooks
2. Data Table Example
3. Form Example
4. Tanstack Path Params Usage
If you have any inputs or suggestions, add them as an [Issues](https://github.com/FelixFern/React-Starter-Project/issues) and we'll discuss them!
## 🗒️ Credits
[Pokemon APIs](https://pokeapi.co/) by Paul Hallet (used for data fetching example)
## 🙎♂️ Maintained by
- @Felix Fernando | [Github](https://github.com/FelixFern) | [LinkedIn](https://www.linkedin.com/in/felix-fern/)
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

react-starter-kit
Modern React starter kit with Bun, TypeScript, Tailwind CSS, tRPC, Stripe, and Cloudflare Workers. Production-…
Vite · SaaS

cove
The Cove Stack: 🏝️ minimal TanStack Start template with Vite+, Better Auth, Drizzle ORM, shadcn/ui
Vite · SaaS

vite-react-boilerplate
A production ready, scalable starter template for Vite + React
Vite · 启动器

react-vite-admin
This Starter utilizes React, Recoil, React Query, React Hooks, Typescript, Axios And Vite. 全新技术栈的后台管理系统
Vite · 后台

typescript-react_best_practices-vite_template
<⚡⚛️> Start your React project with Vite following code best practices (TypeScript, Linting, testing, CI/CD…)
Vite · 启动器

cloudflare-starter-kit
Template (boilerplate) repository for scaffolding Cloudflare Workers projects
Vite · 启动器
