React NativeでもVRTがしたい!Chromatic導入までの道のり
この記事は、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段階で行った。
- v8.6.12への移行
- 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開発の体験を確実に変えてくれる。
Discussion