@@ -25,7 +25,7 @@ UltimateAuth is an open-source authentication framework that unifies secure sess
 
 ## 🌟 Why UltimateAuth: The Six-Point Principles
 
-### **1) Developer-Centric**
+### **1) Developer-Centric & User-Friendly**
 Clean APIs, predictable behavior, minimal ceremony — designed to make authentication *pleasant* for developers.
 
 ### **2) Security-Driven**
@@ -38,40 +38,159 @@ No forced dependencies. No unnecessary weight.
 ### **4) Plug-and-Play Ready**
 From setup to production, UltimateAuth prioritizes a frictionless integration journey with sensible defaults.
 
-### **5) User-Friendly Flows**
-Authentication should be secure *and* intuitive.  
-Consistent, predictable, and UX-friendly at every step.
-
-### **6) Blazor & MAUI-Ready for Modern .NET**
+### **5) Blazor & MAUI-Ready for Modern .NET**
 Blazor WebApp, Blazor WASM, Blazor Server, and .NET MAUI expose weaknesses in traditional auth systems.  
 UltimateAuth is engineered from day one to support real-world scenarios across the entire modern .NET UI stack.
 
----
-
-## 🔑 What UltimateAuth Provides
+### **6) Unified Framework**
+One solution, same codebase across Blazor server, WASM and MAUI. UltimateAuth handles client differences internally and providing consistent and reliable public API.
 
-- A **secure, modern session-based authentication core**  
-  (opaque SessionId, server-managed, real-time revocation, device tracking)
-
-- A **unified architecture** bridging Session, PKCE, and OAuth-style auth flows
+---
 
-- An **override-first design** suitable for enterprise extensions
+# 🚀 Quick Start
+
+### 1) Install packages (Will be available soon)
+
+1.1 Core Packages
+```bash
+dotnet add package CodeBeam.UltimateAuth.Server
+dotnet add package CodeBeam.UltimateAuth.Client.Blazor
+```
+1.2 Persistence & Reference Packages (Choose One)
+```bash
+dotnet add package CodeBeam.UltimateAuth.InMemory.Bundle (for debug & development)
+dotnet add package CodeBeam.UltimateAuth.EntityFrameworkCore.Bundle (for production)
+```
+### 2) Configure services (in program.cs)
+Server registration:
+```csharp
+builder.Services
+    .AddUltimateAuthServer()
+    .AddUltimateAuthEntityFrameworkCore(); // Production
+
+// OR
+
+builder.Services
+    .AddUltimateAuthServer()
+    .AddUltimateAuthInMemory(); // Development
+
+```
+
+Client registration:
+
+```csharp
+builder.Services.AddUltimateAuthClientBlazor();
+```
+**Usage by application type:**
+
+- **Blazor Server App** → Use both Server and Client registrations  
+- **Blazor WASM / MAUI** → Use Client only  
+- **Auth Server / Resource API** → Use Server only
+
+### 3) Configure pipeline
+```csharp
+// app.UseHttpsRedirection();
+// app.UseStaticFiles();
+
+app.UseUltimateAuthWithAspNetCore(); // Includes UseAuthentication() and UseAuthorization()
+// Place Antiforgery or something else needed
+app.MapUltimateAuthEndpoints();
+
+app.MapRazorComponents<App>()
+    .AddInteractiveServerRenderMode()
+    .AddUltimateAuthRoutes(UAuthAssemblies.BlazorClient());
+```
+
+### 4) Add UAuth Script
+Place this in `App.razor` or `index.html`
+```csharp
+<script src="_content/CodeBeam.UltimateAuth.Client.Blazor/uauth.min.js"></script>
+```
+
+### 5) Optional: Blazor Usings
+Add this in `_Imports.razor`
+```csharp
+@using CodeBeam.UltimateAuth.Client.Blazor
+```
+
+### ✅ Done
 
-- A **production-grade client SDK** for Blazor & MAUI
+---
 
