CodeBeamOrg · mckaragoz · Apr 9, 2026 · Apr 7, 2026 · Apr 8, 2026 · Apr 9, 2026
diff --git a/Directory.Build.props b/Directory.Build.props
@@ -1,13 +1,13 @@
 <Project>
 	<PropertyGroup>
-		<Version>0.1.0-preview.1</Version>
+		<Version>0.1.0-preview.2</Version>
 		<NoWarn>$(NoWarn);1591</NoWarn>
 
 		<Authors>CodeBeam</Authors>
 		<Company>CodeBeam</Company>
 
 		<RepositoryUrl>https://github.com/CodeBeamOrg/UltimateAuth</RepositoryUrl>
-		<PackageProjectUrl>https://github.com/CodeBeamOrg/UltimateAuth</PackageProjectUrl>
+		<PackageProjectUrl>https://ultimateauth.com</PackageProjectUrl>
 		<PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
 
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>

diff --git a/UltimateAuth.slnx b/UltimateAuth.slnx
@@ -25,6 +25,9 @@
     <Project Path="tests/CodeBeam.UltimateAuth.Tests.Integration/CodeBeam.UltimateAuth.Tests.Integration.csproj" Id="fe34a0b1-8038-400d-b8ab-02dad7051f2d" />
     <Project Path="tests/CodeBeam.UltimateAuth.Tests.Unit/CodeBeam.UltimateAuth.Tests.Unit.csproj" Id="6f4b22da-849a-4a79-b5c5-aee7cb1429a6" />
   </Folder>
+  <Folder Name="/Utilities/">
+    <Project Path="src/utilities/CodeBeam.UltimateAuth.DocsBuilder/CodeBeam.UltimateAuth.DocsBuilder.csproj" Id="07c6062a-96c8-40b7-972b-ad27ac11725b" />
+  </Folder>
   <Project Path="src/authentication/CodeBeam.UltimateAuth.Authentication.EntityFrameworkCore/CodeBeam.UltimateAuth.Authentication.EntityFrameworkCore.csproj" Id="a8d758ad-052e-4331-9bf7-280ea9a55981" />
   <Project Path="src/authentication/CodeBeam.UltimateAuth.Authentication.InMemory/CodeBeam.UltimateAuth.Authentication.InMemory.csproj" Id="bd87e254-0565-4fc5-950d-ee5bbb416079" />
   <Project Path="src/authorization/CodeBeam.UltimateAuth.Authorization.Contracts/CodeBeam.UltimateAuth.Authorization.Contracts.csproj" Id="40a23002-f885-42a8-bdd9-fd962ab28742" />

diff --git a/docs/content/_groups.json b/docs/content/_groups.json
@@ -0,0 +1,9 @@
+{
+  "getting-started": 1,
+  "fundamentals": 2,
+  "auth-flows": 3,
+  "plugin-domains": 4,
+  "client": 5,
+  "configuration": 6,
+  "security": 7
+}
diff --git a/docs/content/auth-flows/device-management.md b/docs/content/auth-flows/device-management.md
@@ -1,3 +1,10 @@
+---
+title: Device Management
+order: 7
+group: auth-flows
+---
+
+
 # 📱 Device Management
 
 In UltimateAuth, devices are not an afterthought.

diff --git a/docs/content/auth-flows/index.md b/docs/content/auth-flows/index.md
@@ -1,3 +1,10 @@
+---
+title: Auth Flows
+order: 1
+group: auth-flows
+---
+
+
 # 🔐 Auth Flows
 
 Authentication in UltimateAuth is not a single operation.

diff --git a/docs/content/auth-flows/login-flow.md b/docs/content/auth-flows/login-flow.md
@@ -1,3 +1,10 @@
+---
+title: Login
+order: 2
+group: auth-flows
+---
+
+
 # 🔑 Login Flow
 The login flow in UltimateAuth is not just credential validation.
 

diff --git a/docs/content/auth-flows/logout-flow.md b/docs/content/auth-flows/logout-flow.md
@@ -1,3 +1,10 @@
+---
+title: Logout
+order: 4
+group: auth-flows
+---
+
+
 # 🚪 Logout Flow
 The logout flow in UltimateAuth is not a single action.
 

diff --git a/docs/content/auth-flows/refresh-flow.md b/docs/content/auth-flows/refresh-flow.md
@@ -1,3 +1,10 @@
+---
+title: Refresh
+order: 3
+group: auth-flows
+---
+
+
 # 🔄 Refresh Flow
 The refresh flow in UltimateAuth is not a single fixed operation.
 

