Firebase

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

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が担います。
  • 新規開発では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([email protected])の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の導入手順を先に済ませてください。

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の週間ダウンロード数(2026年10月20日〜26日)は、旧firebaseuiが44,546件、v7の@firebase-oss/ui-reactが3,089件です。ただし、パッケージのダウンロード件数だけでは、稼働中のアプリにおけるv6とv7の利用割合は判断できません。Android版は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通りの組み合わせを入れた結果は次のとおりです。

組み合わせ 結果
[email protected] + firebase@10 成功(88パッケージ)
[email protected] + firebase@12 ERESOLVE
@firebase-oss/[email protected] + firebase@12 成功(111パッケージ)
@firebase-oss/[email protected] + firebase@13 ERESOLVE
npm error code ERESOLVE
npm error Found: [email protected]
npm error Could not resolve dependency:
npm error peer firebase@"^11 || ^12" from @firebase-oss/[email protected]

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

v7でログイン画面を実装する手順(React)

手順は公式のfirebaseui-webのREADMEと、2026年10月21日に更新された英語版の公式ガイドに沿っています。日本語版の公式ガイドは最終更新が2026年4月24日で、v6のcompat前提の内容のままです。v7で書くときは英語版を参照してください。

React版FirebaseUIのインストール

npm install [email protected] @firebase-oss/[email protected] @firebase-oss/[email protected] @firebase-oss/[email protected] @firebase-oss/[email protected]

掲載コードは@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レジストリで確認できます)。

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(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)、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)は、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のベストプラクティスで確認してから選んでください。

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認証の導入手順と選び分けも参考になります。
  • Firebase JS SDK 13へすぐ上げたい:上で見たとおり、v7.1.0はSDK 13を対応範囲に含んでいません。

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

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版を使います。

関連記事

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

一創の公式 SNS

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

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

資料請求

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

  1. 2026.11.13 テックブログ 宝くじ公式サイト不正アクセス:4,436名の対象確認とパスワード再設定、変更された仕組み
  2. 2026.11.14 テックブログ Gitの脆弱性6件:CVE-2026-111760の再帰クローン対策と2.56.1への更新手順
  3. 2026.11.14 テックブログ ImageMagickの脆弱性VU#580079:policy.xmlの許可リスト設定と影響判定の手順
  4. 2025.04.09 コラム ダブルバーレル質問(二重質問)とは?例文と直し方、多重質問・誘導質問との違い
  5. 2026.11.13 テックブログ KARTEの不正アクセス:メールアドレス79,249件と連携認証情報の漏えい、利用企業の対応手順【11月16日時点】

RELATED POSTS 関連記事

目次