release(*): internal release candidate (2025-10-02)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,53 @@
+---
+name: Bug report
+about: Create a report to help us improve
+---
+
+<!-- Step 1 [READ THIS] -->
+<!--
+Are you in the right place?
+  * For issues or feature requests related to __the code in this repository__
+    file a Github issue.
+    * If this is a __feature request__ make sure the issue title starts with "FR:".
+  * For general technical questions, post a question on [StackOverflow](http://stackoverflow.com/)
+    with the firebase-authentication tag.
+  * For general Firebase discussion, use the [firebase-talk](https://groups.google.com/forum/#!forum/firebase-talk)
+    google group.
+  * For help troubleshooting your application that does not fall under one
+    of the above categories, reach out to the personalized
+    [Firebase support channel](https://firebase.google.com/support/).
+-->
+
+<!-- Step 2 -->
+
+### [REQUIRED] Describe your environment
+
+- Operating System version: **\_**
+- Browser version: **\_**
+- Firebase UI version: **\_**
+- Firebase SDK version: **\_**
+- Package name: **\_**
+
+<!-- Step 3 -->
+
+### [REQUIRED] Describe the problem
+
+#### Steps to reproduce
+
+<!--
+  What happened? How can we make the problem occur?
+  This could be a description, log/console output, etc.
+-->
+
+#### Relevant Code
+
+<!--
+  Reproduce the issue on StackBlitz and provide your forked URL
+  or give us some sample code below
+-->
+
+<https://stackblitz.com/fork/firebase-issue-sandbox>
+
+```javascript
+// TODO(you): code here to reproduce the problem
+```

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/lint.yaml

@@ -0,0 +1,35 @@
+name: Lint and Format Check
+
+on:
+  push:
+    branches:
+      - "@invertase/v7-development"
+  pull_request:
+
+jobs:
+  lint:
+    name: Lint and Format Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run ESLint check
+        run: pnpm run lint:check
+
+      - name: Run Prettier check
+        run: pnpm run format:check

.github/workflows/test.yaml

@@ -0,0 +1,49 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - "@invertase/v7-development"
+  pull_request:
+
+jobs:
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          check-latest: true
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build packages
+        run: pnpm run build
+
+      - name: Install Firebase CLI
+        run: npm i -g firebase-tools@14.15.2
+
+      - name: Start Firebase emulator
+        run: |
+          firebase emulators:start --only auth --project demo-test &
+          sleep 15
+          # Wait for emulator to be ready
+          until wget -q --spider http://localhost:9099 2>/dev/null; do
+            echo "Waiting for emulator to start..."
+            sleep 2
+          done
+          echo "Emulator is ready"
+
+      - name: Run tests
+        run: pnpm test

.gitignore

@@ -12,6 +12,19 @@ dist
 dist-ssr
 *.local
 
+# Angular
+.angular
+.firebase
+
+# Next.js
+.next
+
+# Coverage
+coverage
+
+# Firebase
+.firebase
+
 # Editor directories and files
 .vscode/*
 !.vscode/extensions.json

.opensource/project.json

@@ -1,19 +1,13 @@
 {
-    "name": "FirebaseUI for Web",
-
-    "platforms": [
-      "Web"
-    ],
-
-    "content": "README.md",
+  "name": "FirebaseUI for Web",
 
-    "pages" : {
-        "LANGUAGES.md": "Supported Languages"
-    },
-  
-    "related": [
-      "firebase/firebaseui-android",
-      "firebase/firebaseui-ios",
-      "firebase/firebaseui-web-react"
-    ]
+  "platforms": ["Web"],
+
+  "content": "README.md",
+
+  "pages": {
+    "LANGUAGES.md": "Supported Languages"
+  },
+
+  "related": ["firebase/firebaseui-android", "firebase/firebaseui-ios", "firebase/firebaseui-web-react"]
 }

.prettierignore

@@ -0,0 +1,23 @@
+# Dependencies
+node_modules/
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Build outputs
+dist/
+build/
+.angular/
+releases/
+
+# Generated files
+*.min.js
+*.min.css
+packages/styles/dist.css
+
+# Logs
+*.log
+
+# OS generated files
+.DS_Store
+Thumbs.db

packages/firebaseui-core/.prettierrc → .prettierrc

@@ -1,8 +1,9 @@
 {
   "semi": true,
   "trailingComma": "es5",
-  "singleQuote": true,
+  "singleQuote": false,
   "printWidth": 120,
   "tabWidth": 2,
-  "useTabs": false
+  "useTabs": false,
+  "endOfLine": "auto"
 }

GEMINI.md

@@ -0,0 +1,49 @@
+# Firebase UI for Web
+
+A library for building UIs with Firebase, with first class support for Angular and shad (with Shadcn).
+
+## General rules
+
+- The workspace is managed with pnpm. Always use pnpm commands for installation and execution.
+- This is a monorepo, with `packages` and `examples` sub-directories.
+- Linting is controlled by ESLint, via a root flatconfig `eslint.config.ts` file. Run `pnpm lint:check` for linting errors.
+- Formatting is controlled vi Prettier integrated with ESLint via the `.prettierrc` file. Run `pnpm format:check` for formatting errors.
+- The workspace uses pnpm cataloges to ensure dependency version alignment. If a dependency exists twice, it should be cataloged.
+- Tests can be run for the entire workspace via `pnpm test` or scoped to a package via `test:<name>`.
+
+## Structure
+
+The project structure is setup in a way which provides a framework agnostic set of packages; `core`, `translations` and `styles`.
+
+- `core`: The main entry-point to the package via `initalizeUI`. Firebase UI provides it's own functional exports, which when called wraps the Firebase JS SDK functionality, however manages state, translated error handling and behaviors (configurable by the user).
+- `translations`: A package exporting utilities and translation mappings for various languages, which `core` depends on.
+- `styles`: A package providing CSS utility classes which frameworks can use to provide consistent styling. The `styles` package works for existing Tailwind users, but also exports a distributable file with compiled "tailwindless" CSS. The CSS styles heavily depend on CSS variables for customization.
+
+Additionally, framework specific packages depend on these agnostic packages to offer full integration with the frameworks:
+
+- `react`: Exposes React UI components (in the form of screens, full page components, or forms, the bare-bones UI forms) & hooks, enabling users to easily build their own UIs or consume the built in ones.
+- `angular`: Exposes Angular UI components (in the form of screens, full page components, or forms, the bare-bones UI forms) & DI functionality, enabling users to easily build their own UIs or consume the built in ones. This package depends directly on AngularFire.
+
+The dependency graph is:
+
+```
+graph TD
+  core --> translations;
+  react --> core;
+  angular --> core;
+  angular --> styles;
+  react --> styles;
+  shadcn --> react;
+```
+
+## Misc
+
+- All packages extend the same base `tsconfig.json` file.
+- Where possible, prefer Vitest testing framework.
+
+## Additional Context
+
+- `core`: @./packages/core/GEMINI.md
+- `react`: @./packages/react/GEMINI.md
+- `styles`: @./packages/styles/GEMINI.md
+- `translations`: @./packages/translations/GEMINI.md