React

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

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

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

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

2026年8月25日の公式ブログ「Waku 1.0 (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 を直接開いてください。

項目 値(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パッケージの 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日)のリリースノートには「Requires React 19.3」とあり、19.2系のままではrc.1以降に上げられません。React 19.3で入った機能と19.2からの更新手順はReact 19.3の新機能と19.2からの更新手順にまとめています。逆に言えば、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の設定で解説しています。

// ./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は、レイアウト・ページ・スライスの既定を 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でこの形式は廃止され、遷移APIはURL文字列だけを受け取ります。型付きのURLが欲しい場合は、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の読み方と取得手順で確認できます。

‘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日)で、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は冒頭で「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ガイドは、向くかどうかは規模ではなく、フレームワークにどこまで任せたいかで決まると書いています。そのうえで、認証・画像処理・国際化・分析などをフレームワークの統合機能に任せたい場合、フレームワーク管理の分散キャッシュと再検証が中核要件の場合、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アプリ開発では、Next.jsのように安定版とサポート期間が明示されたフレームワークを選ぶ方が保守計画を立てやすくなります。

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

WakuとNext.js・Astroの違い

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

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

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

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

よくある質問

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で渡し、操作が必要な部分だけをクライアント側の状態にします。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.18 テックブログ Java脆弱性CVE-2026-114938(Java4Shell)とは?影響版・修正版と回避フラグの実装手順
  2. 2026.11.11 テックブログ Vite 脆弱性 GHSA-p4f5-76q4-ffq7:開発サーバーRCEの確認と修正版への更新
  3. 2026.11.18 テックブログ 楽天証券の不正アクセス:最大約447万口座の対象確認と、テスト環境に本番データを置かない実装
  4. 2026.11.17 テックブログ チャットプラスの不正アクセス:導入企業がチャット履歴の個人データと報告準備を確かめる手順
  5. 2026.11.19 テックブログ 大崎電気のランサムウェア被害|スマートメーター生産停止の経緯と工場の生産系を守る手順

RELATED POSTS 関連記事

目次