orva以“学会”为目标的服务端框架文档

从这里开始 ​

如果你是第一次使用 orva，建议按这个顺序学习：

1. 快速开始：几分钟内跑起真实服务
2. Context 与响应：掌握请求读取和响应辅助
3. 路由与组合：学会拆分路由且不丢类型
4. 类型链路：理解 middleware、validator、RPC、OpenAPI 如何贯通
5. Recipes：开始做接近生产的应用

如果你是从其他 Node 或 Fetch 框架迁移过来，建议尽早阅读 从 Express / Hono 迁移。

orva 擅长什么 ​

• 基于 Fetch API 的小心智请求模型
• 明确的子路径导出，适合核心框架、RPC、adapters、validator、中间件、OpenAPI 分层使用
• 在运行时校验、handler 上下文、RPC 客户端、OpenAPI 输出之间复用契约
• 面向 Node、Bun、Deno、Serverless、Edge 的部署能力

第一段真正有用的服务 ​

import { createOrva } from 'orvajs';
import { serveNode } from 'orvajs/adapters/node';
import { requestId, secureHeaders } from 'orvajs/middlewares';

const app = createOrva()
  .use(requestId(), secureHeaders())
  .get('/health', (c) => c.json({
    ok: true,
    requestId: c.get('requestId'),
  }));

serveNode(app, { port: 3000 });

import { createOrva } from "orvajs";
import { serveNode } from "orvajs/adapters/node";
import { requestId, secureHeaders } from "orvajs/middlewares";
const app = createOrva().use(requestId(), secureHeaders()).get("/health", (c) => c.json({
  ok: true,
  requestId: c.get("requestId")
}));
serveNode(app, { port: 3e3 });

按任务学习 ​

参考资料入口 ​