-- A **fully interactive sandbox**  
-  where developers can test flows, create accounts, simulate devices, and validate behaviors in real time
+## Usage
+
+Inject IUAuthClient and simply call methods.
+
+### Examples
+Login
+```csharp
+[Inject] IUAuthClient UAuthClient { get; set; } = null!;
+
+private async Task Login()
+{
+    var request = new LoginRequest
+    {
+        Identifier = "UAuthUser",
+        Secret = "UAuthPassword",
+    };
+    await UAuthClient.Flows.LoginAsync(request);
+}
+```
+
+Register
+```csharp
+[Inject] IUAuthClient UAuthClient { get; set; } = null!;
+
+private async Task Register()
+{
+    var request = new CreateUserRequest
+    {
+        UserName = _username,
+        Password = _password,
+        Email = _email,
+    };
+
+    var result = await UAuthClient.Users.CreateAsync(request);
+    if (result.IsSuccess)
+    {
+        Console.WriteLine("User created successfully.");
+    }
+    else
+    {
+        Console.WriteLine(result.ErrorText ?? "Failed to create user.");
+    }
+}
+```
+
+LogoutAll But Keep Current Device
+```csharp
+[Inject] IUAuthClient UAuthClient { get; set; } = null!;
+
+private async Task LogoutOthersAsync()
+{
+    var result = await UAuthClient.Flows.LogoutOtherDevicesSelfAsync();
+    Console.WriteLine(result.IsSuccess);
+}
+```
+
+UltimateAuth turns Auth into a simple application service — not a separate system you fight against.
+- No manual token handling
+- No custom HTTP plumbing
+- No fragile redirect logic
+- All built-in with extensible options.
 
 ---
 
+
 ## 📅 Release Timeline (Targeted)
 
 > _Dates reflect targeted milestones and may evolve with community feedback._
 
-### **Q1 2026 — First Release (v 0.0.1 to v 0.1.0)**
-- Core session-based auth engine  
+### **Q1 2026 — First Release**
+- v 0.1.0-preview to v 0.1.0
 
-### **Q2 2026 — Stable Feature Release**
+### **Q2 2026 — Stable Feature Releases**
+- v 0.2.0 to v 0.3.0
 
 ### **Q3 2026 — General Availability**
 - API surface locked  
@@ -83,6 +202,18 @@ UltimateAuth adopts .NET platform versioning to align with the broader ecosystem
 
 ---
 
+## 🗺 Roadmap
+
+The project roadmap is actively maintained as a GitHub issue:
+
+👉 https://github.com/CodeBeamOrg/UltimateAuth/issues/8
+
+We keep it up-to-date with current priorities, planned features, and progress.
+
+Feel free to follow, comment, or contribute ideas.
+
+---
+
 ## 📘 Documentation
 
 Two documentation experiences will be provided:
@@ -100,20 +231,23 @@ Create accounts, simulate devices, test auth flows, and observe UltimateAuth in
 UltimateAuth is a community-first framework.  
 We welcome proposals, discussions, architectural insights, and contributions of all sizes.
 
-Before contributing, please see:
-
-- `ROADMAP.md` — Release strategy
-
 Discussions are open — your ideas matter.
 
 ---
 
 ## 🛠 Project Status
 
-UltimateAuth is currently in the design and specification phase.  
-We are shaping the architecture with real-world requirements, especially from Blazor and MAUI applications.
+UltimateAuth core architecture is implemented and validated through the sample application.
+
+We are currently:
+
+- Polishing developer experience
+- Reviewing public APIs
+- Preparing EF Core integration packages
+
+Preview release is coming soon.
 
-Early API drafts and prototypes will be published soon.
+You can check the samples and try what UltimateAuth offers by downloading repo and running locally.
 
 ---
 
 
@@ -1,7 +1,8 @@
 <Solution>
   <Folder Name="/Packages/">
     <Project Path="nuget/CodeBeam.UltimateAuth.EntityFrameworkCore/CodeBeam.UltimateAuth.EntityFrameworkCoreReference.csproj" Id="764569b4-dd5b-4a18-a332-7307d20ee21a" />
-    <Project Path="nuget/CodeBeam.UltimateAuth.InMemory/CodeBeam.UltimateAuth.InMemoryReference.csproj" />
+    <Project Path="nuget/CodeBeam.UltimateAuth.InMemory/CodeBeam.UltimateAuth.InMemory.Bundle.csproj" />
+    <Project Path="nuget/CodeBeam.UltimateAuth.Reference.Bundle/CodeBeam.UltimateAuth.Reference.Bundle.csproj" Id="f01dee6a-a60d-40a2-bb6a-9894b03e7122" />
   </Folder>
   <Folder Name="/Samples/">
     <Project Path="samples/blazor-server/CodeBeam.UltimateAuth.Sample.BlazorServer/CodeBeam.UltimateAuth.Sample.BlazorServer.csproj" />
