---
title: "FirebaseUIとは？v7.1正式版の使い方とv6からの移行・Firebase 13対応【2026年10月】"
url: "https://www.issoh.co.jp/tech/details/3397/"
published: 2024-08-26
updated: 2026-10-28
categories: ["Firebase"]
publisher: "株式会社一創"
---

# FirebaseUIとは？v7.1正式版の使い方とv6からの移行・Firebase 13対応【2026年10月】

FirebaseUIは、Firebase Authenticationにログイン画面を追加する公式のUIライブラリです。Web版は2026年7月23日にv7が正式版となり、2026年10月時点の最新は**7.1.0**（2026年8月12日公開）です。v7は旧v6（`firebaseui`パッケージ）を土台から書き直した別物で、パッケージ名も初期化方法も変わりました。この記事ではv7でログイン画面を組む手順、v6の設定からの書き換え、日本語化、そして2026年10月7日に出たFirebase JS SDK 13と組み合わせたときにインストールが止まる問題を、npmとNode.jsで実際に動かした結果をもとに整理します。

## まとめ：FirebaseUIの最新バージョンと選び方の要点

- FirebaseUIが担うのはログイン画面だけです。トークンの発行やセッション管理は[Firebase Authentication](/tech/details/5921/)が担います。
- 新規開発ではv7（`@firebase-oss/ui-react`・`@firebase-oss/ui-angular`）を選びます。npmの`latest`は7.1.0です。`@beta`を付けて入れると古い7.0.3が入ります。
- v7.1.0が対応するFirebase JS SDKは**v11とv12だけ**です。SDK 13と組み合わせると`npm install`がERESOLVEで止まるため、当面はSDK 12系に固定します。
- v6（`firebaseui@6.1.0`）のpeerDependenciesはFirebase JS SDK ^9.1.3または^10.0.0で、compat APIを使用します。SDK 11以降へ更新する場合は、v7への移行やFirebase Authentication SDKによる画面の自作を検討します。
- v6からv7へ設定をそのまま移す方法はありません。既定のサインイン方式も、v6のredirectからv7ではpopupに変わっています。

## FirebaseUIとFirebase Authenticationの役割の違い

Firebase Authenticationは、パスワードの照合、OAuthプロバイダとの連携、IDトークンの発行を行うサービスです。FirebaseUIはその上に、メールアドレスの入力欄・Googleでサインインするボタン・電話番号の確認コード入力欄といった画面部品をかぶせます。FirebaseUIを外しても認証そのものは動きます。逆に、FirebaseUIだけでは何も認証できません。使う前に、Firebaseコンソールの「Authentication」で使うログイン方法を有効にしておく必要があります。プロジェクトの作成とSDKの組み込みがまだなら、[Firebaseの導入手順](/tech/details/16678/)を先に済ませてください。

v7のReact版が用意しているボタンは、Google・Apple・Facebook・GitHub・Microsoft・X（Twitter）・Yahoo（7.0.3で追加）の7種です。メールアドレスとパスワード、メールリンク、電話番号、多要素認証（SMS・TOTP）の画面も含まれます。名前が似ていますが、Firebaseコンソール（管理画面）のデザインとは関係ありません。

## FirebaseUIのバージョンと対応SDKの一覧（Web・Android・iOS・Flutter）

FirebaseUIはプラットフォームごとに別のリポジトリで開発されていて、版番号もそろっていません。2026年10月28日時点の各リリースページの値です。

| 対象      | パッケージ                           | 最新版    | 公開日        | 対応するFirebase SDK      |
| ------- | ------------------------------- | ------ | ---------- | --------------------- |
| Web（v7） | @firebase-oss/ui-react ほか       | 7.1.0  | 2026-08-12 | JS SDK v11・v12        |
| Web（v6） | firebaseui                      | 6.1.0  | 2023-08-02 | JS SDK v9・v10（compat） |
| Android | com.firebaseui:firebase-ui-auth | 10.0.0 | 2026-10-27 | Jetpack Composeで書き直し  |
| iOS     | FirebaseUI-iOS                  | 16.2.0 | 2026-10-23 | iOS SDK 13に対応         |
| Flutter | firebase\_ui\_auth              | 3.1.1  | 2026-09-15 | FlutterFire           |

