---
title: "Wakuとは？Reactのミニマルフレームワークの導入とルーティング・Next.jsとの違い【1.0.0-rc.4】"
url: "https://www.issoh.co.jp/tech/details/3620/"
published: 2024-09-19
updated: 2026-11-02
categories: ["React"]
publisher: "株式会社一創"
---

# Wakuとは？Reactのミニマルフレームワークの導入とルーティング・Next.jsとの違い【1.0.0-rc.4】

Waku（ワク）は、React Server Components（RSC）を前提に作られた小さなReactフレームワークです。npmの最新は 1.0.0-rc.4（2026年10月22日公開）で、1.0はリリース候補の段階にあります。この記事では、`npm create waku@latest` で作る雛形の中身から、`src/pages` のルーティング、静的と動的の切り替え、デプロイ、RC後に入った破壊的変更までを、公式リポジトリの記述と手元での実行結果に沿って整理します。Next.jsとどちらを選ぶかの判断材料も最後にまとめました。

## まとめ

- WakuはReact 19のサーバーコンポーネントとサーバーアクションを、独自APIをほとんど足さずに使うためのフレームワークです。npmパッケージ名は `waku`、リポジトリは `wakujs/waku` です。
- 2026年11月2日時点のnpm最新は 1.0.0-rc.4。`npm install waku` で入るのはRC版で、安定版1.0はまだ出ていません。
- 動作条件はNode.js 22.15.0以上（22系・24系・26系）。Reactは `~19.3.1` 指定で、19.3系に固定されます。
- ページとレイアウトは既定で静的です。`getConfig` で `render: 'dynamic'` を宣言しないページは、ビルド時の内容のまま配信されます。
- 2026年8月25日のRCで「公開APIは確定」と告知された後も、rc.2〜rc.4で `_root.tsx` の扱いや `Link` の引数形式が変わりました。RCの告知記事にあるコード例の一部はrc.4では動きません。
- Next.jsとの違いは、キャッシュと再検証をフレームワークが管理するかどうかです。画像最適化やキャッシュ・再検証などの統合機能を重視するならNext.js、RSCの素の動きを自分で組み立てたいならWakuが合います。

## Wakuの設計方針と1.0.0-rc.4の現在地

### static at build time, fresh at request time, cache explicitly という設計

