Merge Dev To Master

.docker/Dockerfile

@@ -0,0 +1,23 @@
+# BUILD
+FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
+WORKDIR /src
+
+ENV CI=true
+
+COPY docs/website/CodeBeam.UltimateAuth.Docs.Wasm/CodeBeam.UltimateAuth.Docs.Wasm/*.csproj CodeBeam.Website/
+COPY docs/website/CodeBeam.UltimateAuth.Docs.Wasm/CodeBeam.UltimateAuth.Docs.Wasm.Client/*.csproj CodeBeam.Website.Client/
+
+RUN dotnet restore CodeBeam.Website/CodeBeam.UltimateAuth.Docs.Wasm.csproj
+
+COPY . .
+
+RUN dotnet publish docs/website/CodeBeam.UltimateAuth.Docs.Wasm/CodeBeam.UltimateAuth.Docs.Wasm/CodeBeam.UltimateAuth.Docs.Wasm.csproj \
+    -c Release -o /app/publish
+
+# RUNTIME
+FROM mcr.microsoft.com/dotnet/aspnet:10.0
+WORKDIR /app
+COPY --from=build /app/publish .
+
+EXPOSE 8080
+ENTRYPOINT ["dotnet", "CodeBeam.UltimateAuth.Docs.Wasm.dll"]

.docker/docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  ultimateauth:
+    build:
+      context: ..
+      dockerfile: .docker/Dockerfile
+    container_name: ultimateauth
+    restart: always
+    ports:
+      - "8081:8080"
+    networks:
+      - edge
+
+networks:
+  edge:
+    external: true

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: CodeBeamOrg
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: "🐞 Bug Report"
+about: Report a reproducible issue to help us improve UltimateAuth
+title: "[Bug]: "
+labels: bug
+assignees: ""
+---
+
+## 🐞 Bug Description
+A clear and concise description of the issue.
+
+
+
+## 📌 Steps to Reproduce
+1. Go to '...'
+2. Call method '...'
+3. Observe behavior '...'
+
+
+
+## 🧪 Expected Behavior
+What should have happened?
+
+
+## 📷 Screenshots / Logs (if applicable)
+Paste stack traces, console logs, or screenshots.
+
+
+
+## 🧩 Environment
+- UltimateAuth version:
+- .NET version:
+- Platform: (Blazor / MAUI / ASP.NET Core / Other)
+- OS:
+
+
+
+## ✔ Additional Context
+Add any other relevant context about the problem here.

.github/ISSUE_TEMPLATE/design_proposal.md

@@ -0,0 +1,45 @@
+---
+name: "🧠 Design Proposal"
+about: Propose a high-level design for a new component, flow, or architectural change
+title: "[Design]: "
+labels: design
+assignees: ""
+---
+
+## 🧠 Summary
+Briefly describe the concept or design you're proposing.
+
+---
+
+## 🎯 Goals
+What problem does this design solve?
+What are the objectives?
+
+---
+
+## 🧩 Proposed Architecture
+Describe how this feature or change should work:
+- Components involved  
+- Flow diagrams (optional)  
+- Key abstractions  
+- Input/output expectations
+
+---
+
+## 🧪 Alternatives Considered
+List alternative designs and why they were not chosen.
+
+---
+
+## 🔥 Risks / Trade-offs
+Any potential drawbacks or complexities?
+
+---
+
+## 🔗 Related Issues
+(Optional) Provide related bugs, features, or discussions.
+
+---
+
+## ✔ Additional Notes
+Add anything else that may help the maintainers evaluate this proposal.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,33 @@
+---
+name: "✨ Feature Request"
+about: Suggest a new idea or enhancement for UltimateAuth
+title: "[Feature]: "
+labels: enhancement
+assignees: ""
+---
+
+## ✨ Feature Description
+Describe the feature you'd like to see.
+
+---
+
+## 💡 Why Is This Needed?
+Explain the problem this feature solves or the value it provides.
+
+---
+
+## 🛠 Suggested Implementation
+If you have any implementation ideas, describe them:
+- Proposed API shape
+- Example usage
+- Integration points
+
+---
+
+## 🔗 Related Issues / Discussions
+(Optional) Link any related issues or design proposals.
+
+---
+
+## ✔ Additional Notes
+Anything else we should know?

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,37 @@
+# 🚀 Pull Request
+
+Thank you for contributing to **UltimateAuth**!  
+Please complete the following checklist to help us review your PR effectively.
+
+---
+
+## 📘 Summary
+Describe what this PR does and why it’s needed.
+
+---
+
+## 🔍 Details
+Explain any important implementation details, design decisions, or considerations.
+
+---
+
+## 🧩 Related Issues
+Link any related issues:
+<!-- Example: Fixes #42 -->
+
+---
+
+## 🛠 Changes
+- [ ] New feature
+- [ ] Bug fix
+- [ ] Documentation
+- [ ] Refactoring
+- [ ] Breaking change
+
+---
+
+## ✔ Checklist
+- [ ] I’ve tested my changes
+- [ ] I’ve added comments or documentation where needed
+- [ ] I’ve followed the project’s coding conventions
+- [ ] I’ve validated that the API surface is stable

.github/codecov.yml

@@ -0,0 +1,13 @@
+comment:
+  require_changes: yes
+
+coverage:
+  status:
+    project:
+      default:
+        target: 50%
+        threshold: 5%
+    patch:
+      default:
+        target: 20%
+        threshold: 0%

.github/workflows/deploy.yml

@@ -0,0 +1,26 @@
+name: Deploy UltimateAuth
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USER }}
+          key: ${{ secrets.SSH_PRIVATE_KEY }}
+          script: |
+            cd ~/apps/UltimateAuth
+            git pull origin master
+            cd .docker
+            docker compose down
+            docker compose up -d --build
+

.github/workflows/ultimateauth-ci.yml

@@ -0,0 +1,46 @@
+name: UltimateAuth CI
+
+on:
+  push:
+    branches: [ dev ]
+  pull_request:
+    branches: [ dev ]
+  workflow_dispatch:
+
+jobs:
+  build-test-coverage:
+    name: Build, Test & Coverage
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        dotnet-version: ['8.0.x', '9.0.x', '10.0.x']
+
+    steps:
+    - name: 📥 Checkout repository
+      uses: actions/checkout@v4
+
+    - name: 🧰 Setup .NET SDK ${{ matrix.dotnet-version }}
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: ${{ matrix.dotnet-version }}
+
+    - name: 📦 Restore dependencies
+      run: dotnet restore
+
+    - name: 🏗️ Build
+      run: dotnet build --configuration Release --no-restore
+
+    - name: 🧪 Test with coverage
+      run: |
+        dotnet test \
+          --configuration Release \
+          --no-build \
+          --collect:"XPlat Code Coverage"
+
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        slug: CodeBeamOrg/UltimateAuth

.gitignore

@@ -194,6 +194,7 @@ PublishScripts/
 
 # NuGet Packages
 *.nupkg
+nupkgs/
 # NuGet Symbol Packages
 *.snupkg
 # The packages folder can be ignored because of Package Restore