diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md
new file mode 100644
index 00000000..ccd5b763
--- /dev/null
+++ b/GETTING_STARTED.md
@@ -0,0 +1,511 @@
+# Easily add sign-in to your web app with FirebaseUI for Web
+
+FirebaseUI for Web is a set of libraries built on the [Firebase Authentication](https://firebase.google.com/docs/auth) JavaScript SDK. It helps you ship authentication flows quickly with a modern modular architecture.
+
+FirebaseUI for Web now provides these benefits:
+
+- Modern modular SDK support with `initializeApp(...)` and the current Firebase JS SDK.
+- Composable screens, forms, and buttons instead of a single monolithic widget.
+- Support for React, Shadcn, and Angular.
+- Configurable behaviors for redirect vs popup flows, Google One Tap, anonymous upgrade, phone settings, and more.
+- Localization support via `@firebase-oss/ui-translations`.
+- Built-in support for email/password, email link, phone auth, OAuth providers, and multi-factor flows.
+
+Note: If you are migrating from FirebaseUI v6 or earlier, read [the migration guide](https://github.com/firebase/firebaseui-web/blob/main/MIGRATION.md) in the FirebaseUI repository.
+
+This guide walks through installation, initialization, sign-in methods, and common configuration for React, Shadcn, and Angular apps.
+
+## Before you begin
+
+1. Add Firebase to your web app:
+
+   Enable **Authentication** in the [Firebase console](https://console.firebase.google.com/).
+
+   Install `firebase` if it is not already in your project:
+
+   ```bash
+   npm install firebase
+   ```
+
+   Use the modular Firebase JS SDK:
+
+   ```ts
+   import { initializeApp } from 'firebase/app';
+
+   const app = initializeApp({
+     /* your Firebase config */
+   });
+   ```
+
+2. Choose your platform and install FirebaseUI:
+
+   For [shadcn/ui](https://ui.shadcn.com/)-based React apps, add the Firebase registry to `components.json`:
+
+   ```json
+   {
+     "registries": {
+       "@firebase": "https://firebaseopensource.com/r/{name}.json"
+     }
+   }
+   ```
+
+   The auth components used throughout this guide are available from that registry, including `sign-in-auth-screen`, `sign-up-auth-screen`, `email-link-auth-screen`, `oauth-screen`, `phone-auth-screen`, `google-sign-in-button`, `apple-sign-in-button`, and `github-sign-in-button`.
+
+   Then add the components you want to use:
+
+   ```bash
+   npx shadcn@latest add @firebase/sign-in-auth-screen @firebase/google-sign-in-button
+   ```
+
+   This installs the underlying React FirebaseUI dependencies for you.
+
+   For React apps without shadcn/ui, install:
+
+   ```bash
+   npm install @firebase-oss/ui-react@beta @firebase-oss/ui-styles
+   ```
+
+   For Angular apps, install:
+
+   ```bash
+   npm install @angular/fire @firebase-oss/ui-angular@beta @firebase-oss/ui-core@beta @firebase-oss/ui-styles@beta
+   ```
+
+## Initialize FirebaseUI
+
+Create a shared UI store with `initializeUI(...)`, then pass it to your framework integration.
+
+### Shadcn
+
+Shadcn uses the same setup as React, because it also uses `@firebase-oss/ui-react` under the hood:
+
+```tsx
+import { initializeApp } from 'firebase/app';
+import { initializeUI } from '@firebase-oss/ui-core';
+import { FirebaseUIProvider } from '@firebase-oss/ui-react';
+
+const app = initializeApp({
+  /* your Firebase config */
+});
+
+const ui = initializeUI({
+  app,
+});
+
+export function AppProviders({ children }: { children: React.ReactNode }) {
+  return <FirebaseUIProvider ui={ui}>{children}</FirebaseUIProvider>;
+}
+```
+
+Use your existing shadcn styles for these generated components. You typically do not import FirebaseUI's bundled CSS when using the shadcn registry.
+
+### React
+
+```tsx
+import { initializeApp } from 'firebase/app';
+import { initializeUI } from '@firebase-oss/ui-core';
+import { FirebaseUIProvider } from '@firebase-oss/ui-react';
+
+const app = initializeApp({
+  /* your Firebase config */
+});
+
+const ui = initializeUI({
+  app,
+});
+
+export function AppProviders({ children }: { children: React.ReactNode }) {
+  return <FirebaseUIProvider ui={ui}>{children}</FirebaseUIProvider>;
+}
+```
+
+### Angular
+
+```ts
+import { type ApplicationConfig } from '@angular/core';
+import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
+import { provideFirebaseUI } from '@firebase-oss/ui-angular';
+import { initializeUI } from '@firebase-oss/ui-core';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideFirebaseApp(() =>
+      initializeApp({
+        /* your Firebase config */
+      }),
+    ),
+    provideFirebaseUI((apps) =>
+      initializeUI({
+        app: apps[0],
+      }),
+    ),
+  ],
+};
+```
+
+## Include styles
+
+If you are using the default React or Angular components, include the FirebaseUI styles:
+
+```css
+@import '@firebase-oss/ui-styles/dist.min.css';
+```
+
+If you are using Tailwind:
+
+```css
+@import 'tailwindcss';
+@import '@firebase-oss/ui-styles/tailwind';
+```
+
+## Set up sign-in methods
+
+Before users can sign in, enable each provider you want in **Authentication** -> **Sign-in method** in the Firebase console.
+
+FirebaseUI for Web uses screens, forms, and buttons that you render directly. Shared configuration for those flows lives in `behaviors` passed to `initializeUI(...)`.
+
+### Email address and password
+
+1. Enable **Email/Password** in the Firebase console.
+2. Render `SignInAuthScreen` or `SignUpAuthScreen` in React, the generated `sign-in-auth-screen` or `sign-up-auth-screen` components in Shadcn, or `fui-sign-in-auth-screen` / `fui-sign-up-auth-screen` in Angular.
+
+### Email link authentication
+
+1. Enable **Email/Password** and **Email link (passwordless sign-in)** in the Firebase console.
+2. Render `EmailLinkAuthScreen` in React, the generated `email-link-auth-screen` component in Shadcn, or `fui-email-link-auth-screen` in Angular.
+3. Complete sign-in with the current URL using the core helpers when needed.
+
+```ts
+import { completeEmailLinkSignIn } from '@firebase-oss/ui-core';
+
+await completeEmailLinkSignIn(ui, window.location.href);
+```
+
+### OAuth providers
+
+FirebaseUI for Web supports built-in buttons for providers such as Google, Apple, Facebook, GitHub, Microsoft, and X/Twitter.
+
+1. Enable the provider in the Firebase console.
+2. Add your app domain to **Authorized domains** where required.
+3. Render `OAuthScreen` with the provider buttons you want, such as `GoogleSignInButton`, `AppleSignInButton`, `FacebookSignInButton`, `GitHubSignInButton`, `MicrosoftSignInButton`, or `TwitterSignInButton` in React, the generated shadcn equivalents in your app, or `fui-oauth-screen` with `fui-google-sign-in-button`, `fui-apple-sign-in-button`, `fui-facebook-sign-in-button`, `fui-github-sign-in-button`, `fui-microsoft-sign-in-button`, or `fui-twitter-sign-in-button` in Angular.
+
+### Phone number
+
+1. Enable **Phone** in the Firebase console.
+2. Add your app domain to **Authorized domains**.
+3. Render `PhoneAuthScreen` or `PhoneAuthForm` in React, the generated `phone-auth-screen` or `phone-auth-form` components in Shadcn, or `fui-phone-auth-screen` in Angular.
+
+Optional: configure allowed countries, default country, or reCAPTCHA behavior:
+
+```ts
+import {
+  countryCodes,
+  initializeUI,
+  recaptchaVerification,
+} from '@firebase-oss/ui-core';
+
+const ui = initializeUI({
+  app,
+  behaviors: [
+    countryCodes({
+      allowedCountries: ['GB', 'US', 'FR'],
+      defaultCountry: 'GB',
+    }),
+    recaptchaVerification({
+      size: 'compact',
+      theme: 'light',
+    }),
+  ],
+});
+```
+
+## Customization
+
+Configure shared auth behavior in `behaviors` passed to `initializeUI(...)`.
+
+### Require a display name during sign-up
+
+```ts
+import { initializeUI, requireDisplayName } from '@firebase-oss/ui-core';
+
+const ui = initializeUI({
+  app,
+  behaviors: [requireDisplayName()],
+});
+```
+
+### Upgrade anonymous users
+
+Use the `autoUpgradeAnonymousUsers(...)` behavior to merge an anonymous session into a signed-in account.
+
+```ts
+import {
+  autoUpgradeAnonymousUsers,
+  initializeUI,
+} from '@firebase-oss/ui-core';
+
+const ui = initializeUI({
+  app,
+  behaviors: [
+    autoUpgradeAnonymousUsers({
+      async onUpgrade(ui, oldUserId, credential) {
+        // Migrate or merge user data here if needed.
+      },
+    }),
+  ],
+});
+```
+
+For migration details, see [MIGRATION.md](MIGRATION.md).
+
+## Sign in
+
+Render the auth screen you want and handle success in component callbacks or Angular outputs.
+
+### Shadcn
+
+Shadcn uses the same runtime and flow as React. The only difference is that you import the generated component from your app instead of from `@firebase-oss/ui-react`:
+
+```tsx
+import { SignInAuthScreen } from '@/components/sign-in-auth-screen';
+import { useNavigate } from 'react-router';
+
+export function SignInPage() {
+  const navigate = useNavigate();
+
+  return (
+    <SignInAuthScreen
+      onSignIn={() => {
+        navigate('/dashboard');
+      }}
+    />
+  );
+}
+```
+
+### React
+
+```tsx
+import { SignInAuthScreen } from '@firebase-oss/ui-react';
+import { useNavigate } from 'react-router';
+
+export function SignInPage() {
+  const navigate = useNavigate();
+
+  return (
+    <SignInAuthScreen
+      onSignIn={() => {
+        navigate('/dashboard');
+      }}
+    />
+  );
+}
+```
+
+### Angular
+
+```ts
+import { Component } from '@angular/core';
+import { Router } from '@angular/router';
+import { SignInAuthScreenComponent } from '@firebase-oss/ui-angular';
+import type { User } from '@angular/fire/auth';
+
+@Component({
+  selector: 'app-sign-in-page',
+  standalone: true,
+  imports: [SignInAuthScreenComponent],
+  template: `
+    <fui-sign-in-auth-screen (signIn)="onSignIn($event)" />
+  `,
+})
+export class SignInPageComponent {
+  constructor(private router: Router) {}
+
+  onSignIn(user: User) {
+    this.router.navigate(['/dashboard']);
+  }
+}
+```
+
+## Sign out
+
+FirebaseUI for Web uses the standard Firebase Authentication sign-out API:
+
+```ts
+import { getAuth, signOut } from 'firebase/auth';
+
+const auth = getAuth(app);
+await signOut(auth);
+```
+
+## OAuth providers: popup vs redirect
+
+Choose the provider sign-in flow with behaviors:
+
+- `providerPopupStrategy()` for popup flows
+- `providerRedirectStrategy()` for redirect flows
+
+Popup is the default, so you only need to configure redirect explicitly:
+
+```ts
+import { initializeUI, providerRedirectStrategy } from '@firebase-oss/ui-core';
+
+const ui = initializeUI({
+  app,
+  behaviors: [providerRedirectStrategy()],
+});
+```
+
+To render OAuth buttons, add them to your platform-specific screen.
+
+### React
+
+```tsx
+import {
+  GitHubSignInButton,
+  GoogleSignInButton,
+  OAuthScreen,
+} from '@firebase-oss/ui-react';
+
+export function OAuthPage() {
+  return (
+    <OAuthScreen>
+      <GoogleSignInButton />
+      <GitHubSignInButton />
+    </OAuthScreen>
+  );
+}
+```
+
+### Shadcn
+
+```tsx
+import { GitHubSignInButton } from '@/components/github-sign-in-button';
+import { GoogleSignInButton } from '@/components/google-sign-in-button';
+import { OAuthScreen } from '@/components/oauth-screen';
+
+export function OAuthPage() {
+  return (
+    <OAuthScreen>
+      <GoogleSignInButton />
+      <GitHubSignInButton />
+    </OAuthScreen>
+  );
+}
+```
+
+### Angular
+
+```ts
+import { Component } from '@angular/core';
+import {
+  GithubSignInButtonComponent,
+  GoogleSignInButtonComponent,
+  OAuthScreenComponent,
+} from '@firebase-oss/ui-angular';
+
+@Component({
+  selector: 'app-oauth-page',
+  standalone: true,
+  imports: [
+    OAuthScreenComponent,
+    GoogleSignInButtonComponent,
+    GithubSignInButtonComponent,
+  ],
+  template: `
+    <fui-oauth-screen>
+      <fui-google-sign-in-button />
+      <fui-github-sign-in-button />
+    </fui-oauth-screen>
+  `,
+})
+export class OAuthPageComponent {}
+```
+
+## Google One Tap
+
+Use the `oneTapSignIn(...)` behavior to enable Google One Tap:
+
+```ts
+import { initializeUI, oneTapSignIn } from '@firebase-oss/ui-core';
+
+const ui = initializeUI({
+  app,
+  behaviors: [
+    oneTapSignIn({
+      clientId: 'YOUR_GOOGLE_WEB_CLIENT_ID',
+      autoSelect: false,
+      cancelOnTapOutside: false,
+    }),
+  ],
+});
+```
+
+Make sure Google sign-in is enabled in the Firebase console, then copy the web client ID from the Google provider settings.
+
+## Terms of service and privacy policy
+
+Attach policy links through the platform provider configuration.
+
+### React
+
+```tsx
+import { FirebaseUIProvider } from '@firebase-oss/ui-react';
+
+<FirebaseUIProvider
+  ui={ui}
+  policies={{
+    termsOfServiceUrl: 'https://example.com/terms',
+    privacyPolicyUrl: 'https://example.com/privacy',
+  }}
+>
+  {children}
+</FirebaseUIProvider>;
+```
+
+### Shadcn
+
+Use the same `FirebaseUIProvider` configuration as React.
+
+### Angular
+
+```ts
+import { type ApplicationConfig } from '@angular/core';
+import { provideFirebaseUIPolicies } from '@firebase-oss/ui-angular';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideFirebaseUIPolicies(() => ({
+      termsOfServiceUrl: 'https://example.com/terms',
+      privacyPolicyUrl: 'https://example.com/privacy',
+    })),
+  ],
+};
+```
+
+## Translations
+
+FirebaseUI for Web supports localization through `@firebase-oss/ui-translations`. At the moment, a couple of locales are bundled out of the box, including English (`en-US`) and Czech (`cs-CZ`). You can also register and use your own locale overrides today, and PRs to add more built-in languages are welcomed.
+
+```ts
+import { initializeUI } from '@firebase-oss/ui-core';
+import { registerLocale } from '@firebase-oss/ui-translations';
+
+const enUsCustom = registerLocale('en-US', {
+  labels: {
+    signIn: 'Continue',
+  },
+});
+
+const ui = initializeUI({
+  app,
+  locale: enUsCustom,
+});
+```
+
+## Next steps
+
+- Read [README.md](README.md) for the full API, behaviors, and component reference.
+- Read [MIGRATION.md](MIGRATION.md) if you are migrating an existing app to FirebaseUI for Web.
+- See the package-specific docs in [packages/react/README.md](packages/react/README.md), [packages/shadcn/README.md](packages/shadcn/README.md), and [packages/angular/README.md](packages/angular/README.md).
+- Explore the examples in [examples/react](examples/react), [examples/shadcn](examples/shadcn), and [examples/angular](examples/angular).
diff --git a/MIGRATION.md b/MIGRATION.md
index 021ad906..76c12f42 100644
--- a/MIGRATION.md
+++ b/MIGRATION.md
@@ -69,7 +69,7 @@ First, remove the old `firebaseui` package and install the appropriate new packa
 
   Install the new Angular package:
   ```bash
-  npm install @firebase-oss/ui-angular@beta
+  npm install @angular/fire @firebase-oss/ui-angular@beta @firebase-oss/ui-core@beta @firebase-oss/ui-styles@beta
   ```
 
   **Note:** The Angular package requires [AngularFire](https://github.com/angular/angularfire) to be installed and configured first.
@@ -90,7 +90,7 @@ First, remove the old `firebaseui` package and install the appropriate new packa
   {
     ...
     "registries": {
-      "@firebase": "https://fir-ui-shadcn-registry.web.app/r/{name}.json"
+      "@firebase": "https://firebaseopensource.com/r/{name}.json"
     }
   }
   ```
diff --git a/README.md b/README.md
index 1c5b4512..6f950c3d 100644
--- a/README.md
+++ b/README.md
@@ -182,7 +182,7 @@ Next, follow the framework specific installation steps, for either React, Shadcn
   Once you have provided the Firebase App instance to your application using `provideFirebaseApp`, install the Firebase UI for Angular package:
 
   ```bash
-  npm install @firebase-oss/ui-angular@beta
+  npm install @angular/fire @firebase-oss/ui-angular@beta @firebase-oss/ui-core@beta @firebase-oss/ui-styles@beta
   ```
 
   Alongside your existing providers, add the `provideFirebaseUI` provider, returning a new Firebase UI instance via `initializeUI`:
@@ -1530,7 +1530,7 @@ By default, any missing translations will fallback to English if not specified.
 <details>
   <summary>Shadcn</summary>
 
-  The shadcn registry is available at: https://fir-ui-shadcn-registry.web.app/r/{name}.json
+  The shadcn registry is available at: https://firebaseopensource.com/r/{name}.json
 
   | Name     |       Path       | Description |
   |----------|:----------------:|-------------|
diff --git a/packages/angular/README.md b/packages/angular/README.md
index 63958a26..c0fd909d 100644
--- a/packages/angular/README.md
+++ b/packages/angular/README.md
@@ -7,7 +7,7 @@ This package contains the Angular components for FirebaseUI.
 Install the package from NPM:
 
 ```bash
-npm install @angular/fire @firebase-oss/ui-angular @firebase-oss/ui-core @firebase-oss/ui-styles @firebase-oss/ui-translations
+npm install @angular/fire @firebase-oss/ui-angular@beta @firebase-oss/ui-core@beta @firebase-oss/ui-styles@beta
 ```
 
 ## Development