❤️‍🔥

Hono + Next.js に RPC と hono-openapi と valibot を付けて快適に開発する

に公開

Hono、すごく盛り上がってますね。
どこで盛り上がってるんだ?という人は ↓ この辺の記事おすすめです。


この記事で扱うフレームワーク・ライブラリについて、なぜ選んでいるのか軽く触れておきます。

Next.js
自分は Next 12 まで、つまり Page Router の時代まで Next を愛用していました。そして App Router が到来し、良いじゃん!と思ったのは束の間、開発環境が死ぬほど重くなり、あまりのストレスに MacBook を投げそうになった時に捨てることを決断し、そこからは Vite、Remix→React Router V7、Tanstack Start などなどを使ってきました。そして、Next 16 にまで更新された頃、再び触る機会が舞い込んできました、「はやい!!!」、ということで最近割と使ってます。

RPC
Hono の RPC はお手軽だしクライアントが TypeScript なら使わない手はない(?)

hono-openapi
@hono/zod-openapi の方が圧倒的に情報が出てくるし、ユーザー数も多いと思いますが、OpenAPIHono クラスじゃなくて Hono クラスを使いたいのと、後述の valibot を使いたかったので hono-openapi の方を使っています。
そもそも RPC あるならいらないのではという意見もあると思いますが、なんやかんや Swagger とか Scalar とかあると便利ですよね。

valibot
zod で良いと思います。バンドルサイズが小さい方が心にゆとりができる人だけ使ったら良いと思います。


大してやることないので簡単にだけ説明します。

npm create hono@latest

をして nextjs テンプレートを選びます。

変更が必要なファイルだけ以下に列挙していきます。

app/api/[[...route]]/route.ts
import { handle } from "hono/vercel";

import { swaggerUI } from "@hono/swagger-ui";
import { Hono } from "hono";
import { openAPIRouteHandler } from "hono-openapi";
import { helloRoute } from "../routes/hello";

const routes = new Hono().route("/hello", helloRoute);

const app = new Hono()
  .basePath("/api")
  .get(
    "/openapi.json",
    openAPIRouteHandler(routes, {
      documentation: {
        info: {
          title: "Hono API",
          version: "1.0.0",
          description: "API documentation for Hono",
        },
        servers: [
          { url: "http://localhost:3000/api", description: "API Server" },
        ],
      },
    })
  )
  .get("/docs", swaggerUI({ url: "/api/openapi.json" }))
  .route("/", routes);

export { app };
export type AppType = typeof app;

const handler = handle(app);

export const GET = handler;
export const POST = handler;
export const PUT = handler;
export const PATCH = handler;
export const DELETE = handler;
app/api/routes/hello.ts
import { Hono } from "hono";
import { describeRoute, resolver, validator } from "hono-openapi";

import * as v from "valibot";
const querySchema = v.object({
  name: v.optional(v.string()),
});
const responseSchema = v.string();

/* zod 派の人はこちら */
// import { z } from "zod";
// const querySchema = z.object({
//   name: z.string().optional(),
// });
// const responseSchema = z.string();

const helloRoute = new Hono().get(
  "/",
  describeRoute({
    description: "Say hello to the user",
    responses: {
      200: {
        description: "Successful response",
        content: {
          "text/plain": { schema: resolver(responseSchema) },
        },
      },
    },
  }),
  validator("query", querySchema),
  (c) => {
    const query = c.req.valid("query");
    return c.text(`Hello ${query?.name ?? "Hono"}!`);
  }
);

export { helloRoute };
app/page.tsx
"use client";
import { hc } from "hono/client";
import { useEffect, useState } from "react";
import type { AppType } from "./api/[[...route]]/route";

const client = hc<AppType>("/");

export default function Home() {
  const [message, setMessage] = useState<string>();

  useEffect(() => {
    const fetchData = async () => {
      const res = await client.api.hello.$get({
        query: {},
      });
      if (res.ok) {
        const data = await res.text();
        setMessage(data);
      }
    };
    fetchData();
  }, []);

  if (!message) return <p>Loading...</p>;

  return <p>{message}</p>;
}

解説することもないくらい簡単ですね。
Hono 使っていきましょう!

Discussion