Waku 本地开发指南
使用 Waku 构建 React Server Components 应用，轻量 RSC 框架，本地默认 localhost:3000 开发。
Waku（原名 Wakuworks）是面向 React Server Components（RSC） 的 minimal 全栈框架，由 Vite 驱动，API 简洁，适合希望体验 RSC 又不想引入完整 Next.js 栈的项目。
快速开始
npm create waku@latest
cd my-waku-app
npm install
npm run dev默认 localhost 访问
| 用途 | 地址 |
|---|---|
| 开发服务器 | http://localhost:3000 |
可在 waku.config.ts 或 Vite 配置中调整 server.port。
常用命令
| 命令 | 说明 |
|---|---|
npm run dev | 开发模式（RSC + HMR） |
npm run build | 生产构建 |
npm run start | 运行生产服务器 |
核心概念
- Server Components：默认在服务端渲染，减少客户端 JS
- 文件路由：
pages/目录定义路由 - 基于 Vite，构建与开发速度与现代工具链一致
与 Next.js 对比
Waku 更轻量，专注 RSC 与 Vite 生态；Next.js 功能更全面（中间件、Image、部署集成等）。适合学习 RSC 或中小型 React 全栈项目。
小结
Waku 本地开发默认 **http://localhost:3000**，是体验 React Server Components 的轻量选择。