diff --git a/docs/content/auth-flows/session-lifecycle.md b/docs/content/auth-flows/session-lifecycle.md
@@ -1,3 +1,10 @@
+---
+title: Session Lifecycle
+order: 5
+group: auth-flows
+---
+
+
 # 🧬 Session Lifecycle
 UltimateAuth is built around a structured session model.
 

diff --git a/docs/content/auth-flows/token-behavior.md b/docs/content/auth-flows/token-behavior.md
@@ -1,3 +1,10 @@
+---
+title: Token Behavior
+order: 6
+group: auth-flows
+---
+
+
 # 🎟 Token Behavior
 In UltimateAuth, tokens are not the foundation of authentication.
 

diff --git a/docs/content/client/authentication.md b/docs/content/client/authentication.md
@@ -1,3 +1,10 @@
+---
+title: Authentication
+order: 2
+group: client
+---
+
+
 # 🔐 Authentication Guide
 
 This section explains how to use the UltimateAuth client for authentication flows.

diff --git a/docs/content/client/authorization.md b/docs/content/client/authorization.md
@@ -1,3 +1,10 @@
+---
+title: Authorization
+order: 7
+group: client
+---
+
+
 # 🛡 Authorization Guide
 
 This section explains how to manage roles, permissions, and access control using the UltimateAuth client.

diff --git a/docs/content/client/credentials.md b/docs/content/client/credentials.md
@@ -1,3 +1,10 @@
+---
+title: Credentials
+order: 6
+group: client
+---
+
+
 # 🔑 Credential Management Guide
 
 This section explains how to manage user credentials (such as passwords) using the UltimateAuth client.

diff --git a/docs/content/client/identifiers.md b/docs/content/client/identifiers.md
@@ -1,3 +1,10 @@
+---
+title: Identifiers
+order: 5
+group: client
+---
+
+
 # 🆔 User Identifiers Guide
 
 This section explains how UltimateAuth manages user identifiers such as email, username, and phone.

diff --git a/docs/content/client/index.md b/docs/content/client/index.md
@@ -1,3 +1,10 @@
+---
+title: Client & API
+order: 1
+group: client
+---
+
+
 # 🚀 Client Usage Guide
 
 UltimateAuth Client is a **high-level SDK** designed to simplify authentication flows.

diff --git a/docs/content/client/session-management.md b/docs/content/client/session-management.md
@@ -1,3 +1,10 @@
+---
+title: Session Management
+order: 3
+group: client
+---
+
+
 # 📱 Session Management Guide
 
 This section explains how to manage sessions and devices using the UltimateAuth client.

diff --git a/docs/content/client/user-management.md b/docs/content/client/user-management.md
@@ -1,3 +1,10 @@
+---
+title: User Management
+order: 4
+group: client
+---
+
+
 # 👤 User Management Guide
 
 This section explains how to manage users using the UltimateAuth client.

diff --git a/docs/content/configuration/advanced-configuration.md b/docs/content/configuration/advanced-configuration.md
@@ -1,3 +1,10 @@
+---
+title: Advanced Configuration
+order: 6
+group: configuration
+---
+
+
 # 🧠 Advanced Configuration
 
 UltimateAuth is designed to be flexible — but not fragile.

diff --git a/docs/content/configuration/client-options.md b/docs/content/configuration/client-options.md
@@ -1,3 +1,10 @@
+---
+title: Client Options
+order: 4
+group: configuration
+---
+
+
 # 🧩 Client Options
 
 Client Options define how UltimateAuth behaves on the **client side**.

diff --git a/docs/content/configuration/configuration-overview.md b/docs/content/configuration/configuration-overview.md
@@ -1,3 +1,10 @@
+---
+title: Configuration Overview
+order: 2
+group: configuration
+---
+
+
 # 🧠 Configuration Overview
 
 UltimateAuth is not configured as a static system.
@@ -161,6 +168,5 @@ If you remember one thing:
 
 ## ➡️ Next Step
 
-- Deep dive into behavior → Core Options  
 - Control runtime → Server Options  
 - Configure clients → Client Options  
diff --git a/docs/content/configuration/configuration-sources.md b/docs/content/configuration/configuration-sources.md
@@ -1,3 +1,10 @@
+---
+title: Configuration Sources
+order: 5
+group: configuration
+---
+
+
 # ⚙️ Configuration Sources
 
 UltimateAuth supports multiple configuration sources.