@@ -24,9 +25,8 @@
   <Project Path="src/authorization/CodeBeam.UltimateAuth.Authorization.InMemory/CodeBeam.UltimateAuth.Authorization.InMemory.csproj" Id="a1e6d007-bdc0-4574-b549-ec863757edd3" />
   <Project Path="src/authorization/CodeBeam.UltimateAuth.Authorization.Reference/CodeBeam.UltimateAuth.Authorization.Reference.csproj" Id="84b784d0-bb48-406a-a0d1-c600da667597" />
   <Project Path="src/authorization/CodeBeam.UltimateAuth.Authorization/CodeBeam.UltimateAuth.Authorization.csproj" Id="28b1d647-fb0b-4cc3-8503-2680c4a9b28f" />
-  <Project Path="src/client/CodeBeam.UltimateAuth.Client/CodeBeam.UltimateAuth.Client.csproj" Id="fa128a9b-613c-4762-993a-2886280d3051" />
-  <Project Path="src\client/CodeBeam.UltimateAuth.Client.JsMinifier/CodeBeam.UltimateAuth.Client.JsMinifier.csproj" Id="ef5cfc86-bfd3-4f81-a973-ce7ef58e7525" />
   <Project Path="src/client/CodeBeam.UltimateAuth.Client.Blazor/CodeBeam.UltimateAuth.Client.Blazor.csproj" Id="eb60a3b7-ba9d-48c9-98ad-b28e879b23bf" />
+  <Project Path="src/client/CodeBeam.UltimateAuth.Client/CodeBeam.UltimateAuth.Client.csproj" Id="fa128a9b-613c-4762-993a-2886280d3051" />
   <Project Path="src/CodeBeam.UltimateAuth.Core/CodeBeam.UltimateAuth.Core.csproj" />
   <Project Path="src/CodeBeam.UltimateAuth.Server/CodeBeam.UltimateAuth.Server.csproj" Id="0a8cdd12-a8c4-4530-87e8-ae778c46322b" />
   <Project Path="src/credentials/CodeBeam.UltimateAuth.Credentials.Contracts/CodeBeam.UltimateAuth.Credentials.Contracts.csproj" Id="88b70848-fa74-40ea-bf34-3fa2f70f4f37" />
@@ -47,4 +47,5 @@
   <Project Path="src/users/CodeBeam.UltimateAuth.Users.InMemory/CodeBeam.UltimateAuth.Users.InMemory.csproj" Id="7ce3df22-4773-4b9b-afd0-8ba506e0f9de" />
   <Project Path="src/users/CodeBeam.UltimateAuth.Users.Reference/CodeBeam.UltimateAuth.Users.Reference.csproj" Id="601176dd-b760-4b6f-9cc7-c618134ae178" />
   <Project Path="src/users/CodeBeam.UltimateAuth.Users/CodeBeam.UltimateAuth.Users.csproj" Id="30d5db36-6dc8-46f6-9139-8b6b3d6053d5" />
+  <Project Path="src\client/CodeBeam.UltimateAuth.Client.JsMinifier/CodeBeam.UltimateAuth.Client.JsMinifier.csproj" Id="ef5cfc86-bfd3-4f81-a973-ce7ef58e7525" />
 </Solution>
@@ -2,23 +2,34 @@
 
 	<PropertyGroup>
 		<TargetFrameworks>net8.0;net9.0;net10.0</TargetFrameworks>
-		<ImplicitUsings>enable</ImplicitUsings>
-		<Nullable>enable</Nullable>
-		<Version>0.1.0-preview.1</Version>
-		<InformationalVersion>0.1.0-preview.1</InformationalVersion>
-		<GenerateDocumentationFile>true</GenerateDocumentationFile>
+		<NoWarn>$(NoWarn);1591</NoWarn>
+
+		<PackageId>CodeBeam.UltimateAuth.EntityFrameworkCore.Bundle</PackageId>
+
+		<Description>
+			Provides a complete Entity Framework Core persistence setup for UltimateAuth.
+			This package includes reference domain implementations and Entity Framework Core-based persistence for all modules.
+			It is designed for production scenarios requiring durable storage.
+		</Description>
+
+		<PackageTags>authentication;authorization;identity;efcore;inmemory;bundle;auth-framework;security;jwt</PackageTags>
+		<PackageIcon>logo.png</PackageIcon>
+		<PackageReadmeFile>README.md</PackageReadmeFile>
 	</PropertyGroup>
 
 	<ItemGroup>
