ViteReact启动器

birthday-greet — Vite 启动器模板

作者 illocean

一个基于 React 19、Vite、TypeScript 与 Three.js 的滚动驱动生日网站模板，包含信封、卡片、唱片、照片墙、信件五个场景，自带占位内容，可替换为自己的文字、照片和音乐。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

1 个预览视图

作者提供的预览

查看源码在新标签页打开

作者提供的预览

来自项目 README 的原始预览。

目前有 1 张原始预览，可打开完整图片查看设计细节。

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

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

值得关注的模板亮点

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

五个滚动驱动场景：信封、卡片、唱片、照片墙、信件

React 19 + Vite + TypeScript + Three.js + Motion，静态打包，无后端与运行时网络请求

文字集中在 src/content.ts，字段以 PLACEHOLDER 标记，便于逐项替换

照片位支持图片或 .mp4 循环视频，音乐与页面标题有固定替换位置

自带生成占位媒体的脚本，index.html 默认 noindex, nofollow

模板详细介绍

birthday-greet 是一个滚动驱动的交互式生日网站模板，按顺序呈现五个场景：信封、卡片、唱片、照片墙和信件。项目使用 React 19、Vite、TypeScript、Three.js 与 Motion 构建，打包为静态产物，不依赖后端，运行时不发起网络请求。

模板自带作者编写的占位内容，不包含任何个人信息。文字内容集中在 src/content.ts，所有需要替换的字段都标有 PLACEHOLDER 标记；照片放在 public/photos/photo-1 至 photo-6，某个位置放 .mp4 文件时会渲染为循环播放的视频片段；音乐对应 public/audio/song.mp3 与 public/audio/background.mp3；页面标题在 index.html 的 <title> 中修改。npm run assets 和 npm run song 可以重新生成占位媒体。

index.html 默认带有 noindex, nofollow，如果希望页面被搜索引擎收录需要自行移除该行。项目要求 Node 24 及以上，npm run verify 会执行类型检查、构建，并使用系统已安装的 Chrome 完成浏览器端验证，不额外下载浏览器。完整文档位于 docs/README-full.md。

文字特效来自 Magic UI（MIT，已内置），表面纹理来自 ambientCG（CC0），字体为 Great Vibes、Quicksand、The Girl Next Door（SIL OFL），均自行托管。代码采用 MIT 许可，但演示图片、字体、图标等第三方素材需按各自许可单独核对。

ViteReact启动器

适合你的项目吗？

适用场景

为朋友或伴侣制作个人生日祝福页面
作为滚动叙事型单页交互的练手项目
替换占位内容后部署为静态站点分享
参考其五场景结构与 Three.js 用法做二次开发

适合人群

熟悉 React 与 TypeScript、希望快速替换内容的使用者
需要静态托管、不引入后端服务的个人项目
想学习滚动驱动场景切换与 Three.js 集成的开发者

上手与定制指南

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

1
需要 Node 24 及以上版本
2
npm install 后运行 npm run dev 启动本地开发服务器
3
npm run verify 使用系统 Chrome 执行类型检查、构建与浏览器验证，不下载浏览器
4
替换 src/content.ts 中的占位文字，并放入自己的照片与音乐
5
如需被搜索引擎收录，移除 index.html 中的 noindex, nofollow

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
运行环境要求 Node 24 及以上；npm run verify 依赖系统已安装的 Chrome 浏览器进行验证，不会自动下载浏览器。
index.html 默认包含 noindex, nofollow，页面默认不会被搜索引擎收录；如需可被搜索，必须自行移除该行。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

Requires Node 24+. `npm run verify` drives your **system Chrome** (no browser download step).
README 原文

`index.html` ships with `noindex, nofollow` — remove that line if you want your page searchable.
README 原文

https://github.com/illocean/birthday-greet/blob/main/LICENSE https://github.com/illocean/birthday-greet/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-09。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 73 / 100
技术栈: Vite · React
网站类型: 启动器

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-10-09
截图检查日期: 2026-10-09

目前没有记录演示链接。请依据仓库说明在本地评估；仅凭截图无法确认交互行为。

目录记录的主要技术栈是 Vite。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: [email protected] · 2026-10-09

查看当时使用的来源资料

SHA-256: c29cee1e16f03a62287a14a834d715134c75aa0afd16be944d68b602c3af3471

2026-10-09T08:59:40.635Z

来源文件 / 仓库

# birthday-greet

![The photo-wall scene](docs/preview.png)

A scroll-driven interactive birthday site in five scenes — envelope, card, record, photo wall,
letter. A static bundle: no backend, no runtime network calls. React 19 · Vite · TypeScript ·
Three.js · Motion.

It ships with authored placeholders. Replace the text in `src/content.ts` and drop in your own
photos and music — nothing personal is included.

## Quickstart

Requires Node 24+. `npm run verify` drives your **system Chrome** (no browser download step).

```bash
npm install
npm run dev       # http://localhost:5173
npm run verify    # typecheck + build + the full browser gate
```

## Personalize

| What | Where |
| --- | --- |
| Name, track title, letter, photo captions | `src/content.ts` — every field marked `PLACEHOLDER` |
| Photos | `public/photos/photo-1…6` — a `.mp4` in any slot renders as a looping clip |
| Music | `public/audio/song.mp3`, `public/audio/background.mp3` |
| Page title | `<title>` in `index.html` |

`npm run assets` and `npm run song` regenerate the placeholder media. `index.html` ships with
`noindex, nofollow` — remove that line if you want your page searchable.

Full documentation: [docs/README-full.md](docs/README-full.md).

## Credits

- Text effects — [Magic UI](https://magicui.design) (MIT), vendored
- Surface textures — [ambientCG](https://ambientcg.com) (CC0)
- Fonts — Great Vibes, Quicksand, The Girl Next Door (SIL OFL), self-hosted

## License

MIT — see [LICENSE](LICENSE).

反馈内容错误