Web版の[npmの週間ダウンロード数](https://api.npmjs.org/downloads/point/2026-10-20:2026-10-26/firebaseui)（2026年10月20日〜26日）は、旧`firebaseui`が44,546件、v7の`@firebase-oss/ui-react`が3,089件です。ただし、パッケージのダウンロード件数だけでは、稼働中のアプリにおけるv6とv7の利用割合は判断できません。Android版は[10.0.0](https://github.com/firebase/FirebaseUI-Android/releases/tag/10.0.0)でView方式からJetpack Composeへ書き直されました。`createSignInIntentBuilder()`を使う9.x系のコードは、Web版と同じく作り直しになります。

### Firebase JS SDK 13とv7.1.0の依存関係エラー

v7.1.0の`peerDependencies`は`firebase: ^11 || ^12`です。2026年10月28日時点のmainブランチでも同じ範囲のままで、Firebase JS SDK 13（2026年10月7日公開、最新は13.1.0）はまだ対応範囲に入っていません。npm 11.17.0で4通りの組み合わせを入れた結果は次のとおりです。

| 組み合わせ                                      | 結果           |
| ------------------------------------------ | ------------ |
| firebaseui@6.1.0 ＋ firebase@10             | 成功（88パッケージ）  |
| firebaseui@6.1.0 ＋ firebase@12             | ERESOLVE     |
| @firebase-oss/ui-react@7.1.0 ＋ firebase@12 | 成功（111パッケージ） |
| @firebase-oss/ui-react@7.1.0 ＋ firebase@13 | ERESOLVE     |

```
npm error code ERESOLVE
npm error Found: firebase@13.1.0
npm error Could not resolve dependency:
npm error peer firebase@"^11 || ^12" from @firebase-oss/ui-react@7.1.0
```

`--legacy-peer-deps`を付ければインストール自体は通ります（firebase 13.1.0が入ることを確認）。[SDK 13.0.0のリリースノート](https://firebase.google.com/support/release-notes/js)で互換性のない変更として挙がっているのはAI LogicのAPIだけで、Authenticationの項目はありません。それでも、FirebaseUIの開発側がSDK 13との組み合わせを対応範囲に入れたわけではありません。ログイン画面は本番の入口なので、FirebaseUIが対応範囲を広げるまでは`"firebase": "^12.19.0"`のように12系へ固定するのが安全です。

## v7でログイン画面を実装する手順（React）

手順は公式の[firebaseui-webのREADME](https://github.com/firebase/firebaseui-web)と、2026年10月21日に更新された[英語版の公式ガイド](https://firebase.google.com/docs/auth/web/firebaseui?hl=en)に沿っています。日本語版の公式ガイドは最終更新が2026年4月24日で、v6のcompat前提の内容のままです。v7で書くときは英語版を参照してください。

### React版FirebaseUIのインストール

```
npm install firebase@12.19.0 @firebase-oss/ui-react@7.1.0 @firebase-oss/ui-styles@7.1.0 @firebase-oss/ui-core@7.1.0 @firebase-oss/ui-translations@7.1.0
```

掲載コードは`@firebase-oss/ui-core`と`@firebase-oss/ui-translations`も直接importするので、検証した7.1.0に版をそろえて明示的に入れています。React 19の既存プロジェクトが前提です（peerは`react: ^19`）。英語版の公式ガイドは`npm install @firebase-oss/ui-react@beta`と書いていますが、npmの`beta`タグは7.0.3を指したままです。`@beta`は付けず、7.1.0を指定して入れます（dist-tagsは[npmレジストリ](https://registry.npmjs.org/-/package/@firebase-oss/ui-react/dist-tags)で確認できます）。

### initializeUIとFirebaseUIProviderによる初期化

v7では、モジュラーAPIの`initializeApp`で作ったアプリを`initializeUI`に渡してUIの状態を作り、それを`FirebaseUIProvider`で画面全体に配ります。次のコードは、tsc 7.0.2の型検査をエラーなしで通り、`renderToString`でも描画できることを確かめた構成です。ブラウザ上での認証完了やリダイレクト復帰までを検証した例ではありません。

```
import { initializeApp } from "firebase/app";
import { initializeUI, providerRedirectStrategy, requireDisplayName } from "@firebase-oss/ui-core";
import { jaJp } from "@firebase-oss/ui-translations";
import {
  FirebaseUIProvider,
  SignInAuthScreen,
  OAuthScreen,
  GoogleSignInButton,
  GitHubSignInButton,
} from "@firebase-oss/ui-react";
import "@firebase-oss/ui-styles/dist.min.css";

const app = initializeApp({
  apiKey: "...",
  authDomain: "example.firebaseapp.com",
  projectId: "example",
  appId: "...",
});

export const ui = initializeUI({
  app,
  locale: jaJp,
  behaviors: [providerRedirectStrategy(), requireDisplayName()],
});

export function App() {
  return (
    <FirebaseUIProvider
      ui={ui}
      policies={{
        termsOfServiceUrl: "https://example.com/terms",
        privacyPolicyUrl: "https://example.com/privacy",
      }}
    >
      <SignInAuthScreen onSignIn={(user) => console.log(user.uid)} />
      <OAuthScreen onSignIn={(user) => console.log(user.uid)}>
        <GoogleSignInButton />
        <GitHubSignInButton />
      </OAuthScreen>
    </FirebaseUIProvider>
  );
}
```

v6の`signInOptions`のように配列でプロバイダを並べる方式はなくなりました。表示したいボタンのコンポーネントを`OAuthScreen`の中に置き、置いた順にボタンが並びます。ログインに成功したあとの遷移も、`signInSuccessUrl`ではなく`onSignIn`の中に書きます。`policies`に渡した利用規約とプライバシーポリシーのURLは、各フォームの下に同意文として自動で表示されます。

### AngularのProvider設定とShadcnのコンポーネント導入

Angularでは、[AngularFire](https://github.com/angular/angularfire)（peerは`@angular/fire ^20`）の`provideFirebaseApp`のあとに`provideFirebaseUI((apps) => initializeUI({ app: apps[0] }))`を足します。画面には`<fui-sign-in-auth-screen (signIn)="onSignIn($event)" />`のようなセレクタで置きます。Shadcnでは`components.json`の`registries`に`"@firebase": "https://firebaseopensource.com/r/{name}.json"`を追加し、`npx shadcn@latest add @firebase/sign-in-auth-screen`で部品のソースを自分のプロジェクトへ取り込みます。見た目はShadcnの設定に従うので、`ui-styles`のCSSは読み込みません。

## FirebaseUIの日本語化とデザインの変更

### ja-JPロケールによる日本語表示

READMEの「Translations」節には「標準で用意しているのは英語（en-US）だけ」という注記が残っています。実際には、7.0.3で40言語の翻訳が追加され（[PR #1352](https://github.com/firebase/firebaseui-web/pull/1352)）、7.1.0の`@firebase-oss/ui-translations`には登録済みの`jaJp`が入っています。上のコードのように`locale: jaJp`を渡して描画すると、「Google でサインイン」「GitHub でサインイン」「続行することで、利用規約およびプライバシーポリシーに同意したことになります。」と日本語で表示されました。言語を途中で切り替えるときは`ui.setLocale(...)`を呼びます。

個別の文言は`registerLocale("ja-JP", { ... }, jaJp)`で上書きできます。3つ目の引数は、上書きしなかった文言の代わりに使うロケールの指定です。v6では、日本語にするにはCDNの`firebase-ui-auth__ja.js`を読み込むか、npm向けの日本語ビルドを`npm run build build-npm-ja`で自分で作る必要がありました。

### CSS変数による配色と角丸の変更

v7の標準スタイルは、`--fui-primary`（ボタンとリンクの色）、`--fui-background`（カードの背景）、`--fui-radius`（入力欄の角丸）などのCSS変数で決まります。`:root`でこれらを上書きすれば、自社サイトの配色に合わせられます。Tailwind CSSを使っている場合は、`@import "@firebase-oss/ui-styles/tailwind";`を読み込みます。

## v6からv7へ移行するときの設定の書き換え

公式の[移行ガイド（MIGRATION.md）](https://github.com/firebase/firebaseui-web/blob/main/MIGRATION.md)は、v6からv7へは直接の移行手段が無いと明記しています。`firebaseui`をアンインストールし、画面を作り直す作業になります。v6の設定項目は、v7では次のように置き換わります。

| v6の設定                                     | v7での書き方                                          |
| ----------------------------------------- | ------------------------------------------------ |
| new firebaseui.auth.AuthUI() ＋ ui.start() | initializeUI ＋ FirebaseUIProvider                |
| signInOptions                             | ボタンのコンポーネントを並べる                                  |
| signInFlow                                | providerPopupStrategy / providerRedirectStrategy |
| callbacks.signInSuccessWithAuthResult     | onSignIn                                         |
| signInSuccessUrl                          | onSignIn の中で遷移する                                 |
| tosUrl / privacyPolicyUrl                 | FirebaseUIProvider の policies                    |
| credentialHelper                          | oneTapSignIn（Google One Tap）                     |
| autoUpgradeAnonymousUsers                 | autoUpgradeAnonymousUsers（behavior）              |
| defaultCountry / whitelistedCountries     | countryCodes                                     |

v6の`signInFailure`で処理していた匿名ユーザーの統合の失敗は、v7では`autoUpgradeAnonymousUsers`の`onUpgrade`と、7.1.0で追加された`onUpgradeFailure`で受けます。GCIP（Identity Platform）向けの`adminRestrictedOperation`に代わる仕組みはv7にありません。`auth/admin-restricted-operation`エラーを自分で処理する必要があります。

### 既定のサインイン方式の変更：redirectからpopupへ

移行で見落としやすいのはここです。v6の`signInFlow`の既定値は`redirect`でした。v7の既定のbehaviorは`providerPopupStrategy`で、何も指定しないとGoogleなどのボタンはポップアップで開きます。7.1.0の`defaultBehaviors`をNode.jsで取り出すと、サインイン処理の本体は`signInWithPopup`を呼んでいました。なお、READMEのReference節には「既定に`providerRedirectStrategy`が含まれる」とする記述がありますが、ソースコードと移行ガイドはpopupが既定です。ソースの方を正としてください。

v6と同じ画面遷移を保ちたいときは、上のコードのように`providerRedirectStrategy()`を明示します。ただしリダイレクト方式は、サードパーティストレージを制限するブラウザでログインが完了しない場合があります。認証ドメインを自社ドメインに合わせる方法などは、公式の[signInWithRedirectのベストプラクティス](https://firebase.google.com/docs/auth/web/redirect-best-practices)で確認してから選んでください。

## v6を使い続けてよい条件と限界

v6を使い続けてよいのは、Firebase JS SDKをv10（最終版は10.14.1）に止めたままでよく、ログイン画面以外にも`firebase/compat`を使っている既存アプリだけです。v6が前提とするのは`firebase/compat/app`と`firebase/compat/auth`の名前空間APIです。公式の日本語ガイドも「FirebaseUIはモジュール方式APIと互換性がありません」と警告しています。CDNで読み込む場合は、次のようにcompat版のSDKとv6.1.0の日本語ビルドをそろえます。

```
<script src="https://www.gstatic.com/firebasejs/10.14.1/firebase-app-compat.js"></script>
<script src="https://www.gstatic.com/firebasejs/10.14.1/firebase-auth-compat.js"></script>
<script src="https://www.gstatic.com/firebasejs/ui/6.1.0/firebase-ui-auth__ja.js"></script>
<link rel="stylesheet" href="https://www.gstatic.com/firebasejs/ui/6.1.0/firebase-ui-auth.css">
```

v6.1.0は2023年8月を最後に更新されておらず、ソースは`v6-archive`ブランチに移されました。不具合が見つかっても修正版は出ないと考えておくべきです。Firebase JS SDKを11以降へ上げる計画があるなら、その作業にv7への書き直しを含めて見積もってください。

## FirebaseUIを使うべきでない場面

- **React 19・Angular以外の画面フレームワーク**：v7のUI部品はReact（Shadcnを含む）とAngular向けだけです。VueやSvelteでは`@firebase-oss/ui-core`の関数を呼んで画面を自作することになり、既製の画面を使う利点がほぼ無くなります。
- **入力項目や手順が独自のサインアップ**：会員規約の段階的な同意、本人確認書類の提出、法人コードの入力などが入る場合です。Firebase Authentication SDKを直接呼ぶ構成なら、独自の入力項目や画面遷移をアプリ側で設計できます。
- **認証基盤を将来入れ替える可能性がある**：FirebaseUIの画面はFirebase Authenticationとしか組み合わせられません。Clerkなど画面込みの認証サービスと比べる場合は、[Clerk認証の導入手順と選び分け](/tech/details/18308/)も参考になります。
- **Firebase JS SDK 13へすぐ上げたい**：上で見たとおり、v7.1.0はSDK 13を対応範囲に含んでいません。

会員サイトや業務システムのログインを、SSOやID管理まで含めて設計する場合は、[認証基盤・ID管理システム開発](/service/system/identity/)として要件から整理する方法もあります。認証方式ごとの違いは[認証・ID管理とは？MFA・SSO・OIDC・IDaaSの違い](/column/details/13631/)にまとめています。

## FirebaseUIでよくあるトラブルと対処

### npm installのERESOLVE（peer firebase）への対処

エラー文の`peer firebase@"..." from ...`に、対応しているSDKの範囲が出ています。v7なら`firebase`を12系へ、v6なら10系へ下げると解消します。`package.json`の`firebase`が`^13`や`latest`になっていないかを先に確認してください。

### v7のスタイル崩れとCSS読み込みの確認

React版とAngular版は、`@firebase-oss/ui-styles/dist.min.css`（Tailwindなら`/tailwind`）を読み込まないと素のHTMLのまま表示されます。Shadcn版はこのCSSを読まず、プロジェクト側のShadcnのテーマで表示されます。

### v6へのモジュラーAuthの誤指定とcompatへの修正

v6の`new firebaseui.auth.AuthUI()`が受け取るのは、compat版の`firebase.auth()`の戻り値です。SDKをモジュラーAPIへ移行する途中で`getAuth()`の戻り値を渡すように書き換えると、v6の対応範囲を外れます。v6を使い続ける間は、FirebaseUIに渡すAuthをcompat版のまま残してください。

## よくある質問

### FirebaseUIは無料で使えますか？

はい。FirebaseUIはGitHubで公開されているオープンソースのライブラリで、ライブラリそのものに料金はかかりません。料金が発生するのはFirebase Authentication側で、電話番号認証のSMS送信や、Identity Platformへアップグレードしたあとの月間アクティブユーザー数に応じて課金されます。

### FirebaseUIの最新バージョンはいくつですか？

Web版は7.1.0（2026年8月12日公開）です。旧系統の`firebaseui`は6.1.0（2023年8月2日）が最終版です。Android版は10.0.0、iOS版は16.2.0、Flutter版の`firebase_ui_auth`は3.1.1です（いずれも2026年10月28日時点）。

### FirebaseUI v7はまだベータですか？

いいえ。2025年12月2日のv7.0.0-betaから始まり、2026年7月23日の7.0.3で`-beta`が外れて正式版になりました。`@firebase-oss/ui-react`のnpmの`latest`タグは7.1.0を指しています。

### FirebaseUIは日本語に対応していますか？

対応しています。v7は`@firebase-oss/ui-translations`の`jaJp`を`initializeUI`の`locale`に渡すだけで日本語になります。v6はCDNの`firebase-ui-auth__ja.js`を読み込むか、npmで使う場合は日本語ビルドを自分で作る必要があります。

### FirebaseUIはReact以外でも使えますか？

v7の画面部品があるのはReact（Shadcnを含む）とAngularです。それ以外のフレームワークでは、画面を持たない`@firebase-oss/ui-core`の関数（`signInWithEmailAndPassword(ui, email, password)`など）を使って、画面は自作します。モバイルアプリならAndroid版・iOS版・Flutter版を使います。

## 関連記事

- [Firebase Authenticationとは？料金・認証方式・導入手順とMFA・IDトークン検証【2026年10月】](/tech/details/5921/)
- [Firebaseの導入手順｜プロジェクト作成からSDK導入と初回デプロイまで](/tech/details/16678/)
- [Firebase Admin SDKとは？クライアントSDKとの違いと導入・初期化・ユーザー管理【firebase-admin 14対応】](/tech/details/3451/)
- [Clerk認証とは？Next.jsへの導入手順とCore 3の変更点・MRU料金・Auth0との選び分け【2026年10月】](/tech/details/18308/)
- [SupabaseとFirebaseの違い｜DB・認証・料金の比較とどっちを選ぶか【2026年10月】](/column/details/3002/)

---

出典: [FirebaseUIとは？v7.1正式版の使い方とv6からの移行・Firebase 13対応【2026年10月】](<https://www.issoh.co.jp/tech/details/3397/>)（株式会社一創）
