📘

React NativeでもVRTがしたい!Chromatic導入までの道のり

に公開
2026/03/20

この記事は、Unipos Advent Calendar 2025の15日目の記事。

背景

UIを作っているときにわざわざシミュレーターや実機で確認するのが手間だった。また、UI変更時の差分がわからず、デグレに気づきにくい状態だった。

僕たちのプロダクトはNext.jsで開発しているWeb版がすでにChromaticに対応していた。そこでReact Nativeで作成した一部のUIもChromaticで見られるようにしたいと考えた。この記事ではその導入過程を紹介する。

Storybookのバージョンを上げる

v7からv9への移行

まずStorybookをv7からv9へ移行した。Storybook v9ではReact Nativeのサポートが正式に強化され、React NativeとReact Native Webが並行実行できるようになった。デバイスやシミュレータでコンポーネントを完全な忠実度で開発しながら、Web版Storybookの全機能(ドキュメントやテストアドオン)を活用できる。

移行は2段階で行った。

  1. v8.6.12への移行
  2. v9.0.15への移行

v9への移行では以下を変更した。

  • .ondeviceディレクトリを.rnstorybookにリネーム
  • 全Storyファイルのimport文をアップデート
  • 依存関係の更新とコンフィグファイルの調整

オートマイグレーションは以下のコマンドで実行できる。

npm i -D storybook@9.0.15
npx storybook upgrade

このコマンドで問題ないが、プロダクトでは共通の設定を関数にしており、すべてにマイグレーションが適用されなかった。その部分についてはAIに更新をしてもらった。

local環境でWeb版を起動できない問題

以前はWeb版のStorybookを見られるようにしていたが、React Nativeのバージョンアップと共に不都合が起きた。React Native固有のライブラリがWeb環境でビルドエラーを起こすようになったのである。

解決策として、Webには関係ない要素をひたすらモックした。具体的には以下のようなモバイル専用ライブラリをモック化した。

  • Firebase関連
  • CodePush
  • react-native-fast-image
  • haptic feedback

Storybookの設定ファイルでViteのaliasを使い、ネイティブライブラリをモックファイルに差し替える。イメージは下記。

// .storybook/main.ts
async viteFinal(config) {
  const {mergeConfig} = await import('vite');
  return mergeConfig(config, {
    resolve: {
      alias: {
        // ネイティブライブラリをモックに差し替え
        'react-native-fast-image': resolve(__dirname, './mock/fast-image.mock.ts'),
        'react-native-haptic-feedback': resolve(__dirname, './mock/haptic.mock.ts'),
        // Firebase等も同様にモック化
      },
    },
  });
}

これによりnpm run storybook:webでWeb版Storybookが正常に起動できるようになった。体感的に起動も早くなった。

Web上で動かないライブラリは基本的にモックしたが、AIにやってもらうと非常に楽だった。このあたりは非常に助かった。

mswでhttp通信をモックしたときの問題

Web版のモックでmsw(Mock Service Worker)を使ったところ、React NativeのStorybookアプリで閲覧できなくなった。

原因

MSWの公式ではReact Nativeをサポートしていると謳っているが、実際には動かない。原因はMSW 2.4.12以降で@mswjs/interceptorsライブラリがTransformStreamへ依存するようになったことだ。このWeb APIはReact NativeのHermesエンジンには存在しない。

ReferenceError: Property 'TransformStream' doesn't exist, js engine: hermes

MessageEventが存在しないエラーも発生する。MSWはNode.jsやブラウザAPIに依存しており、React Native環境とは互換性がないのである。

解決策

Web(Storybook)の時だけmswが動くようにした。React NativeのStorybookアプリではmswを読み込まないようにすることで問題を回避した。

まずStorybookのpreview.tsxでmswを初期化する。

// .storybook/preview.tsx
import {initialize, mswLoader} from 'msw-storybook-addon';

initialize({ onUnhandledRequest: 'bypass' });

const preview: Preview = {
  loaders: [mswLoader],
};

次に、Web環境かどうかを判定するユーティリティを用意する。

