返回模板

Vike 模板

Vike 入门模板,框架无关的 SSR 和基于文件的路由。

框架Vike
应用场景快速开始
Vike 入门模板,框架无关的 SSR 和基于文件的路由。

Vike Starter

这是一个基于 VikeReact 的示例项目,用来展示服务端渲染(SSR)、HTML 流式传输(Streaming)以及动态路由能力。这个模板演示了 Vike 的文件路由、与 EdgeOne Pages 的适配等特性。

📚 示例特性一览

该项目包含若干示例页面,用来演示不同的 Vike 能力:

Pages

  • / - 首页,包含 Hero 区、导航胶囊按钮,以及服务端渲染的耗时信息
  • /ssg - 静态站点生成(SSG)示例,页面在构建时预渲染,并展示构建时间
  • /posts/@category/@slug - 动态路由示例,支持两级 URL 参数(如 /posts/tech/hello-vike
  • /stream - HTML 流式传输示例,使用 React Suspense 和模拟的慢路径区块

主要特性

  • Vike + React SSR - 基于文件路由的服务端渲染
  • 🔄 HTML Streaming - 使用 React Suspense 的流式响应演示
  • 🛣️ 动态路由 - 支持 @category/@slug 模式的嵌套 URL 参数
  • 🎨 现代化 UI - 使用 Tailwind CSS、渐变聚光灯背景和发光卡片

🧞 常用命令

以下所有命令都需要在项目根目录的终端中执行:

Command说明
npm install安装依赖
npm run dev启动本地开发服务器,地址 localhost:3000
npm run build构建生产环境应用到 ./dist/
npm run start启动生产环境服务器(Node/Express)

Vike 会在 pages/ 目录中查找 +Page.tsx 等路由相关文件。每个页面会根据文件名和 Vike 约定暴露为对应路由。

components/ 目录本身没有特殊约定,我们在这里放了可复用的 React 组件(例如 Hero 区)。

任何静态资源(如图片)可以放在 public/ 目录(如果你创建了该目录)。

🛠️ 技术栈

📖 了解更多