diff --git a/docs/content/configuration/index.md b/docs/content/configuration/index.md
@@ -1,3 +1,10 @@
+---
+title: Configuration
+order: 1
+group: configuration
+---
+
+
 # ⚙️ Configuration & Extensibility
 
 UltimateAuth is designed to be flexible.

diff --git a/docs/content/configuration/server-options.md b/docs/content/configuration/server-options.md
@@ -1,3 +1,10 @@
+---
+title: Server Options
+order: 3
+group: configuration
+---
+
+
 # 🧩 Server Options
 
 UltimateAuth is configured primarily through **Server Options**.

diff --git a/docs/content/fundamentals/auth-model.md b/docs/content/fundamentals/auth-model.md
@@ -1,3 +1,10 @@
+---
+title: Authentication Model
+order: 2
+group: fundamentals
+---
+
+
 # 🧠 Authentication Model
 
 UltimateAuth is built around a simple but powerful idea:

diff --git a/docs/content/fundamentals/auth-modes.md b/docs/content/fundamentals/auth-modes.md
@@ -1,3 +1,10 @@
+---
+title: Authentication Modes
+order: 4
+group: fundamentals
+---
+
+
 > Note: SemiHybrid and PureJwt modes will be available on future releases. For now you can safely use PureOpaque and Hybrid modes.
 
 # 🔐 Authentication Modes

diff --git a/docs/content/fundamentals/client-profiles.md b/docs/content/fundamentals/client-profiles.md
@@ -1,3 +1,10 @@
+---
+title: Client Profiles
+order: 5
+group: fundamentals
+---
+
+
 # 🧩 Client Profiles
 UltimateAuth adapts its authentication behavior based on the client.
 

diff --git a/docs/content/fundamentals/flow-based-auth.md b/docs/content/fundamentals/flow-based-auth.md
@@ -1,3 +1,10 @@
+---
+title: Flow Based Authentication
+order: 3
+group: fundamentals
+---
+
+
 # 🔄 Flow-Based Authentication
 UltimateAuth is not cookie-based or token-based.
 

diff --git a/docs/content/fundamentals/index.md b/docs/content/fundamentals/index.md
@@ -1,12 +1,22 @@
-# 🧠 Fundamentals
+---
+title: Fundamental Overview
+order: 1
+group: fundamentals
+---
+
+# Overview
+
 
 This section explains how UltimateAuth works internally.
 
+
+# Section Order
+
 If you are new, follow this order:
 
-1. [Authentication Model](./auth-model.md)
-2. [Flow-Based Authentication](./flow-based-auth.md)
-3. [Authentication Modes](./auth-modes.md)
-4. [Client Profiles](./client-profiles.md)
-5. [Runtime Architecture](./runtime-architecture.md)
-6. [Request Lifecycle](./request-lifecycle.md)
+- Authentication Model
+- Flow-Based Authentication
+- Authentication Modes
+- Client Profiles
+- Runtime Architecture
+- Request Lifecycle
diff --git a/docs/content/fundamentals/request-lifecycle.md b/docs/content/fundamentals/request-lifecycle.md
@@ -1,3 +1,10 @@
+---
+title: Request Lifecycle
+order: 7
+group: fundamentals
+---
+
+
 # 🔄 Request Lifecycle
 This section explains what happens when a request enters UltimateAuth.
 

diff --git a/docs/content/fundamentals/runtime-architecture.md b/docs/content/fundamentals/runtime-architecture.md
@@ -1,3 +1,10 @@
+---
+title: Runtime Architecture
+order: 6
+group: fundamentals
+---
+
+
 # 🏗 Runtime Architecture
 
 UltimateAuth processes authentication through a structured execution pipeline.

diff --git a/docs/content/getting-started/index.md b/docs/content/getting-started/index.md
@@ -1,3 +1,9 @@
+---
+title: Getting Started
+order: 1
+group: getting-started
+---
+
 # 🚀 Getting Started
 
 Welcome to **UltimateAuth** — the modern authentication framework for .NET.

diff --git a/docs/content/getting-started/quickstart.md b/docs/content/getting-started/quickstart.md
@@ -1,3 +1,9 @@
+---
+title: QuickStart
+order: 2
+group: getting-started
+---
+
 # ⚡ Quick Start
 
 In this guide, you will set up UltimateAuth in a few minutes and perform your **first login**.

diff --git a/docs/content/getting-started/real-world-setup.md b/docs/content/getting-started/real-world-setup.md
@@ -1,3 +1,9 @@
+---
+title: Real World Setup
+order: 3
+group: getting-started
+---
+
 # 🏗 Real-World Setup
 
 The Quick Start uses an in-memory setup for simplicity.