// Web Storybookかどうかを判定
export const isWebStorybook = (): boolean => {
  return typeof window !== 'undefined' && typeof document !== 'undefined';
};

// Web環境の時だけハンドラーを返す
export const getMswHandlers = (handlers: HttpHandler[]): HttpHandler[] | undefined => {
  if (!isWebStorybook()) return undefined;
  return handlers;
};

StoryファイルではgetMswHandlersを使ってハンドラーを設定する。React Native環境ではundefinedが返るため、mswは読み込まれない。

Chromaticに対応

Chromaticの導入

Chromaticパッケージを追加し、ビジュアル回帰テストを可能にした。Storybook Web版にReact presetを追加してビルドが通るようにした。ChromaticでデプロイがコケるStoryはデプロイ対象外とした。

VRT対応のための画像差し替え

VRTでは画像の差分も検出される。picsum.photosのようなランダム画像を使っていると、毎回差分として検出されてしまう。そこでランダム画像を統一したモック画像に置き換えた。各メンバーの表示名やユーザー名もStorybookモックに統一した。

スキップ対象

以下のStoryはChromaticでのデプロイ対象外とした。

  • アニメーションが付いているもの
  • その他エラーになっているもの

スキップするにはStoryのparametersにchromatic: { disableSnapshot: true }を指定する。

export default {
  title: 'Component/AnimatedCard',
  component: AnimatedCard,
  parameters: {
    // アニメーションがあるためChromaticのスナップショットをスキップ
    chromatic: { disableSnapshot: true },
  },
} satisfies Meta<typeof AnimatedCard>;

CI/CDの設定

GitHub ActionsでPR作成時にChromaticへデプロイする。onlyChanged: trueを指定すると、変更のあったStoryのみスナップショットを取得するため効率的である。

- name: deploy to chromatic
  uses: chromaui/action@v11
  with:
    projectToken: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
    onlyChanged: true

効果

デグレの早期発見

作成したものをChromaticでデプロイした結果、VRTの差分がついてPR作成時に影響のあるUIをリストアップできるようになった。デグレにすぐに気づけるようになった。

UI共有の効率化

Chromaticでホスティングしているので、作成したUIを他の人へ素早く提供できるようになった。今まではスマートフォンを必ず使う必要があったが、ブラウザだけで済むようになった。

副作用排除の重要性

UIの設計で副作用を除くことは改めて大事な点だと学んだ。以下のような要素はないほうが望ましい。

  • 通信
  • グローバル変数
  • ネイティブモジュール依存(iOSではSwiftやObjective-C、AndroidではJavaやKotlin)

など。

あきらめているところ

スマートフォンアプリのUIをChromaticでの差分として表示しているため、ネイティブモジュールに依存しているUIの差分確認はできない。

また、スマホアプリ用のUIをWebで無理やり表示しているため、欠損や微妙にスタイルがズレて見えてしまうことがある。これは許容している。

まとめ

導入前は、UIを確認するたびにシミュレーターを起動し、実機で動作確認し、レビュー依頼をして返事を待つ。デグレに気づくのはリリース後ということもあった。今はPRを出せばChromaticが差分を教えてくれる。レビュアーはブラウザだけでUIを確認できる。この変化は大きい。

正直、一筋縄ではいかなかった。Storybook v9への移行、ネイティブライブラリのモック地獄、mswがReact Nativeで動かない問題。何度も壁にぶつかった。それでも1つずつ解決策を見つけ、なんとかここまで辿り着いた。

まだ完璧ではない。ネイティブモジュールに依存したUIはChromaticで確認できないし、Web表示による微妙なズレも残っている。しかし、それでも導入する価値はあった。デグレの早期発見、UI共有の効率化、そして何より「UIコンポーネントは副作用を持つべきではない」という設計原則を改めて実感できた。

React NativeでVRTは無理だと思っていた。でも、やってみたらできた。同じ課題を抱えているチームがあれば、ぜひ挑戦してみてほしい。Storybook v9とChromaticの組み合わせは、React Native開発の体験を確実に変えてくれる。

Unipos Tech Blog

Discussion