firebase
diff --git a/‎.github/ISSUE_TEMPLATE/bug_report.md‎
Lines changed: 53 additions & 0 deletions b/‎.github/ISSUE_TEMPLATE/bug_report.md‎
Lines changed: 53 additions & 0 deletions
diff --git a/‎.github/ISSUE_TEMPLATE/feature_request.md‎
Lines changed: 16 additions & 0 deletions b/‎.github/ISSUE_TEMPLATE/feature_request.md‎
Lines changed: 16 additions & 0 deletions
diff --git a/‎.github/readme-banner.png‎
308 KB b/‎.github/readme-banner.png‎
308 KB
diff --git a/‎.github/workflows/lint.yaml‎
Lines changed: 35 additions & 0 deletions b/‎.github/workflows/lint.yaml‎
Lines changed: 35 additions & 0 deletions
diff --git a/‎.github/workflows/test.yaml‎
Lines changed: 51 additions & 0 deletions b/‎.github/workflows/test.yaml‎
Lines changed: 51 additions & 0 deletions
diff --git a/‎.gitignore‎
Lines changed: 13 additions & 0 deletions b/‎.gitignore‎
Lines changed: 13 additions & 0 deletions
diff --git a/‎.opensource/project.json‎
Lines changed: 10 additions & 16 deletions b/‎.opensource/project.json‎
Lines changed: 10 additions & 16 deletions
diff --git a/‎.prettierignore‎
Lines changed: 23 additions & 0 deletions b/‎.prettierignore‎
Lines changed: 23 additions & 0 deletions
diff --git a/‎packages/firebaseui-core/.prettierrc‎ renamed to ‎.prettierrc‎
Lines changed: 3 additions & 2 deletions b/‎packages/firebaseui-core/.prettierrc‎ renamed to ‎.prettierrc‎
Lines changed: 3 additions & 2 deletions
diff --git a/‎CONTRIBUTING.md‎
Lines changed: 135 additions & 0 deletions b/‎CONTRIBUTING.md‎
Lines changed: 135 additions & 0 deletions
@@ -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
+```
@@ -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.
@@ -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
@@ -0,0 +1,51 @@
+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 [email protected]
+
+      - name: Enable webframeworks experiment
+        run: firebase experiments:enable webframeworks
+
+      - 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
@@ -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
 
@@ -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"]
 }
@@ -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
@@ -1,8 +1,9 @@
 {
   "semi": true,
   "trailingComma": "es5",
-  "singleQuote": true,
+  "singleQuote": false,
   "printWidth": 120,
   "tabWidth": 2,
-  "useTabs": false
+  "useTabs": false,
+  "endOfLine": "auto"
 }
@@ -1,6 +1,129 @@
 Want to contribute? Great! First, read this page (including the small print at
 the end).
 
+## Setup
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) (version 18 or higher recommended)
+- [pnpm](https://pnpm.io/) - This workspace uses pnpm for package management
+
+### Installation
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/firebase/firebaseui-web.git
+   cd firebaseui-web
+   ```
+
+2. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+### Development Workflow
+
+This is a monorepo managed with pnpm, containing both `packages` and `examples` sub-directories.
+
+#### Building
+
+Build all packages:
+
+```bash
+pnpm build
+```
+
+Build only the packages (excluding examples):
+
+```bash
+pnpm build:packages
+```
+
+#### Testing
+
+Run all tests:
+
+```bash
+pnpm test
+```
+
+Run tests in watch mode:
+
+```bash
+pnpm test:watch
+```
+
+Run tests for a specific package:
+
+```bash
+pnpm --filter=<package-name> run test
+```
+
+#### Linting and Formatting
+
+Check for linting errors:
+
+```bash
+pnpm lint:check
+```
+
+Fix linting errors automatically:
+
+```bash
+pnpm lint:fix
+```
+
+Check for formatting issues:
+
+```bash
+pnpm format:check
+```
+
+Format code automatically:
+
+```bash
+pnpm format:write
+```
+
+### Project Structure
+
+The project is organized as follows:
+
+- **`packages/`**: Framework-agnostic and framework-specific packages
+  - `core`: Framework-agnostic core package providing `initializeUI` and authentication functions
+  - `translations`: Translation utilities and locale mappings
+  - `styles`: CSS utility classes and compiled styles
+  - `react`: React components and hooks
+  - `angular`: Angular components and DI functionality
+  - `shadcn`: Shadcn UI components
+
+- **`examples/`**: Example applications demonstrating usage
+  - `react`: React example
+  - `nextjs`: Next.js example
+  - `nextjs-ssr`: Next.js SSR example
+  - `angular`: Angular example
+  - `shadcn`: Shadcn example
+
+The dependency graph:
+
+```
+core → translations
+react → core
+angular → core
+react → styles
+angular → styles
+shadcn → react
+```
+
+### Additional Notes
+
+- All packages extend the same base `tsconfig.json` file
+- Vitest is the preferred testing framework
+- The workspace uses pnpm catalogs to ensure dependency version alignment
+- Linting is controlled by ESLint via a root flatconfig `eslint.config.ts` file
+- Formatting is controlled by Prettier integrated with ESLint via the `.prettierrc` file
+
 ### Before you contribute
 
 Before we can use your code, you must sign the [Google Individual Contributor
@@ -36,6 +159,18 @@ All submissions, including submissions by project members, require review. We
 use Github pull requests for this purpose. Please refer to the
 [Style Guide](STYLEGUIDE.md) and ensure you respect it before submitting a PR.
 
+### Releasing
+
+See [`cloudbuild.yaml`](./cloudbuild.yaml) and [`publish.sh`](./publish.sh) for the full release process.
+
+#### Experimental versions
+
+All new commits to the main branch are published to npm under the `exp` tag.
+
+#### Release versions
+
+When a tag of the form `v1.0.0` is created, that version is published to npm under the `beta` tag.
+
 ### The small print
 
 Contributions made by corporations are covered by a different agreement than the
Original file line number	Diff line number	Diff line change
`@@ -1,8 +1,9 @@`
`1`	`1`	`{`
`2`	`2`	`"semi": true,`
`3`	`3`	`"trailingComma": "es5",`
`4`		`- "singleQuote": true,`
	`4`	`+ "singleQuote": false,`
`5`	`5`	`"printWidth": 120,`
`6`	`6`	`"tabWidth": 2,`
`7`		`- "useTabs": false`
	`7`	`+ "useTabs": false,`
	`8`	`+ "endOfLine": "auto"`
`8`	`9`	`}`