-	  <ProjectReference Include="..\..\src\authentication\CodeBeam.UltimateAuth.Authentication.EntityFrameworkCore\CodeBeam.UltimateAuth.Authentication.EntityFrameworkCore.csproj" />
-	  <ProjectReference Include="..\..\src\authorization\CodeBeam.UltimateAuth.Authorization.EntityFrameworkCore\CodeBeam.UltimateAuth.Authorization.EntityFrameworkCore.csproj" />
-	  <ProjectReference Include="..\..\src\authorization\CodeBeam.UltimateAuth.Authorization.Reference\CodeBeam.UltimateAuth.Authorization.Reference.csproj" />
-	  <ProjectReference Include="..\..\src\credentials\CodeBeam.UltimateAuth.Credentials.EntityFrameworkCore\CodeBeam.UltimateAuth.Credentials.EntityFrameworkCore.csproj" />
-	  <ProjectReference Include="..\..\src\credentials\CodeBeam.UltimateAuth.Credentials.Reference\CodeBeam.UltimateAuth.Credentials.Reference.csproj" />
-	  <ProjectReference Include="..\..\src\sessions\CodeBeam.UltimateAuth.Sessions.EntityFrameworkCore\CodeBeam.UltimateAuth.Sessions.EntityFrameworkCore.csproj" />
-	  <ProjectReference Include="..\..\src\tokens\CodeBeam.UltimateAuth.Tokens.EntityFrameworkCore\CodeBeam.UltimateAuth.Tokens.EntityFrameworkCore.csproj" />
-	  <ProjectReference Include="..\..\src\users\CodeBeam.UltimateAuth.Users.EntityFrameworkCore\CodeBeam.UltimateAuth.Users.EntityFrameworkCore.csproj" />
-	  <ProjectReference Include="..\..\src\users\CodeBeam.UltimateAuth.Users.Reference\CodeBeam.UltimateAuth.Users.Reference.csproj" />
+		<ProjectReference Include="..\CodeBeam.UltimateAuth.Reference.Bundle\CodeBeam.UltimateAuth.Reference.Bundle.csproj" />
+		<ProjectReference Include="..\..\src\authentication\CodeBeam.UltimateAuth.Authentication.EntityFrameworkCore\CodeBeam.UltimateAuth.Authentication.EntityFrameworkCore.csproj" />
+		<ProjectReference Include="..\..\src\authorization\CodeBeam.UltimateAuth.Authorization.EntityFrameworkCore\CodeBeam.UltimateAuth.Authorization.EntityFrameworkCore.csproj" />
+		<ProjectReference Include="..\..\src\credentials\CodeBeam.UltimateAuth.Credentials.EntityFrameworkCore\CodeBeam.UltimateAuth.Credentials.EntityFrameworkCore.csproj" />
+		<ProjectReference Include="..\..\src\sessions\CodeBeam.UltimateAuth.Sessions.EntityFrameworkCore\CodeBeam.UltimateAuth.Sessions.EntityFrameworkCore.csproj" />
+		<ProjectReference Include="..\..\src\tokens\CodeBeam.UltimateAuth.Tokens.EntityFrameworkCore\CodeBeam.UltimateAuth.Tokens.EntityFrameworkCore.csproj" />
+		<ProjectReference Include="..\..\src\users\CodeBeam.UltimateAuth.Users.EntityFrameworkCore\CodeBeam.UltimateAuth.Users.EntityFrameworkCore.csproj" />
+	</ItemGroup>
+
+	<ItemGroup>
+		<None Include="logo.png" Pack="true" PackagePath="\" />
+		<None Include="README.md" Pack="true" PackagePath="\" />
 	</ItemGroup>
 
 </Project>
@@ -0,0 +1,32 @@
+# UltimateAuth EntityFrameworkCore Bundle
+
+Provides a complete production-ready setup for UltimateAuth using Entity Framework Core.
+
+## 🚀 Quick Start
+
+```csharp
+builder.Services
+    .AddUltimateAuthServer()
+    .AddUltimateAuthEntityFrameworkCore(options =>
+    {
+        options.UseSqlServer("connection-string");
+    });
+```
+
+## 📦 Includes
+
+- Reference domain implementations
+
+EF Core persistence for:
+
+- Users
+- Credentials
+- Authorization
+- Sessions
+- Tokens
+- Authentication
+
+## ⚠️ Notes
+
+- You must configure a database provider
+- Migrations are not applied automatically