Wakuの[公式ドキュメントの設計思想ページ](https://waku.gg/guides/philosophy)は、レンダリングの原則を「static at build time, fresh at request time, cache explicitly」と要約しています。静的ページはビルド時に一度だけ実行され、次のビルドまで変わりません。`render: 'dynamic'` と宣言したページはリクエストごとに実行されます。その間に入る暗黙のキャッシュや再検証の仕組みは持たず、キャッシュが必要ならアプリ側で明示的に足します。

コンポーネントは既定でサーバーで実行され、状態やイベントハンドラが要る箇所にだけ `'use client'` を付けます。データ取得はサーバーコンポーネントの中で `await` するだけで、専用のデータ取得APIはありません。サーバーとクライアントの境界の考え方は、[React Server Components（RSC）のサーバーとクライアントの違い](/tech/details/4003/)で先に押さえておくと、以降のコードが読みやすくなります。

### RC版の位置づけとwakujs/wakuリポジトリの規模

[2026年8月25日の公式ブログ「Waku 1.0 (RC)」](https://waku.gg/blog/waku-v1-rc)は、RCの公開で公開APIを確定し、不安定なAPIには `unstable_` などの印を付けると告知しました。同じ記事は、v1を変えられる最後のフィードバック募集だとも書いています。その後もrc.1〜rc.4が出ており、rc.4がnpmの `latest` です。

リポジトリは個人アカウントの `dai-shi/waku` から組織アカウントの `wakujs/waku` へ移管されています。旧URLは別のフォークが同じパスを使っているためリダイレクトされず、`github.com/dai-shi/waku` を開くと本体ではないリポジトリに着きます。issueやリリースノートは [wakujs/wakuのReleases](https://github.com/wakujs/waku/releases) を直接開いてください。

| 項目          | 値（2026-11-02時点）              |
| ----------- | ---------------------------- |
| npm latest  | 1.0.0-rc.4（2026-10-22）       |
| Node.js     | ^26.0.0 / ^24.0.0 / ^22.15.0 |
| React（peer） | \~19.3.1                     |
| Vite（依存）    | ^8.0.13                      |
| Hono（依存）    | ^4.12.14                     |
| GitHubスター   | 6,481                        |
| 週次DL        | 43,119（10/23〜10/29）          |
| ライセンス       | MIT                          |

週次ダウンロードは1巡目の調査時（2026年7月25日〜31日の24,452件）から約1.8倍に増えました。ただし利用者が増えても日本語の情報はまだ少ないため、採用前には、認証・デプロイ・障害対応など自社で必要な実装について、利用する版に対応した日本語資料があるかを確認してください。

## npm create waku@latestで作るプロジェクトと動作条件

### Node.js 22.15以上・React 19.3系という動作条件

[npmのwakuパッケージ](https://www.npmjs.com/package/waku)の 1.0.0-rc.4 は、`engines.node` が `^26.0.0 || ^24.0.0 || ^22.15.0` です。Node.js 20系は対象外で、22系でも 22.15.0 未満は外れます。

Reactの指定は厳しめです。`react`・`react-dom`・`react-server-dom-webpack` の peerDependencies がいずれも `~19.3.1` で、チルダ指定なので19.3系のパッチ更新しか受け付けません。[rc.1（2026年9月18日）のリリースノート](https://github.com/wakujs/waku/releases/tag/v1.0.0-rc.1)には「Requires React 19.3」とあり、19.2系のままではrc.1以降に上げられません。React 19.3で入った機能と19.2からの更新手順は[React 19.3の新機能と19.2からの更新手順](/tech/details/18249/)にまとめています。逆に言えば、React 19.4が出てもWaku側が対応するまでReactを先に上げられません。

### 雛形の中身とReact Compiler・Tailwind CSS 4の初期設定

2026年11月2日に macOS・Node.js 26.5.0 で `npm create waku@latest` を実行すると、waku 1.0.0-rc.4 とReact 19.3.1 が入ったプロジェクトができました。

```
npm create waku@latest
cd waku-project
npm run dev
```

生成されたファイルは次のとおりです。作成時に依存のインストールまで済みます。

```
waku-project/
├── public/
│   ├── images/favicon.png
│   └── robots.txt
├── src/
│   ├── components/      counter.tsx・header.tsx・footer.tsx
│   ├── middleware/      no-trailing-slash.ts（Honoのミドルウェア）
│   ├── pages/
│   │   ├── _layout.tsx
│   │   ├── about.tsx
│   │   └── index.tsx
│   ├── global.d.ts
│   └── styles.css
├── package.json
├── tsconfig.json
└── waku.config.ts
```

雛形の `waku.config.ts` には、最初からTailwind CSS 4とReact Compilerが組み込まれています。devDependenciesには `babel-plugin-react-compiler` と `@rolldown/plugin-babel` が入り、Viteのプラグインとして `reactCompilerPreset()` が登録されます。React Compilerを使わないなら、この `babel(...)` の行、`babel` と `reactCompilerPreset` のインポート、および `@rolldown/plugin-babel` と `babel-plugin-react-compiler` の依存を削除します。`@vitejs/plugin-react` v6でReact Compilerを有効にする設定の詳細は[@vitejs/plugin-react v6.1の導入とReact Compilerの設定](/tech/details/2680/)で解説しています。

```
// ./waku.config.ts（雛形のまま）
import babel from '@rolldown/plugin-babel';
import tailwindcss from '@tailwindcss/vite';
import react, { reactCompilerPreset } from '@vitejs/plugin-react';
import { defineConfig } from 'waku/config';

export default defineConfig({
  vite: {
    plugins: [
      tailwindcss(),
      react(),
      babel({ presets: [reactCompilerPreset()] }),
    ],
  },
});
```

scripts は `dev`・`build`・`start` に加えて `typegen`（`waku router typegen`）があります。`npm run typegen` を実行すると `src/pages.gen.ts` が生成され、ページのパスと `getConfig` の型が登録されます。このファイルは手で編集しません。開発サーバーは既定で3000番、`npm run start` は8080番から空いている番号を探し、環境変数 `PORT` を指定するとその番号で起動します。

## src/pagesのファイルルーティングと静的・動的の切り替え

### index・\[slug\]・\[…catchAll\]・\_layoutとURLの対応

ルートは `src/pages` 配下のファイル配置で決まります。各ファイルはReactコンポーネントをデフォルトエクスポートし、必要なら名前付きエクスポートの `getConfig` を添えます。

| ファイル               | URL            | 受け取るprops  |
| ------------------ | -------------- | ---------- |
| index.tsx          | /              | path・query |
| blog/\[slug\].tsx  | /blog/任意       | slug（文字列）  |
| docs/\[…path\].tsx | /docs/以下すべて    | path（配列）   |
| \_layout.tsx       | 配下全体を包む        | children   |
| \_root.tsx         | html・head・body | children   |

型付きでセグメントを受け取るときは `waku/router` の `PageProps` を使います。`PageProps<'/blog/[slug]'>` は `path`・`slug`・`query` を持つ型になります。`_api`（APIルート）・`_slices`（スライス）・`_interceptors`（レンダリングの前後処理）は特別な役割を持つディレクトリです。`_components`・`_hooks`・`_actions` の3つはルーティングの対象外なので、ページと同じ階層に部品を置きたいときに使えます。

### getConfig省略時の静的生成とビルド時刻の固定

[公式README](https://github.com/wakujs/waku/blob/main/README.md)は、レイアウト・ページ・スライスの既定を `static`、APIハンドラの既定を `dynamic` と定めています。この既定が実際にどう効くかを、`getConfig` を書かないページと `render: 'dynamic'` のページを並べて確かめました。

```
// ./src/pages/stale.tsx（getConfigなし）
export default async function StalePage() {
  return <p>{new Date().toISOString()}</p>;
}

// ./src/pages/now.tsx
export default async function NowPage() {
  return <p>{new Date().toISOString()}</p>;
}

export const getConfig = async () => {
  return { render: 'dynamic' } as const;
};
```

`npm run build` の後に `node dist/serve-node.js` で起動し、2回ずつ取得した結果です。`/now` は 16:24:16.670 → 16:24:19.372（UTC）とリクエストごとに変わりました。`/stale` は2回ともビルド時刻の 16:24:02.137 のままで、`dist/public/stale/` にHTMLとして書き出されていました。ビルドは通り、エラーも警告も出ません。ログイン状態や在庫のようにリクエストごとに変わる内容を出すページは、`render: 'dynamic'` を書き忘れると古い表示が配信され続けます。

動的セグメントを静的にプリレンダリングするときは、ビルド時に生成するパスを `staticPaths` で渡す必要があります。

```
// ./src/pages/blog/[slug].tsx
import type { PageProps } from 'waku/router';

export default async function BlogArticlePage({
  slug,
}: PageProps<'/blog/[slug]'>) {
  const data = await getData(slug);
  return <article>{data.title}</article>;
}

const getData = async (slug: string) => {
  return { title: slug };
};

export const getConfig = async () => {
  return {
    render: 'static',
    staticPaths: ['introducing-waku', 'introducing-pages-router'],
  } as const;
};
```

`staticPaths` は `getConfig` の中で非同期に組み立てられるので、CMSやMarkdownファイルの一覧から生成できます。ネストしたセグメントでは `[['same-category', 'some-product']]` のように、セグメントの順に並べた配列を渡します。

### Linkとrouterによる遷移とrc.4でのURL文字列への統一

内部リンクには `waku` からインポートする `Link` を使い、遷移先を `to` にURL文字列で渡します。クエリ付きなら `<Link to="/search?q=waku">` と書きます。クライアントコンポーネントでは `useRouter` が現在の `path` と `query` を返し、`push`・`replace`・`prefetch`・`reload`・`back`・`forward` で遷移・先読み・再読み込みを操作できます。ただし、`prefetch` は先読みだけを行い、画面は移動しません。

ここはrc.4で変わった箇所です。RCの告知記事は `router.push({ to: '/posts/[slug]', params: { slug } })` のようにルートのパターンとパラメータをオブジェクトで渡す型安全な遷移を紹介していました。rc.4の[PR #2351](https://github.com/wakujs/waku/pull/2351)でこの形式は廃止され、遷移APIはURL文字列だけを受け取ります。型付きのURLが欲しい場合は、[Typed Routesガイド](https://waku.gg/guides/typed-routes)にある `unstable_createRouteHref` で文字列を組み立てます。

```
// ./src/lib/routes.ts
import { unstable_createRouteHref as createRouteHref } from 'waku/router';

export const post = createRouteHref({ path: '/posts/[slug]' });

// 使う側
<Link to={post({ params: { slug: 'hello-world' } })}>記事へ</Link>
```

名前のとおり `unstable_` の付いた不安定なAPIです。RC時点の記事やサンプルを写すと、オブジェクト形式の `to` が型エラーになります。

## サーバーコンポーネント・Server Actions・APIルートの書き分け

### ‘use client’を付ける境界の判断

既定がサーバー実行なので、指示子を書くのはクライアント側だけです。データベースへの問い合わせはサーバーコンポーネントの中に直接書けます。次のコードは概念例で、`some-db` と `Gallery` は実際のDBクライアントと表示コンポーネントに置き換える必要があります。

```
import db from 'some-db';
import { Gallery } from '../components/gallery';

export const Store = async () => {
  const products = await db.query('SELECT * FROM products');
  return <Gallery products={products} />;
};
```

`useState` やクリックハンドラを使うコンポーネントは、ファイル先頭に `'use client'` を書きます。プロジェクト直下の `private` フォルダに置いたファイルは、サーバーコンポーネントからだけ読めます。環境変数も既定ではサーバー専用で、クライアントから読ませたいものだけ `WAKU_PUBLIC_` 接頭辞を付けます。サーバーからは `waku` の `getEnv('SECRET_KEY')` で読みます。境界をまたいで送られるデータの中身は[RSC Payloadの読み方と取得手順](/tech/details/4526/)で確認できます。

### ‘use server’によるミューテーションとフォームの引数

更新処理はサーバーアクションとして書きます。ファイル先頭に `'use server'` を置くと、そのファイルからエクスポートした関数がすべてアクションになり、クライアントコンポーネントから通常の関数としてインポートできます。次の例の `some-db` も概念上のDBクライアントです。

```
// ./src/actions/send-message.ts
'use server';

import db from 'some-db';

export async function sendMessage(formData: FormData) {
  const message = formData.get('message');
  if (typeof message !== 'string' || message.trim() === '') {
    throw new Error('メッセージを入力してください');
  }
  await db.messages.create(message);
}
```

```
// ./src/components/contact-form.tsx
'use client';

import { sendMessage } from '../actions/send-message';

export const ContactForm = () => {
  return (
    <form action={sendMessage}>
      <textarea name="message" rows={4} />
      <button type="submit">Send</button>
    </form>
  );
};
```

READMEの例は `sendMessage(message: string)` をボタンの `onClick` から呼ぶ形です。同じ関数を `<form action={...}>` に渡すと、Reactは `FormData` を1個渡して呼ぶため、文字列のつもりの引数に `FormData` が入ります。フォーム送信から呼ぶ関数は `FormData` を受ける形で書いてください。また、`'use server'` を付けた関数は外部から呼べるエンドポイントになります。READMEも、関数の中で認証と権限を確認しない限り保護されないと注意しています。

### src/pages/\_apiのエンドポイントとgetRequestによるリクエスト参照

HTTPエンドポイントは `src/pages/_api` に置き、`GET`・`POST` などHTTPメソッド名の関数をエクスポートします。rc.4では `QUERY` メソッドも対象です。動的セグメントのパラメータは `ApiContext` で型付けされます。

```
// ./src/pages/_api/users/[id].ts
import type { ApiContext } from 'waku/router';

export async function GET(
  _req: Request,
  { params }: ApiContext<'/users/[id]'>,
) {
  const { id } = params;
  return Response.json({ id, message: `Hello user ${id}` });
}
```

公開URLからは `_api` が取り除かれます。`src/pages/_api/hello.ts` を置いて確かめると、`/hello` は200で応答し、`/_api/hello` は404でした。フェッチ先に `/_api/` を付けると届きません。RSSやサイトマップのように内容が固定のレスポンスは、APIルートでも `getConfig` に `render: 'static'` を書けば静的ファイルとして出力できます。

ページやアクションの中でリクエストヘッダーを読むには、`waku/router/server` の `getRequest()` を使います。rc.4で `unstable_getRequest` から改名されて正式なAPIになり、旧名は非推奨として残っています。ヘッダーは `getRequest().headers.get('user-agent')` のように取得します。認証やヘッダー付与のようにリクエスト全体に掛ける処理は、`src/middleware` に置くHonoのミドルウェアが担当します。

## メタデータの書き方とデプロイ先ごとの手順

### title・metaのhoistingと\_root.tsxに必要なcharset・viewport

Wakuはメタデータ専用のAPIを持ちません。`title`・`meta`・`link` をページやレイアウトのJSXに書くと、ドキュメントのheadへ引き上げられます。共通のファビコンやOGP画像は `_layout.tsx` に、ページごとのタイトルと説明文は各ページに書きます。rc.2では、ページ側の title・description・OGタグがレイアウトの値を上書きするよう修正されました。

注意が要るのは `_root.tsx` で html・head・body を自分で書く場合です。[rc.2（2026年9月28日）](https://github.com/wakujs/waku/releases/tag/v1.0.0-rc.2)で、`charset` と `viewport` のmetaはフレームワークのheadから既定のルートコンポーネントへ移されました。独自の `_root.tsx` を置いているプロジェクトは、この2行を自分で書かないと出力から消えます。

```
// ./src/pages/_root.tsx
import type { ReactNode } from 'react';

export default async function RootElement({ children }: { children: ReactNode }) {
  return (
    <html lang="ja">
      <head>
        <meta charSet="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
      </head>
      <body>{children}</body>
    </html>
  );
}

export const getConfig = async () => {
  return { render: 'static' } as const;
};
```

既定のルートには Waku のエラーバウンダリも含まれているので、独自のルートを置くときはエラーバウンダリも自分で用意します。

### Node.js・Vercel・Netlify・Cloudflareのデプロイと完全静的出力

既定のNode.jsなら `waku start` で本番サーバーが起動します。Dockerなどで単体動作させるときは `dist` フォルダだけをコピーし、`node dist/serve-node.js` を実行します。

| デプロイ先              | 手順                                           | 区分  |
| ------------------ | -------------------------------------------- | --- |
| Vercel             | vercel                                       | 正式  |
| Netlify            | NETLIFY=1 npm run build → netlify deploy     | 正式  |
| Cloudflare Workers | CLOUDFLARE=1 npm run build → wrangler deploy | 正式  |
| Deno Deploy        | waku.server.tsx でアダプタ指定                      | 実験的 |
| Bun                | waku.server.tsx でアダプタ指定                      | 実験的 |
| AWS Lambda         | waku.server.tsx でアダプタ指定                      | 実験的 |

Vercel・Netlify・Cloudflareはコマンドだけで済み、`src/waku.server.tsx` は要りません。サーバーエントリを自分で書くのは、実験的なランタイムを指定する場合と、関数を一切デプロイしない完全静的サイトとして出す場合です。後者の書き方は次のとおりです。

```
// ./src/waku.server.tsx（完全静的で出す場合）
import { fsRouter } from 'waku';
import adapter from 'waku/adapters/cloudflare';

export default adapter(fsRouter(import.meta.glob('./pages/**/*.{tsx,ts}')), {
  static: true,
});
```

READMEはこの例を「関数のデプロイを避けたい上級者向け」の節に置き、Pure SSGでは動的レンダリング・サーバーアクション・APIルートが動かないと明記しています。動的ページを持つアプリに `static: true` を付けると、それらのURLは404になります。通常の構成では付けません。特定のホスティングに寄せない最小の出力が欲しい場合は、`waku.config.ts` で `unstable_adapter: 'waku/adapters/edge'` を指定します。

## 0.2x系からrc.4までの破壊的変更とWakuを採用しない判断基準

### CHANGELOGとGitHub Releasesに分かれた変更履歴

日本語で読めるWakuの解説記事の多くは0.19〜0.21世代を前提にしています。その後の変更を追うときは、記録場所が途中で変わったことに注意が要ります。[リポジトリのCHANGELOG.md](https://github.com/wakujs/waku/blob/main/CHANGELOG.md)は冒頭で「v1.0.0-alpha.0 以降はGitHub Releasesを見よ」と書き、0.27.5（2025年12月17日）で更新が止まっています。1.0系の変更はReleasesにしか載っていません。

| 版             | 日付         | コードの書き換えが要る変更                     |
| ------------- | ---------- | --------------------------------- |
| 0.25.0        | 2025-08-12 | ページの既定を静的に変更                      |
| 0.27.0        | 2025-10-27 | アダプタ方式の刷新                         |
| 1.0.0-alpha.0 | 2025-12-23 | エントリを waku.server／waku.client へ改名 |
| 1.0.0-alpha.1 | 2026-01-06 | api/ を \_api/ へ改名しURLの接頭辞を除去      |
| 1.0.0-beta.0  | 2026-05-12 | fsRouterのbase削除・Node 20終了         |
| 1.0.0-rc.0    | 2026-08-25 | unstable\_getContext 削除           |
| 1.0.0-rc.1    | 2026-09-18 | React 19.3必須                      |
| 1.0.0-rc.2    | 2026-09-28 | charset・viewportを既定ルートへ移動         |
| 1.0.0-rc.3    | 2026-10-06 | unstable\_defineRouter の再設計       |
| 1.0.0-rc.4    | 2026-10-22 | 遷移のオブジェクト形式を廃止・getRequest         |

0.2x系のAPIルートを持ち込む場合、`src/pages/api/` は `src/pages/_api/` に移し、公開URLから接頭辞が外れる点に合わせます。`/api/contact` というURLを残したいなら、ファイルを `src/pages/_api/api/contact.ts` に置きます。リクエスト情報を `waku/server` の `unstable_getContext()` から取っていたコードは、rc.4では `waku/router/server` の `getRequest()` に置き換えます。rc.0〜rc.3での名前は `unstable_getRequest()` です。

### RC宣言後も続いた変更と「公開APIの確定」の範囲

表の後半を見ると、RCの告知で「公開APIは確定」とされた8月25日以降も、2か月で4回の書き換えが入っています。内訳を見ると、確定の範囲がどこまでかが分かります。

- rc.3の `unstable_defineRouter` と、rc.4で廃止された型付き遷移のオブジェクト形式は、どちらも `unstable_` 系か実験的扱いのAPIでした。
- 一方、rc.1のReact 19.3必須化と、rc.2のcharset・viewportの移動は、`unstable_` の付かない部分に影響します。前者は依存の更新、後者は独自の `_root.tsx` を持つプロジェクトの出力変更です。
- RC告知記事のコード例（`router.push({ to, params })`）は、rc.4ではそのまま動きません。

RCの「確定」は、`src/pages` のファイル規約、`getConfig`、`Link` と `useRouter` の文字列API、`'use client'` と `'use server'` といった中核の書き方は変えない、という意味に読むのが実態に合います。`unstable_` の付いたAPIや依存のReactの版は今後も動く前提で、RC版を使うなら版を固定してリリースノートを読んでから上げる運用が要ります。

### ベータ・RC運用と依存固定を許容できない案件での見送り基準

公式の[Use Casesガイド](https://waku.gg/guides/use-cases)は、向くかどうかは規模ではなく、フレームワークにどこまで任せたいかで決まると書いています。そのうえで、認証・画像処理・国際化・分析などをフレームワークの統合機能に任せたい場合、フレームワーク管理の分散キャッシュと再検証が中核要件の場合、1社のプラットフォームでライフサイクル全体を管理したい場合は、別のフレームワークを検討するよう勧めています。これに版の事情を加えると、見送るべき条件は次の3つです。

第一に、依存パッケージは安定版だけと決めている案件です。npmの `latest` がRC版を指しているため、`npm install waku` はプレリリースの導入になります。

第二に、Reactの版を自分たちの都合で上げたい案件です。`~19.3.1` は19.3系への固定なので、他のライブラリがReact 19.4を求め始めたときに、Waku側の対応を待つことになります。

第三に、数年単位の保守で担当者の交代が見込まれ、依存更新と移行検証の担当・予算を確保できない業務システムです。2025年8月から2026年10月までの間に、レンダリングの既定・デプロイ定義・APIルートの配置・Reactの要件が入れ替わりました。リリースノートを読んで追随する担当者が常にいなければ回りません。長期運用が前提の[業務用・Webアプリ開発](/service/apps/business/)では、Next.jsのように安定版とサポート期間が明示されたフレームワークを選ぶ方が保守計画を立てやすくなります。

逆に合うのは、コーポレートサイトやドキュメントのように静的生成が中心で、改修を短いサイクルで回せるサイトです。RSCの構造をそのまま扱えるので、React 19の設計を試す社内の試作にも向きます。ただしRSCの実装には[React2Shell（CVE-2025-55182）をはじめとする脆弱性](/tech/details/10142/)が続いているため、試作でも依存の版は新しく保ちます。

## WakuとNext.js・Astroの違い

Wakuの[公式のComparisonページ](https://waku.gg/guides/comparison)（2026年7月時点の各公式ドキュメントで確認したと明記）は、主要フレームワークの違いを次のように整理しています。

| 観点              | Waku    | Next.js | Astro   |
| --------------- | ------- | ------- | ------- |
| RSC             | 対応      | 対応      | 設計に含まない |
| 静的ページ内の動的領域     | 対応      | 対応      | 対応      |
| フレームワーク管理のキャッシュ | 設計に含まない | 対応      | 設計に含まない |
| React以外のUIライブラリ | 設計に含まない | 設計に含まない | 対応      |
| デプロイアダプタ        | 対応      | 実験的     | 対応      |

決定的な違いはキャッシュです。Next.jsはルート全体から個々の関数までキャッシュと再検証の仕組みをフレームワークが持ち、アプリのライフサイクルの多くを引き受けます。Wakuは暗黙のキャッシュを持たず、静的か毎リクエストかを宣言するだけです。キャッシュの挙動を読み解く手間がない代わりに、キャッシュが必要なら自分で実装します。Next.js 16のApp Routerで最小構成を動かす手順と採用判断は[Next.jsとは？16系App Routerで最小アプリを動かす手順と採用判断](/tech/details/17373/)で扱っています。

Astroとの違いはUIモデルです。Astroは複数のUIライブラリをアイランドとして混在させるコンテンツ中心の設計で、WakuはサーバーコンポーネントもクライアントコンポーネントもReactの1つのモデルで書きます。静的サイトから始めて後から動的な機能を増やすなら、Reactだけで書き続けられるWakuの方が書き方の切り替えが起きません。Astro側の特徴は[Astroフレームワークの特徴とNext.jsとの使い分け](/tech/details/15369/)で比較しています。

## よくある質問

### Waku.jsとWakuは別のものですか？

同じものです。npmのパッケージ名は `waku`、公式サイトは waku.gg で、「Waku.js」「waku js」はJavaScript製であることを示す通称です。読み方は公式READMEが「Waku (wah-ku) or わく」と書いています。分散型メッセージングプロトコルの Waku（npmの `@waku/sdk` など）は名前が同じだけの別プロジェクトです。

### Wakuの最新バージョンと安定版1.0の公開時期は？

2026年11月2日時点のnpm最新は 1.0.0-rc.4 で、2026年10月22日に公開されました。安定版1.0の公開日は告知されていません。最新の版は `npm view waku dist-tags` で確認できます。安定版だけを使う方針の環境では、RC版を導入する前に版指定の運用を決めておく必要があります。

### 既存のReactプロジェクトにWakuを後から導入できますか？

ライブラリとして足す形にはなりません。Wakuはビルド基盤とルーティングを含むフレームワークなので、画面を `src/pages` の構造へ移す作業が要ります。前提としてReactを19.3系、Node.jsを22.15.0以上に揃えます。静的ホスティングだけで完結していた構成には、動的ページを使う時点でサーバー実行環境が加わります。

### ルーティングをファイル配置ではなくコードで定義できますか？

できます。ファイル配置の解決は `fsRouter` が担い、コードで組み立てる場合は `import { createPages } from 'waku';` を使います。さらに低レベルな `unstable_defineRouter` は `waku/router/server` から取得しますが、rc.3で再設計されたばかりの不安定なAPIです。雛形と公式ドキュメントの説明はファイルルーティングが中心なので、特段の理由がなければファイル配置に寄せる方が情報を探しやすくなります。

### Wakuで使う状態管理ライブラリは何がよいですか？

公式READMEは、グローバルな状態管理にJotaiを推奨しています。理由として挙げているのはアトム単位のモデルによる性能と拡張性で、ZustandやValtioを含むReactの状態管理ライブラリ全般とも組み合わせられるとしています。状態はクライアントコンポーネントの中でだけ持てるため、サーバーコンポーネントで取得したデータはpropsで渡し、操作が必要な部分だけをクライアント側の状態にします。

## 関連記事

- [React Server Components（RSC）とは？サーバーとクライアントの違い・使い分けと確認方法【React 19.3】](/tech/details/4003/)
- [React 19.3の新機能｜ViewTransition・Fragment ref・browser()の実装と19.2からの更新手順](/tech/details/18249/)
- [Next.jsとは？16系App Routerで最小アプリを動かす手順と採用判断](/tech/details/17373/)
- [@vitejs/plugin-react とは？v6.1の導入とvite.config設定・React Compiler・SWC版との違い](/tech/details/2680/)
- [Astroフレームワークとは？特徴と使い方・Next.jsとの使い分けを解説【2026年版】](/tech/details/15369/)

---

出典: [Wakuとは？Reactのミニマルフレームワークの導入とルーティング・Next.jsとの違い【1.0.0-rc.4】](<https://www.issoh.co.jp/tech/details/3620/>)（株式会社一創）
