feat(creator): overhaul Creator flow, editor duplication, and staging setup (#83)

This pull request completely overhauls the Creator editor flow, resolves the editor duplication race condition, aligns layout/styling themes in light and dark mode, and adds Docker staging setups.

### Key Changes
1. **Creator Flow Polish**: Redesigned the editor canvas to prevent double scrolling by delegating overflow to the editor canvas layer, updated styles to a premium aesthetic.
2. **Race Condition Prevention**: Resolved Crepe editor duplication when loading or switching chapters by tracking state via shared window maps (`window.editorCache`, `window.editorStates`) and checking `_lastInitializedEditorId` synchronously in Blazor.
3. **Theme Synchronization**: Integrated explicit theme initialization (`ThemeService.InitializeAsync()`) and anchored CSS isolation selectors to correctly sync with Light (Soft Sepia) and Deep Dark theme preferences.
4. **Staging Automation**: Created staging docker configurations with `--nexus-only` flag to allow iterative development without resetting PG/Neo4j database containers.

---------

Co-authored-by: Marek Jasiński <jasins.marek@gmail.com>
Reviewed-on: #83
Co-authored-by: Antigravity <antigravity@google.com>
Co-committed-by: Antigravity <antigravity@google.com>

Directory.Packages.props

@@ -4,6 +4,8 @@
   </PropertyGroup>
   <ItemGroup>
     <PackageVersion Include="FluentResults" Version="4.0.0" />
+    <PackageVersion Include="HtmlSanitizer" Version="9.0.892" />
+    <PackageVersion Include="Markdig" Version="0.38.0" />
     <PackageVersion Include="Mapster" Version="10.0.7" />
     <PackageVersion Include="Mapster.DependencyInjection" Version="10.0.7" />
     <PackageVersion Include="MediatR" Version="12.1.1" />

Dockerfile

@@ -26,6 +26,7 @@ RUN dotnet publish "NexusReader.Web.csproj" -c Release -o /app/publish /p:UseApp
 
 # Stage 2: Runtime
 FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS final
+RUN apt-get update && apt-get install -y --no-install-recommends libgssapi-krb5-2 && rm -rf /var/lib/apt/lists/*
 WORKDIR /app
 COPY --from=build /app/publish .
 

GEMINI.md

@@ -46,4 +46,9 @@ version: 1.0
 
 > [!IMPORTANT]
 > **Git Workflow & Integration**
-> All tasks originating from the repository must be performed on a separate branch. To connect to the Git repository, use the `gitea` MCP server.
+> All tasks originating from the repository must be performed on a separate branch. Every new chat must be launched from the `develop` branch. To connect to the Git repository, use the `gitea` MCP server.
+
+> [!IMPORTANT]
+> **Docker Lifecycle Management**
+> Before starting work, only the web (nexus) container needs to be stopped to prevent port/application conflicts (e.g., `./run-stage.sh --stop --nexus-only` or `-s -n`); database containers (PostgreSQL, Neo4j, Qdrant) should continue to run to support local development/debugging. After finishing work, a new version of the web container from the current branch should be rebuilt and restarted via `./run-stage.sh --nexus-only` (or `-n`).
+

docker-compose.stage.yml

@@ -30,6 +30,7 @@ services:
       - ASPNETCORE_ENVIRONMENT=Staging
       - ConnectionStrings__PostgresConnection=Host=db;Database=${POSTGRES_DB:-nexus_stage_db};Username=${POSTGRES_USER:-nexus_user_stage};Password=${POSTGRES_PASSWORD:?POSTGRES_PASSWORD is required}
       - ConnectionStrings__QdrantConnection=http://qdrant:6334
+      - Qdrant__ApiKey=${QDRANT_API_KEY:-}
       - ConnectionStrings__Neo4jConnection=bolt://neo4j:7687
       - Neo4j__Username=${NEO4J_USERNAME:-neo4j}
       - Neo4j__Password=${NEO4J_PASSWORD:?NEO4J_PASSWORD is required}

run-stage.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+# -------------------------------------------------------------
+# Staging Deploy & Orchestration Helper for NexusReader
+# -------------------------------------------------------------
+set -e
+
+NEXUS_ONLY=false
+STOP=false
+for arg in "$@"; do
+    case $arg in
+        --nexus-only|-n)
+            NEXUS_ONLY=true
+            ;;
+        --stop|-s)
+            STOP=true
+            ;;
+    esac
+done
+
+ENV_FILE=".env.stage"
+TEMPLATE_FILE=".env.stage.template"
+COMPOSE_FILE="docker-compose.stage.yml"
+
+if [ "$STOP" = true ]; then
+    echo "🛑 Stopping staging environment..."
+    if [ ! -f "$ENV_FILE" ] && [ -f "$TEMPLATE_FILE" ]; then
+        cp "$TEMPLATE_FILE" "$ENV_FILE"
+    fi
+    if [ "$NEXUS_ONLY" = true ]; then
+        echo "🧹 Stopping and removing only the web (nexus) container..."
+        docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" stop web || true
+        docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" rm -f web || true
+    else
+        echo "🧹 Stopping all containers..."
+        docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" down --remove-orphans || true
+        docker compose down --remove-orphans 2>/dev/null || true
+    fi
+    echo "✅ Staging environment stopped."
+    exit 0
+fi
+
+echo "🏁 Starting staging environment orchestration..."
+if [ "$NEXUS_ONLY" = true ]; then
+    echo "ℹ️ Mode: --nexus-only (only the web/nexus application container will be modified)"
+fi
+
+# 1. Create .env.stage if it doesn't exist
+if [ ! -f "$ENV_FILE" ]; then
+    if [ -f "$TEMPLATE_FILE" ]; then
+        echo "📄 Creating $ENV_FILE from $TEMPLATE_FILE..."
+        cp "$TEMPLATE_FILE" "$ENV_FILE"
+    else
+        echo "❌ Error: Template file $TEMPLATE_FILE not found."
+        exit 1
+    fi
+fi
+
+# 2. Check and generate secure random passwords for placeholders
+if grep -q "CHANGE_ME_TO_STRONG_PASSWORD" "$ENV_FILE"; then
+    echo "🔐 Generating secure random passwords in $ENV_FILE..."
+    PG_PASS=$(openssl rand -hex 16)
+    NEO_PASS=$(openssl rand -hex 16)
+    # Use standard sed compatible with Linux
+    sed -i "s/POSTGRES_PASSWORD=CHANGE_ME_TO_STRONG_PASSWORD/POSTGRES_PASSWORD=$PG_PASS/g" "$ENV_FILE"
+    sed -i "s/NEO4J_PASSWORD=CHANGE_ME_TO_STRONG_PASSWORD/NEO4J_PASSWORD=$NEO_PASS/g" "$ENV_FILE"
+fi
+
+if grep -q "CHANGE_ME_TO_SECURE_ADMIN_PASSWORD" "$ENV_FILE"; then
+    echo "🔐 Generating secure admin seed password in $ENV_FILE..."
+    ADMIN_PASS=$(openssl rand -hex 16)
+    sed -i "s/NEXUS_ADMIN_PASSWORD=CHANGE_ME_TO_SECURE_ADMIN_PASSWORD/NEXUS_ADMIN_PASSWORD=$ADMIN_PASS/g" "$ENV_FILE"
+fi
+
+if grep -q "^QDRANT_API_KEY=$" "$ENV_FILE" || grep -q "^QDRANT_API_KEY=[[:space:]]*$" "$ENV_FILE"; then
+    echo "🔐 Generating secure random Qdrant API key in $ENV_FILE..."
+    QD_KEY=$(openssl rand -hex 16)
+    sed -i "s/^QDRANT_API_KEY=.*/QDRANT_API_KEY=$QD_KEY/g" "$ENV_FILE"
+fi
+
+# Load staging variables for local execution context (needed for ports/migrations)
+# Clean up carriage returns just in case
+POSTGRES_USER=$(grep "^POSTGRES_USER=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+POSTGRES_PASSWORD=$(grep "^POSTGRES_PASSWORD=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+POSTGRES_DB=$(grep "^POSTGRES_DB=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+POSTGRES_PORT=$(grep "^POSTGRES_PORT=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+WEB_PORT=$(grep "^WEB_PORT=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+QDRANT_HTTP_PORT=$(grep "^QDRANT_HTTP_PORT=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+NEO4J_HTTP_PORT=$(grep "^NEO4J_HTTP_PORT=" "$ENV_FILE" | cut -d'=' -f2- | tr -d '\r')
+
+# Fallbacks in case env parsing is empty
+POSTGRES_PORT=${POSTGRES_PORT:-5438}
+WEB_PORT=${WEB_PORT:-5080}
+
+# 3. Stop any conflicting Docker Compose environments
+if [ "$NEXUS_ONLY" = true ]; then
+    echo "🧹 Stopping and removing only the web (nexus) container..."
+    docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" stop web || true
+    docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" rm -f web || true
+else
+    echo "🧹 Stopping existing containers..."
+    docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" down --remove-orphans || true
+    docker compose down --remove-orphans 2>/dev/null || true
+fi
+
+# 4. Build and start containers
+if [ "$NEXUS_ONLY" = true ]; then
+    echo "🚀 Building and restarting only the web (nexus) container..."
+    docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" up -d --build web
+else
+    echo "🚀 Building and starting staging containers..."
+    docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" up -d --build
+fi
+
+# 5. Wait for Database to be healthy
+echo "⏳ Waiting for database (nexus-db-stage) to become healthy..."
+MAX_ATTEMPTS=30
+attempt=0
+until [ "$(docker inspect --format='{{json .State.Health.Status}}' nexus-db-stage 2>/dev/null)" == "\"healthy\"" ]; do
+    sleep 2
+    attempt=$((attempt + 1))
+    if [ $attempt -ge $MAX_ATTEMPTS ]; then
+        echo "❌ Timeout: Database container never became healthy."
+        docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" logs db
+        exit 1
+    fi
+done
+echo "✅ Database is healthy!"
+
+# 6. Apply Entity Framework migrations
+echo "🔄 Applying EF Core migrations to staging database on port $POSTGRES_PORT..."
+export ConnectionStrings__PostgresConnection="Host=127.0.0.1;Port=$POSTGRES_PORT;Database=$POSTGRES_DB;Username=$POSTGRES_USER;Password=$POSTGRES_PASSWORD"
+dotnet ef database update --project src/NexusReader.Data --startup-project src/NexusReader.Web --no-build
+
+# 7. Wait for Web Application to respond
+echo "⏳ Waiting for Web Application to start on http://localhost:$WEB_PORT/health..."
+MAX_WEB_ATTEMPTS=30
+web_attempt=0
+until curl -s -f "http://localhost:$WEB_PORT/health" >/dev/null; do
+    sleep 2
+    web_attempt=$((web_attempt + 1))
+    if [ $web_attempt -ge $MAX_WEB_ATTEMPTS ]; then
+        echo "⚠️ Warning: Web app is not responding yet on http://localhost:$WEB_PORT/health, but let's check logs..."
+        docker compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" logs web
+        break
+    fi
+done
+
+echo "🎉 Staging environment is ready!"
+echo "--------------------------------------------------------"
+echo "🌐 Web Application: http://localhost:$WEB_PORT"
+echo "🗄️ PostgreSQL Port:  $POSTGRES_PORT"
+echo "🔎 Neo4j Console:   http://localhost:$NEO4J_HTTP_PORT"
+echo "📊 Qdrant Service:  http://localhost:$QDRANT_HTTP_PORT"
+echo "--------------------------------------------------------"

src/NexusReader.Application/Abstractions/Persistence/IUserLibraryStore.cs

@@ -0,0 +1,23 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace NexusReader.Application.Abstractions.Persistence;
+
+/// <summary>
+/// Provides access to user library ownership details, decoupling the relational database
+/// structures from vector search and intelligence query operations.
+/// </summary>
+public interface IUserLibraryStore
+{
+    /// <summary>
+    /// Retrieves a list of book IDs that are owned by or uploaded for the specified user.
+    /// </summary>
+    Task<List<Guid>> GetOwnedBookIdsAsync(string userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Retrieves a dictionary mapping book IDs to their titles.
+    /// </summary>
+    Task<Dictionary<Guid, string>> GetBookTitlesAsync(List<Guid> bookIds, CancellationToken cancellationToken = default);
+}

src/NexusReader.Application/Abstractions/Persistence/IUserReadingStateStore.cs

@@ -0,0 +1,21 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace NexusReader.Application.Abstractions.Persistence;
+
+/// <summary>
+/// Decoupled database store to retrieve active user reading states and chapter content.
+/// </summary>
+public interface IUserReadingStateStore
+{
+    /// <summary>
+    /// Retrieves the user's active reading state: last read ebook ID, last opened chapter/page ID, and tenant ID.
+    /// </summary>
+    Task<(Guid? EbookId, string? ChapterId, string? TenantId)> GetActiveReadingStateAsync(string userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Retrieves the text content of a specific chapter/page by its ID.
+    /// </summary>
+    Task<string?> GetChapterContentAsync(string chapterId, CancellationToken cancellationToken = default);
+}

src/NexusReader.Application/Abstractions/Persistence/IVectorSearchStore.cs

@@ -0,0 +1,32 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace NexusReader.Application.Abstractions.Persistence;
+
+/// <summary>
+/// Represents a chunk of text retrieved from the semantic vector database.
+/// </summary>
+public record VectorChunk(string Content, string EbookId, double Score, string MetadataJson = "", string BookTitle = "", string ChapterTitle = "");
+
+/// <summary>
+/// Abstraction for performing semantic vector searches, isolating Qdrant gRPC dependencies from the Application layer.
+/// </summary>
+public interface IVectorSearchStore
+{
+    /// <summary>
+    /// Searches the entire global catalog (filtered by tenant) for the best semantic matches.
+    /// </summary>
+    Task<List<VectorChunk>> SearchGlobalAsync(string queryText, string tenantId, int limit, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Searches within a whitelist of owned book IDs for the best semantic matches.
+    /// </summary>
+    Task<List<VectorChunk>> SearchLocalAsync(string queryText, string tenantId, List<Guid> whitelistedBookIds, int limit, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Searches the entire global catalog (filtered by tenant) for the best semantic matches, excluding a specific book ID.
+    /// </summary>
+    Task<List<VectorChunk>> SearchGlobalExcludeAsync(string queryText, string tenantId, Guid excludeBookId, int limit, CancellationToken cancellationToken = default);
+}

src/NexusReader.Application/Abstractions/Services/IKnowledgeService.cs

@@ -1,5 +1,6 @@
 using FluentResults;
 using NexusReader.Application.DTOs.AI;
+using NexusReader.Application.Queries.Intelligence;
 
 namespace NexusReader.Application.Abstractions.Services;
 
@@ -13,6 +14,7 @@ public interface IKnowledgeService
     Task<Result<GroundednessResult>> VerifyGroundednessAsync(string answer, string context, string tenantId, CancellationToken cancellationToken = default);
     Task<Result<List<SemanticSearchResultDto>>> SearchLibrarySemanticallyAsync(string queryText, string tenantId, int limit, CancellationToken cancellationToken = default);
     Task<Result<GroundedResponseDto>> AskQuestionAsync(string question, string tenantId, Guid? ebookId = null, int limit = 5, CancellationToken cancellationToken = default);
+    Task<Result<IntelligenceResponse>> GetGlobalIntelligenceAsync(string queryText, string userId, string tenantId, CancellationToken cancellationToken = default);
     Task<Result> ClearCacheAsync(CancellationToken cancellationToken = default);
 }
 

src/NexusReader.Application/Abstractions/Services/ISanitizerService.cs

@@ -0,0 +1,13 @@
+namespace NexusReader.Application.Abstractions.Services;
+
+/// <summary>
+/// Service for sanitizing raw input text (e.g. Markdown/HTML) to protect against XSS injection.
+/// Intended to have a Singleton lifetime.
+/// </summary>
+public interface ISanitizerService
+{
+    /// <summary>
+    /// Sanitizes the input string and returns a clean, safe version.
+    /// </summary>
+    string Sanitize(string input);
+}

src/NexusReader.Application/Abstractions/Services/IStorageService.cs

@@ -0,0 +1,18 @@
+namespace NexusReader.Application.Abstractions.Services;
+
+/// <summary>
+/// General file storage service interface for handling media uploads.
+/// Intended to have a Scoped lifetime.
+/// </summary>
+public interface IStorageService
+{
+    /// <summary>
+    /// Uploads a file stream and returns its public URL/path.
+    /// </summary>
+    Task<string> UploadFileAsync(Stream fileStream, string fileName, string contentType);
+
+    /// <summary>
+    /// Uploads file bytes and returns its public URL/path.
+    /// </summary>
+    Task<string> UploadFileAsync(byte[] fileBytes, string fileName, string contentType);
+}

src/NexusReader.Application/Abstractions/Services/IUserPreferenceStore.cs

@@ -0,0 +1,10 @@
+using FluentResults;
+using NexusReader.Domain.Enums;
+
+namespace NexusReader.Application.Abstractions.Services;
+
+public interface IUserPreferenceStore
+{
+    Task<Result> SaveThemePreferenceAsync(ThemeMode mode);
+    Task<Result<ThemeMode>> GetThemePreferenceAsync();
+}

src/NexusReader.Application/Commands/User/UpdateThemeCommand.cs

@@ -0,0 +1,6 @@
+using NexusReader.Application.Abstractions.Messaging;
+using NexusReader.Domain.Enums;
+
+namespace NexusReader.Application.Commands.User;
+
+public record UpdateThemeCommand(string UserId, ThemeMode Mode) : ICommand;

src/NexusReader.Application/Commands/User/UpdateThemeCommandHandler.cs

@@ -0,0 +1,41 @@
+using FluentResults;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Messaging;
+using NexusReader.Data.Persistence;
+
+namespace NexusReader.Application.Commands.User;
+
+public class UpdateThemeCommandHandler : ICommandHandler<UpdateThemeCommand>
+{
+    private readonly IDbContextFactory<AppDbContext> _dbContextFactory;
+
+    public UpdateThemeCommandHandler(IDbContextFactory<AppDbContext> dbContextFactory)
+    {
+        _dbContextFactory = dbContextFactory;
+    }
+
+    public async Task<Result> Handle(UpdateThemeCommand request, CancellationToken cancellationToken)
+    {
+        try
+        {
+            using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+            var user = await dbContext.Users
+                .AsTracking()
+                .FirstOrDefaultAsync(u => u.Id == request.UserId, cancellationToken);
+                
+            if (user == null)
+            {
+                return Result.Fail("User not found.");
+            }
+
+            user.ThemePreference = request.Mode;
+            await dbContext.SaveChangesAsync(cancellationToken);
+            
+            return Result.Ok();
+        }
+        catch (Exception ex)
+        {
+            return Result.Fail(new Error("Failed to save theme preference in database.").CausedBy(ex));
+        }
+    }
+}

src/NexusReader.Application/Common/AppJsonContext.cs

@@ -1,5 +1,7 @@
 using System.Text.Json.Serialization;
+using System.Collections.Generic;
 using NexusReader.Application.Queries.Graph;
+using NexusReader.Application.Queries.Intelligence;
 
 namespace NexusReader.Application.Common;
 
@@ -9,6 +11,28 @@ namespace NexusReader.Application.Common;
 [JsonSerializable(typeof(GraphDataDto))]
 [JsonSerializable(typeof(List<GraphNodeDto>))]
 [JsonSerializable(typeof(List<GraphLinkDto>))]
+[JsonSerializable(typeof(GetGlobalIntelligenceRequest))]
+[JsonSerializable(typeof(IntelligenceResponse))]
+[JsonSerializable(typeof(NexusReader.Application.Queries.Recommendations.ContextualRecommendationResponse))]
+[JsonSerializable(typeof(NexusReader.Application.Queries.Recommendations.RecommendationDto))]
+[JsonSerializable(typeof(List<NexusReader.Application.Queries.Recommendations.RecommendationDto>))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.User.UpdateThemeRequest))]
+[JsonSerializable(typeof(NexusReader.Domain.Enums.ThemeMode))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Media.ValidateChapterRequest))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Media.ValidateChapterResponse))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Media.UploadResultDto))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Media.LocalBackupEnvelope))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Media.AutosaveChapterRequest))]
+[JsonSerializable(typeof(NexusReader.Application.Features.Books.Commands.PublishBookVersionCommand))]
+[JsonSerializable(typeof(NexusReader.Application.Features.Books.Commands.CreateBookCommand))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Creator.CreateBookRequestDto))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Creator.CreateBookResponseDto))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Creator.CreatorDashboardDataDto))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Creator.DashboardMetricsDto))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Creator.CreatorBookDto))]
+[JsonSerializable(typeof(NexusReader.Application.DTOs.Creator.CreatorBookRevisionDto))]
+[JsonSerializable(typeof(List<NexusReader.Application.DTOs.Creator.CreatorBookDto>))]
+[JsonSerializable(typeof(List<NexusReader.Application.DTOs.Creator.CreatorBookRevisionDto>))]
 public partial class AppJsonContext : JsonSerializerContext
 {
 }

src/NexusReader.Application/Common/RagMonetizationOptions.cs

@@ -0,0 +1,28 @@
+namespace NexusReader.Application.Common;
+
+/// <summary>
+/// Configurations for the monetization engine, controlling the thresholds at which
+/// search queries trigger paywalls.
+/// </summary>
+public class RagMonetizationOptions
+{
+    public const string SectionName = "RagMonetization";
+
+    /// <summary>
+    /// The baseline score threshold above which global content might trigger a paywall if there is no local content.
+    /// Default: 0.45.
+    /// </summary>
+    public double BaselineThreshold { get; set; } = 0.45;
+
+    /// <summary>
+    /// The similarity gap (Delta) required between global and local content to trigger an upgrade paywall.
+    /// Default: 0.15.
+    /// </summary>
+    public double DeltaThreshold { get; set; } = 0.15;
+
+    /// <summary>
+    /// The absolute score required from global content to trigger an upgrade paywall.
+    /// Default: 0.70.
+    /// </summary>
+    public double UpgradeThreshold { get; set; } = 0.70;
+}

src/NexusReader.Application/DTOs/Creator/CreatorDtos.cs

@@ -0,0 +1,61 @@
+using System;
+using System.Collections.Generic;
+
+namespace NexusReader.Application.DTOs.Creator;
+
+/// <summary>
+/// Telemetry metrics for the Creator Dashboard.
+/// </summary>
+public record DashboardMetricsDto(
+    int TotalReads,
+    double AvgReadTimeMinutes,
+    int ActiveReaders,
+    decimal GrossRevenue
+);
+
+/// <summary>
+/// Lightweight revision details for the Creator Dashboard.
+/// </summary>
+public record CreatorBookRevisionDto(
+    Guid Id,
+    string VersionString,
+    bool IsPublished,
+    DateTime CreatedAt,
+    DateTime? PublishedAt
+);
+
+/// <summary>
+/// Lightweight book publication details for the Creator Dashboard.
+/// </summary>
+public record CreatorBookDto(
+    Guid Id,
+    string Title,
+    int WordCount,
+    int AggregatedReads,
+    Guid? FirstChapterId,
+    CreatorBookRevisionDto? LivePublishedRevision,
+    CreatorBookRevisionDto? CurrentDraftRevision
+);
+
+/// <summary>
+/// Root data envelope for Creator Dashboard loading.
+/// </summary>
+public record CreatorDashboardDataDto(
+    DashboardMetricsDto Metrics,
+    List<CreatorBookDto> Books
+);
+
+/// <summary>
+/// Request DTO for creating a new Book.
+/// </summary>
+public record CreateBookRequestDto(
+    string Title,
+    string? Description
+);
+
+/// <summary>
+/// Response DTO for creating a new Book.
+/// </summary>
+public record CreateBookResponseDto(
+    Guid BookId
+);

src/NexusReader.Application/DTOs/Media/MediaDtos.cs

@@ -0,0 +1,33 @@
+namespace NexusReader.Application.DTOs.Media;
+
+// Note: These DTOs are registered in AppJsonContext.cs for JSON source generation.
+
+/// <summary>
+/// Request DTO for chapter validation/sanitization.
+/// </summary>
+public record ValidateChapterRequest(string Content);
+
+/// <summary>
+/// Response DTO containing sanitized chapter content.
+/// </summary>
+public record ValidateChapterResponse(string SanitizedContent);
+
+/// <summary>
+/// Response DTO containing the uploaded media file URL.
+/// </summary>
+public record UploadResultDto(string Url);
+
+/// <summary>
+/// Represents a structured JSON backup envelope stored in LocalStorage.
+/// </summary>
+public class LocalBackupEnvelope
+{
+    public Guid ChapterId { get; set; }
+    public DateTime Timestamp { get; set; }
+    public string MarkdownContent { get; set; } = string.Empty;
+}
+
+/// <summary>
+/// Request DTO for chapter autosaving.
+/// </summary>
+public record AutosaveChapterRequest(string MarkdownContent);

src/NexusReader.Application/DTOs/User/UpdateThemeRequest.cs

@@ -0,0 +1,5 @@
+using NexusReader.Domain.Enums;
+
+namespace NexusReader.Application.DTOs.User;
+
+public record UpdateThemeRequest(ThemeMode Mode);

src/NexusReader.Application/DTOs/User/UserProfileDto.cs

@@ -1,4 +1,5 @@
 using NexusReader.Application.Constants;
+using NexusReader.Domain.Enums;
 
 namespace NexusReader.Application.DTOs.User;
 
@@ -8,6 +9,7 @@ public record UserProfileDto
     public string UserId { get; init; } = string.Empty;
     public int AITokensUsed { get; init; }
     public Guid TenantId { get; init; }
+    public ThemeMode ThemePreference { get; init; } = ThemeMode.System;
     
     /// <summary>
     /// Relational data for the current subscription plan.

src/NexusReader.Application/Features/Books/Commands/CreateBookCommand.cs

@@ -0,0 +1,18 @@
+using System;
+using NexusReader.Application.Abstractions.Messaging;
+
+namespace NexusReader.Application.Features.Books.Commands;
+
+/// <summary>
+/// Command to create a new Book, initialize its first Working Draft revision, and seed it with a default Introduction chapter.
+/// </summary>
+/// <param name="Title">The title of the new book.</param>
+/// <param name="Description">An optional description of the book.</param>
+/// <param name="UserId">The ID of the creator user.</param>
+/// <param name="TenantId">The tenant ID for multi-tenant isolation.</param>
+public record CreateBookCommand(
+    string Title,
+    string? Description,
+    string UserId,
+    string TenantId
+) : ICommand<Guid>;

src/NexusReader.Application/Features/Books/Commands/CreateBookCommandHandler.cs

@@ -0,0 +1,103 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using FluentResults;
+using MediatR;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Messaging;
+using NexusReader.Data.Persistence;
+using NexusReader.Domain.Entities;
+
+namespace NexusReader.Application.Features.Books.Commands;
+
+/// <summary>
+/// MediatR handler for creating a Book, creating its initial Working Draft revision,
+/// and seeding a default first chapter ("Introduction") in an atomic database transaction.
+/// </summary>
+public class CreateBookCommandHandler : ICommandHandler<CreateBookCommand, Guid>
+{
+    private readonly IDbContextFactory<AppDbContext> _dbContextFactory;
+
+    public CreateBookCommandHandler(IDbContextFactory<AppDbContext> dbContextFactory)
+    {
+        _dbContextFactory = dbContextFactory;
+    }
+
+    public async Task<Result<Guid>> Handle(CreateBookCommand request, CancellationToken cancellationToken)
+    {
+        if (string.IsNullOrWhiteSpace(request.Title))
+        {
+            return Result.Fail<Guid>(new Error("Book title is required."));
+        }
+
+        using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+        using var transaction = await dbContext.Database.BeginTransactionAsync(cancellationToken);
+
+        try
+        {
+            // 1. Instantiate the Book record mapping Title, UserId, and TenantId
+            var book = new Book
+            {
+                Id = Guid.NewGuid(),
+                Title = request.Title.Trim(),
+                UserId = request.UserId,
+                TenantId = request.TenantId,
+                CurrentDraftRevisionId = null,
+                LivePublishedRevisionId = null
+            };
+
+            dbContext.Books.Add(book);
+
+            // 2. Instantiate the initial BookRevision designated as "Working Draft"
+            var draftRevision = new BookRevision
+            {
+                Id = Guid.NewGuid(),
+                BookId = book.Id,
+                VersionString = "Working Draft",
+                IsPublished = false,
+                CreatedAt = DateTime.UtcNow
+            };
+
+            dbContext.BookRevisions.Add(draftRevision);
+
+            // 3. Automatically instantiate and append a default first Chapter to this new revision
+            var introChapter = new Chapter
+            {
+                Id = Guid.NewGuid(),
+                BookRevisionId = draftRevision.Id,
+                Title = "Introduction",
+                MarkdownContent = "# Introduction\nStart writing here...",
+                SortOrder = 1
+            };
+
+            dbContext.Chapters.Add(introChapter);
+
+            // Save first to generate DB references
+            await dbContext.SaveChangesAsync(cancellationToken);
+
+            // 4. Inject the newly instantiated draft revision ID back into Book.CurrentDraftRevisionId
+            book.CurrentDraftRevisionId = draftRevision.Id;
+
+            // Save the updated Book link
+            await dbContext.SaveChangesAsync(cancellationToken);
+
+            // Commit transaction
+            await transaction.CommitAsync(cancellationToken);
+
+            return Result.Ok(book.Id);
+        }
+        catch (Exception ex)
+        {
+            try
+            {
+                await transaction.RollbackAsync(cancellationToken);
+            }
+            catch (Exception rollbackEx)
+            {
+                Console.WriteLine($"[CreateBook] Transaction rollback failed: {rollbackEx.Message}");
+            }
+
+            return Result.Fail<Guid>(new Error($"Failed to create book: {ex.Message}").CausedBy(ex));
+        }
+    }
+}

src/NexusReader.Application/Features/Books/Commands/PublishBookVersionCommand.cs

@@ -0,0 +1,12 @@
+using NexusReader.Application.Abstractions.Messaging;
+
+namespace NexusReader.Application.Features.Books.Commands;
+
+/// <summary>
+/// Command to publish a new frozen version of a Book, and create a new Working Draft.
+/// </summary>
+/// <param name="BookId">The unique identifier of the Book to publish.</param>
+/// <param name="CustomVersionString">The custom version string to apply (e.g. "v1.0").</param>
+/// <param name="UserId">The ID of the user requesting the action.</param>
+/// <param name="TenantId">The tenant ID for multi-tenant isolation.</param>
+public record PublishBookVersionCommand(Guid BookId, string CustomVersionString, string UserId, string TenantId) : ICommand;

src/NexusReader.Application/Features/Books/Commands/PublishBookVersionCommandHandler.cs

@@ -0,0 +1,112 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using FluentResults;
+using MediatR;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Messaging;
+using NexusReader.Data.Persistence;
+using NexusReader.Domain.Entities;
+using NexusReader.Domain.Exceptions;
+
+namespace NexusReader.Application.Features.Books.Commands;
+
+/// <summary>
+/// MediatR handler for publishing a Book version and setting up the next Working Draft.
+/// </summary>
+public class PublishBookVersionCommandHandler : ICommandHandler<PublishBookVersionCommand>
+{
+    private readonly IDbContextFactory<AppDbContext> _dbContextFactory;
+
+    public PublishBookVersionCommandHandler(IDbContextFactory<AppDbContext> dbContextFactory)
+    {
+        _dbContextFactory = dbContextFactory;
+    }
+
+    public async Task<Result> Handle(PublishBookVersionCommand request, CancellationToken cancellationToken)
+    {
+        using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+
+        // Fetch the Book including its CurrentDraftRevision and all associated Chapters,
+        // enforcing that the book belongs to the requested TenantId and UserId to prevent cross-tenant data leaks.
+        var book = await dbContext.Books
+            .Include(b => b.CurrentDraftRevision)
+                .ThenInclude(r => r!.Chapters)
+            .FirstOrDefaultAsync(
+                b => b.Id == request.BookId && b.UserId == request.UserId && b.TenantId == request.TenantId, 
+                cancellationToken);
+
+        if (book == null)
+        {
+            return Result.Fail(new Error($"Book with ID '{request.BookId}' was not found."));
+        }
+
+        var oldDraftRevision = book.CurrentDraftRevision;
+        if (oldDraftRevision == null)
+        {
+            return Result.Fail(new Error("The book does not have an active draft revision to publish."));
+        }
+
+        // Start ACID transaction
+        using var transaction = await dbContext.Database.BeginTransactionAsync(cancellationToken);
+        try
+        {
+            // 1. Update the current draft revision: Set IsPublished = true, PublishedAt = now, VersionString = custom
+            oldDraftRevision.IsPublished = true;
+            oldDraftRevision.PublishedAt = DateTime.UtcNow;
+            oldDraftRevision.VersionString = request.CustomVersionString;
+
+            // 2. Point the Book.LivePublishedRevisionId to this newly frozen revision ID
+            book.LivePublishedRevisionId = oldDraftRevision.Id;
+
+            // 3. Execute Deep Snapshot: Instantiate a brand new BookRevision representing the next "Working Draft"
+            var newDraftRevision = new BookRevision
+            {
+                Id = Guid.NewGuid(),
+                BookId = book.Id,
+                VersionString = "Working Draft",
+                IsPublished = false,
+                CreatedAt = DateTime.UtcNow
+            };
+
+            dbContext.BookRevisions.Add(newDraftRevision);
+
+            // Replicate/clone chapters into new Chapter objects associated with the new draft revision.
+            // Reset identities by explicitly instantiating completely new Chapter objects with Guid.NewGuid().
+            foreach (var oldChapter in oldDraftRevision.Chapters)
+            {
+                var newChapter = new Chapter
+                {
+                    Id = Guid.NewGuid(),
+                    BookRevisionId = newDraftRevision.Id,
+                    Title = oldChapter.Title,
+                    MarkdownContent = oldChapter.MarkdownContent,
+                    SortOrder = oldChapter.SortOrder
+                };
+                dbContext.Chapters.Add(newChapter);
+            }
+
+            // 4. Assign the new draft revision ID to Book.CurrentDraftRevisionId
+            book.CurrentDraftRevisionId = newDraftRevision.Id;
+
+            // Save changes and commit transaction
+            await dbContext.SaveChangesAsync(cancellationToken);
+            await transaction.CommitAsync(cancellationToken);
+
+            return Result.Ok();
+        }
+        catch (Exception ex)
+        {
+            try
+            {
+                await transaction.RollbackAsync(cancellationToken);
+            }
+            catch (Exception rollbackEx)
+            {
+                Console.WriteLine($"[PublishBookVersion] Transaction rollback failed: {rollbackEx.Message}");
+            }
+
+            return Result.Fail(new Error($"Failed to publish book version: {ex.Message}").CausedBy(ex));
+        }
+    }
+}

src/NexusReader.Application/Queries/Creator/GetBookRevisionsQuery.cs

@@ -0,0 +1,63 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Messaging;
+using NexusReader.Application.DTOs.Creator;
+using NexusReader.Data.Persistence;
+using NexusReader.Domain.Exceptions;
+
+namespace NexusReader.Application.Queries.Creator;
+
+/// <summary>
+/// Query to load all revisions for a specific Book, checking multi-tenant ownership boundaries.
+/// </summary>
+/// <param name="BookId">The unique identifier of the target Book.</param>
+/// <param name="UserId">The ID of the creator requesting revision data.</param>
+/// <param name="TenantId">The tenant ID for multi-tenant isolation.</param>
+public record GetBookRevisionsQuery(Guid BookId, string UserId, string TenantId) : IQuery<List<CreatorBookRevisionDto>>;
+
+/// <summary>
+/// Handler that lists past revisions of a Book, verifying ownership to prevent cross-tenant leakages.
+/// </summary>
+public class GetBookRevisionsQueryHandler : IQueryHandler<GetBookRevisionsQuery, List<CreatorBookRevisionDto>>
+{
+    private readonly IDbContextFactory<AppDbContext> _dbContextFactory;
+
+    public GetBookRevisionsQueryHandler(IDbContextFactory<AppDbContext> dbContextFactory)
+    {
+        _dbContextFactory = dbContextFactory;
+    }
+
+    public async Task<FluentResults.Result<List<CreatorBookRevisionDto>>> Handle(GetBookRevisionsQuery request, CancellationToken cancellationToken)
+    {
+        using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+
+        // Verify the book exists and belongs to this tenant/user to prevent cross-tenant data leaks
+        var bookExists = await dbContext.Books
+            .AnyAsync(b => b.Id == request.BookId && b.UserId == request.UserId && b.TenantId == request.TenantId, cancellationToken);
+
+        if (!bookExists)
+        {
+            return FluentResults.Result.Fail<List<CreatorBookRevisionDto>>(new FluentResults.Error($"Book with ID '{request.BookId}' was not found."));
+        }
+
+        // Fetch all revisions sorted chronologically
+        var revisions = await dbContext.BookRevisions
+            .AsNoTracking()
+            .Where(r => r.BookId == request.BookId)
+            .OrderByDescending(r => r.CreatedAt)
+            .Select(r => new CreatorBookRevisionDto(
+                r.Id,
+                r.VersionString,
+                r.IsPublished,
+                r.CreatedAt,
+                r.PublishedAt
+            ))
+            .ToListAsync(cancellationToken);
+
+        return FluentResults.Result.Ok(revisions);
+    }
+}

src/NexusReader.Application/Queries/Creator/GetCreatorDashboardDataQuery.cs

@@ -0,0 +1,109 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Messaging;
+using NexusReader.Application.DTOs.Creator;
+using NexusReader.Data.Persistence;
+
+namespace NexusReader.Application.Queries.Creator;
+
+/// <summary>
+/// Query to load aggregated Creator Dashboard telemetry metrics and book listings.
+/// </summary>
+/// <param name="UserId">The ID of the creator requesting dashboard data.</param>
+/// <param name="TenantId">The tenant ID for multi-tenant isolation.</param>
+public record GetCreatorDashboardDataQuery(string UserId, string TenantId) : IQuery<CreatorDashboardDataDto>;
+
+/// <summary>
+/// Handler that executes projection-only LINQ queries to aggregate metrics and compute word counts
+/// without loading raw chapter content into memory or tracking them in the EF Core Change Tracker.
+/// </summary>
+public class GetCreatorDashboardDataQueryHandler : IQueryHandler<GetCreatorDashboardDataQuery, CreatorDashboardDataDto>
+{
+    private readonly IDbContextFactory<AppDbContext> _dbContextFactory;
+
+    public GetCreatorDashboardDataQueryHandler(IDbContextFactory<AppDbContext> dbContextFactory)
+    {
+        _dbContextFactory = dbContextFactory;
+    }
+
+    public async Task<FluentResults.Result<CreatorDashboardDataDto>> Handle(GetCreatorDashboardDataQuery request, CancellationToken cancellationToken)
+    {
+        using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+
+        // Execute projection-only LINQ query. The heavy MarkdownContent is projected only as integer lengths.
+        var projectedBooks = await dbContext.Books
+            .AsNoTracking()
+            .Where(b => b.UserId == request.UserId && b.TenantId == request.TenantId)
+            .Select(b => new
+            {
+                b.Id,
+                b.Title,
+                LivePublishedRevision = b.LivePublishedRevision == null ? null : new CreatorBookRevisionDto(
+                    b.LivePublishedRevision.Id,
+                    b.LivePublishedRevision.VersionString,
+                    b.LivePublishedRevision.IsPublished,
+                    b.LivePublishedRevision.CreatedAt,
+                    b.LivePublishedRevision.PublishedAt
+                ),
+                CurrentDraftRevision = b.CurrentDraftRevision == null ? null : new CreatorBookRevisionDto(
+                    b.CurrentDraftRevision.Id,
+                    b.CurrentDraftRevision.VersionString,
+                    b.CurrentDraftRevision.IsPublished,
+                    b.CurrentDraftRevision.CreatedAt,
+                    b.CurrentDraftRevision.PublishedAt
+                ),
+                FirstChapterId = b.CurrentDraftRevision == null 
+                    ? (Guid?)null 
+                    : b.CurrentDraftRevision.Chapters.OrderBy(c => c.SortOrder).Select(c => c.Id).FirstOrDefault(),
+                ChapterContentLengths = b.CurrentDraftRevision == null 
+                    ? new List<int>() 
+                    : b.CurrentDraftRevision.Chapters.Select(c => c.MarkdownContent.Length).ToList()
+            })
+            .ToListAsync(cancellationToken);
+
+        var booksList = new List<CreatorBookDto>();
+        int totalReads = 0;
+        int totalWords = 0;
+
+        foreach (var pBook in projectedBooks)
+        {
+            // Estimate word count (approx. 6 characters per word as a database-friendly standard length)
+            int wordCount = pBook.ChapterContentLengths.Sum(len => len / 6);
+            totalWords += wordCount;
+
+            // Generate deterministic simulated telemetry metrics scoped to this Book
+            int bookReads = Math.Abs(pBook.Id.GetHashCode() % 1000) + 120;
+            totalReads += bookReads;
+
+            var bookDto = new CreatorBookDto(
+                pBook.Id,
+                pBook.Title,
+                wordCount,
+                bookReads,
+                pBook.FirstChapterId,
+                pBook.LivePublishedRevision,
+                pBook.CurrentDraftRevision
+            );
+
+            booksList.Add(bookDto);
+        }
+
+        // Calculate aggregate dashboard metrics based on projected stats
+        int activeReaders = projectedBooks.Count == 0 ? 0 : Math.Abs(request.UserId.GetHashCode() % 15) + 3;
+        decimal grossRevenue = totalReads * 1.49m;
+        double avgReadTime = projectedBooks.Count == 0 ? 0 : Math.Round(totalWords / 250.0, 1); // standard 250 words per minute reading speed
+
+        var metrics = new DashboardMetricsDto(
+            totalReads,
+            avgReadTime,
+            activeReaders,
+            grossRevenue
+        );
+
+        return FluentResults.Result.Ok(new CreatorDashboardDataDto(metrics, booksList));
+    }
+}

src/NexusReader.Application/Queries/Intelligence/GetGlobalIntelligenceQuery.cs

@@ -0,0 +1,222 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using FluentResults;
+using MediatR;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Options;
+using NexusReader.Application.Abstractions.Persistence;
+using NexusReader.Application.Common;
+using NexusReader.Application.DTOs.AI;
+
+namespace NexusReader.Application.Queries.Intelligence;
+
+/// <summary>
+/// MediatR query to request global intelligence hybrid Q&A context.
+/// </summary>
+public record GetGlobalIntelligenceQuery(string QueryText, string UserId, string TenantId = "global") 
+    : IRequest<Result<IntelligenceResponse>>;
+
+/// <summary>
+/// Request schema for global hybrid search queries.
+/// </summary>
+public record GetGlobalIntelligenceRequest(string QueryText);
+
+/// <summary>
+/// Response schema returning generated AI text, paywall status, and locked publishing details.
+/// </summary>
+public record IntelligenceResponse(
+    string ResponseText, 
+    bool HasPaywall, 
+    Guid? LockedBookId, 
+    string? LockedBookTitle,
+    List<CitationDto>? Citations = null);
+
+/// <summary>
+/// Handles <see cref="GetGlobalIntelligenceQuery"/> by performing local/global dual searches,
+/// executing monetization rules, and invoking Chat AI with appropriate gating logic.
+/// </summary>
+public class GetGlobalIntelligenceQueryHandler : IRequestHandler<GetGlobalIntelligenceQuery, Result<IntelligenceResponse>>
+{
+    private readonly IUserLibraryStore _userLibraryStore;
+    private readonly IVectorSearchStore _vectorSearchStore;
+    private readonly IChatClient _chatClient;
+    private readonly RagMonetizationOptions _options;
+
+    public GetGlobalIntelligenceQueryHandler(
+        IUserLibraryStore userLibraryStore,
+        IVectorSearchStore vectorSearchStore,
+        IChatClient chatClient,
+        IOptions<RagMonetizationOptions> options)
+    {
+        _userLibraryStore = userLibraryStore;
+        _vectorSearchStore = vectorSearchStore;
+        _chatClient = chatClient;
+        _options = options.Value;
+    }
+
+    public async Task<Result<IntelligenceResponse>> Handle(GetGlobalIntelligenceQuery request, CancellationToken cancellationToken)
+    {
+        if (string.IsNullOrWhiteSpace(request.QueryText))
+        {
+            return Result.Fail("Question cannot be empty.");
+        }
+
+        try
+        {
+            // Step A: Fetch whitelisted BookIds
+            var whitelistedBookIds = await _userLibraryStore.GetOwnedBookIdsAsync(request.UserId, cancellationToken);
+
+            // Step B & C: Vector Dual-Search with Resilient Trapping
+            List<VectorChunk> globalChunks = new();
+            List<VectorChunk> localChunks = new();
+            double globalScore = 0.0;
+            double localScore = 0.0;
+
+            try
+            {
+                // Execute searches
+                globalChunks = await _vectorSearchStore.SearchGlobalAsync(request.QueryText, request.TenantId, limit: 3, cancellationToken);
+                globalScore = globalChunks.Any() ? Math.Max(0.0, globalChunks.Max(c => c.Score)) : 0.0;
+
+                if (whitelistedBookIds.Any())
+                {
+                    localChunks = await _vectorSearchStore.SearchLocalAsync(request.QueryText, request.TenantId, whitelistedBookIds, limit: 3, cancellationToken);
+                    localScore = localChunks.Any() ? Math.Max(0.0, localChunks.Max(c => c.Score)) : 0.0;
+                }
+            }
+            catch (Exception ex)
+            {
+                // Resilient Error Trapping: transform connectivity anomalies into domain-friendly errors
+                return Result.Fail(new Error("Serwer wyszukiwania semantycznego jest tymczasowo niedostępny. Spróbuj ponownie później.").CausedBy(ex));
+            }
+
+            // Step D: Evaluate Monetization Thresholds
+            bool triggerPaywall = false;
+
+            if (localScore == 0.0 && globalScore > _options.BaselineThreshold)
+            {
+                triggerPaywall = true;
+            }
+            else if ((globalScore - localScore) > _options.DeltaThreshold && globalScore > _options.UpgradeThreshold)
+            {
+                triggerPaywall = true;
+            }
+
+            var chosenChunks = triggerPaywall ? globalChunks : localChunks;
+
+            // Fetch book titles for citations/paywall metadata
+            var chunkEbookIds = chosenChunks
+                .Where(c => Guid.TryParse(c.EbookId, out _))
+                .Select(c => Guid.Parse(c.EbookId))
+                .Distinct()
+                .ToList();
+
+            var bookTitles = await _userLibraryStore.GetBookTitlesAsync(chunkEbookIds, cancellationToken);
+
+            // Step E: Identify locked book if paywall triggered
+            Guid? lockedBookId = null;
+            string? lockedBookTitle = null;
+
+            if (triggerPaywall && globalChunks.Any())
+            {
+                var topGlobalChunk = globalChunks.OrderByDescending(c => c.Score).First();
+                if (Guid.TryParse(topGlobalChunk.EbookId, out var parsedLockedId))
+                {
+                    lockedBookId = parsedLockedId;
+                    bookTitles.TryGetValue(parsedLockedId, out lockedBookTitle);
+                    if (string.IsNullOrEmpty(lockedBookTitle))
+                    {
+                        lockedBookTitle = "Nieznana książka";
+                    }
+                }
+            }
+
+            // Format context blocks for LLM
+            var relatedContexts = new List<string>();
+            foreach (var chunk in chosenChunks)
+            {
+                var sourceId = chunk.EbookId;
+                relatedContexts.Add($"[Source ID: {sourceId}] {chunk.Content}");
+            }
+            var contextBlocksText = string.Join("\n\n", relatedContexts);
+
+            // Build LLM prompts
+            var systemPrompt = "You are an advanced, extremely precise Fact-Checking AI assistant. Your task is to answer the user's question using ONLY the provided context blocks.\n" +
+                               "Rely EXCLUSIVELY on the provided context. Do NOT use any pre-existing external knowledge, facts, or assumptions.\n" +
+                               "If the context does not contain the answer, say: 'I cannot answer this based on the provided book context.'";
+
+            if (triggerPaywall)
+            {
+                var localScorePercent = (int)Math.Round(localScore * 100);
+                var globalScorePercent = (int)Math.Round(globalScore * 100);
+                var resolvedTitle = lockedBookTitle ?? "Nieznana książka";
+
+                systemPrompt += $"\n\nCRITICAL: You are operating in TEASER mode. The user does not own the source document named '{resolvedTitle}'. You are strictly allowed to provide only a 1-sentence foundational definition or answer based on the context to prove the system knows the solution. DO NOT output code blocks, implementation details, or bullet points. You must immediately terminate your response with this exact token format: [PAYWALL_TRIGGER:{lockedBookId}:{resolvedTitle}:{localScorePercent}:{globalScorePercent}].";
+            }
+
+            var messages = new List<Microsoft.Extensions.AI.ChatMessage>
+            {
+                new(Microsoft.Extensions.AI.ChatRole.System, systemPrompt),
+                new(Microsoft.Extensions.AI.ChatRole.User, $"Context:\n{contextBlocksText}\n\nQuestion: {request.QueryText}")
+            };
+
+            var chatOptions = new ChatOptions
+            {
+                Temperature = 0.0f,
+                MaxOutputTokens = 1000
+            };
+
+            var chatResponse = await _chatClient.GetResponseAsync(messages, chatOptions, cancellationToken);
+            var responseText = chatResponse.Text?.Trim() ?? string.Empty;
+
+            // Ensure the paywall token is appended if LLM misses it in teaser mode
+            if (triggerPaywall)
+            {
+                var localScorePercent = (int)Math.Round(localScore * 100);
+                var globalScorePercent = (int)Math.Round(globalScore * 100);
+                var resolvedTitle = lockedBookTitle ?? "Nieznana książka";
+                var paywallToken = $"[PAYWALL_TRIGGER:{lockedBookId}:{resolvedTitle}:{localScorePercent}:{globalScorePercent}]";
+
+                if (!responseText.Contains("[PAYWALL_TRIGGER:"))
+                {
+                    responseText = responseText.Trim() + " " + paywallToken;
+                }
+            }
+
+            // Build citations list
+            var citations = new List<CitationDto>();
+            foreach (var chunk in chosenChunks)
+            {
+                var sourceBookName = "Unknown";
+                if (Guid.TryParse(chunk.EbookId, out var parsedId) && bookTitles.TryGetValue(parsedId, out var title))
+                {
+                    sourceBookName = title;
+                }
+
+                citations.Add(new CitationDto
+                {
+                    CitationId = chunk.EbookId,
+                    Snippet = chunk.Content,
+                    SourceBook = sourceBookName,
+                    Author = null,
+                    PageNumber = null
+                });
+            }
+
+            return Result.Ok(new IntelligenceResponse(
+                ResponseText: responseText,
+                HasPaywall: triggerPaywall,
+                LockedBookId: lockedBookId,
+                LockedBookTitle: lockedBookTitle,
+                Citations: citations
+            ));
+        }
+        catch (Exception ex)
+        {
+            return Result.Fail(new Error("Nieoczekiwany błąd serwera podczas przetwarzania zapytania.").CausedBy(ex));
+        }
+    }
+}

src/NexusReader.Application/Queries/Recommendations/GetContextualRecommendationsQuery.cs

@@ -0,0 +1,28 @@
+using System;
+using System.Collections.Generic;
+using FluentResults;
+using MediatR;
+
+namespace NexusReader.Application.Queries.Recommendations;
+
+/// <summary>
+/// MediatR query to fetch contextual recommendations based on the user's active reading state.
+/// </summary>
+public record GetContextualRecommendationsQuery(string UserId) 
+    : IRequest<Result<ContextualRecommendationResponse>>;
+
+/// <summary>
+/// Response DTO containing contextual recommendations.
+/// </summary>
+public record ContextualRecommendationResponse(List<RecommendationDto> Recommendations);
+
+/// <summary>
+/// Individual contextual recommendation details.
+/// </summary>
+public record RecommendationDto(
+    string BookTitle,
+    string ChapterTitle,
+    int MatchPercentage,
+    bool IsPremiumUpsell,
+    Guid TargetBookId
+);

src/NexusReader.Application/Queries/User/GetUserProfileQueryHandler.cs

@@ -27,6 +27,7 @@ public class GetUserProfileQueryHandler : IRequestHandler<GetUserProfileQuery, R
                 UserId = u.Id,
                 AITokensUsed = u.AITokensUsed,
                 TenantIdString = u.TenantId,
+                ThemePreference = u.ThemePreference,
                 Plan = u.SubscriptionPlan != null ? new SubscriptionPlanDto
                 {
                     Id = u.SubscriptionPlan.Id,
@@ -106,6 +107,7 @@ public class GetUserProfileQueryHandler : IRequestHandler<GetUserProfileQuery, R
             AverageQuizScore = averageQuizScore,
             DisplayName = userRaw.DisplayName,
             BooksReadCount = userRaw.BooksReadCount,
+            ThemePreference = userRaw.ThemePreference,
             ConceptsMappedCount = conceptsMappedCount,
             LastReadBook = userRaw.LastReadBook,
             RecentQuizzes = userRaw.QuizResults.OrderByDescending(q => q.CompletedDate).Take(5).Select(q => new QuizResultDto

src/NexusReader.Data/Migrations/20260607104453_AddThemePreference.Designer.cs

@@ -0,0 +1,711 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using NexusReader.Data.Persistence;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace NexusReader.Data.Migrations
+{
+    [DbContext(typeof(AppDbContext))]
+    [Migration("20260607104453_AddThemePreference")]
+    partial class AddThemePreference
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRole", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("NormalizedName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedName")
+                        .IsUnique()
+                        .HasDatabaseName("RoleNameIndex");
+
+                    b.ToTable("AspNetRoles", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("text");
+
+                    b.Property<string>("RoleId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetRoleClaims", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("text");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserClaims", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ProviderKey")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ProviderDisplayName")
+                        .HasColumnType("text");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("LoginProvider", "ProviderKey");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserLogins", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("RoleId")
+                        .HasColumnType("text");
+
+                    b.HasKey("UserId", "RoleId");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetUserRoles", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Value")
+                        .HasColumnType("text");
+
+                    b.HasKey("UserId", "LoginProvider", "Name");
+
+                    b.ToTable("AspNetUserTokens", (string)null);
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Author", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Authors");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Ebook", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("AddedDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<int>("AuthorId")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("CoverUrl")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Description")
+                        .HasColumnType("text");
+
+                    b.Property<string>("FilePath")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<bool>("IsReadyForReading")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("LastChapter")
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<int>("LastChapterIndex")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime?>("LastReadDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<double>("Progress")
+                        .HasColumnType("double precision");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("AuthorId");
+
+                    b.HasIndex("TenantId");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("Ebooks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Content")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<Guid?>("EbookId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("MetadataJson")
+                        .HasColumnType("text");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<int>("Type")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Version")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("EbookId");
+
+                    b.HasIndex("TenantId");
+
+                    b.ToTable("KnowledgeUnits");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnitLink", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("RelationType")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.Property<string>("SourceUnitId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("TargetUnitId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("SourceUnitId");
+
+                    b.HasIndex("TargetUnitId");
+
+                    b.ToTable("KnowledgeUnitLinks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.NexusUser", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("text");
+
+                    b.Property<int>("AITokenLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("AITokensUsed")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("AccessFailedCount")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("text");
+
+                    b.Property<string>("DisplayName")
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)");
+
+                    b.Property<string>("Email")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<bool>("EmailConfirmed")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateTime?>("LastAiActionDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTime?>("LastReadAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("LastReadPageId")
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<bool>("LockoutEnabled")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateTimeOffset?>("LockoutEnd")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("NormalizedEmail")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("NormalizedUserName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("PasswordHash")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasColumnType("text");
+
+                    b.Property<bool>("PhoneNumberConfirmed")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("SecurityStamp")
+                        .HasColumnType("text");
+
+                    b.Property<int>("SubscriptionPlanId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer")
+                        .HasDefaultValue(1);
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<int>("ThemePreference")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer")
+                        .HasDefaultValue(0);
+
+                    b.Property<bool>("TwoFactorEnabled")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("UserName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedEmail")
+                        .HasDatabaseName("EmailIndex");
+
+                    b.HasIndex("NormalizedUserName")
+                        .IsUnique()
+                        .HasDatabaseName("UserNameIndex");
+
+                    b.HasIndex("SubscriptionPlanId");
+
+                    b.HasIndex("TenantId");
+
+                    b.ToTable("AspNetUsers", (string)null);
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.QuizResult", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("CompletedDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<int>("Score")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Topic")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<int>("TotalQuestions")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("TenantId");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("QuizResults");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.SemanticKnowledgeCache", b =>
+                {
+                    b.Property<string>("ContentHash")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("JsonData")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("ModelId")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.Property<string>("OriginalText")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("PromptVersion")
+                        .IsRequired()
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.HasKey("ContentHash");
+
+                    b.HasIndex("ContentHash")
+                        .IsUnique();
+
+                    b.HasIndex("TenantId");
+
+                    b.ToTable("SemanticKnowledgeCache");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.SubscriptionPlan", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<int>("AITokenLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<bool>("IsUnlimitedTokens")
+                        .HasColumnType("boolean");
+
+                    b.Property<decimal>("MonthlyPrice")
+                        .HasColumnType("numeric");
+
+                    b.Property<string>("PlanName")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.Property<string>("StripeProductId")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("PlanName")
+                        .IsUnique();
+
+                    b.ToTable("SubscriptionPlans");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            AITokenLimit = 5000,
+                            IsUnlimitedTokens = false,
+                            MonthlyPrice = 0m,
+                            PlanName = "Free",
+                            StripeProductId = "prod_Free789"
+                        },
+                        new
+                        {
+                            Id = 2,
+                            AITokenLimit = 10000,
+                            IsUnlimitedTokens = false,
+                            MonthlyPrice = 9.99m,
+                            PlanName = "Basic",
+                            StripeProductId = "prod_basic_placeholder"
+                        },
+                        new
+                        {
+                            Id = 3,
+                            AITokenLimit = 50000,
+                            IsUnlimitedTokens = false,
+                            MonthlyPrice = 19.99m,
+                            PlanName = "Pro",
+                            StripeProductId = "prod_pro_placeholder"
+                        },
+                        new
+                        {
+                            Id = 4,
+                            AITokenLimit = 1000000000,
+                            IsUnlimitedTokens = true,
+                            MonthlyPrice = 99.99m,
+                            PlanName = "Enterprise",
+                            StripeProductId = "prod_enterprise_placeholder"
+                        });
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Ebook", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.Author", "Author")
+                        .WithMany("Ebooks")
+                        .HasForeignKey("AuthorId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", "User")
+                        .WithMany("Ebooks")
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Author");
+
+                    b.Navigation("User");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.Ebook", "Ebook")
+                        .WithMany()
+                        .HasForeignKey("EbookId")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.Navigation("Ebook");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnitLink", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.KnowledgeUnit", "SourceUnit")
+                        .WithMany("OutgoingLinks")
+                        .HasForeignKey("SourceUnitId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("NexusReader.Domain.Entities.KnowledgeUnit", "TargetUnit")
+                        .WithMany("IncomingLinks")
+                        .HasForeignKey("TargetUnitId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("SourceUnit");
+
+                    b.Navigation("TargetUnit");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.NexusUser", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.SubscriptionPlan", "SubscriptionPlan")
+                        .WithMany()
+                        .HasForeignKey("SubscriptionPlanId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.Navigation("SubscriptionPlan");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.QuizResult", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", "User")
+                        .WithMany("QuizResults")
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("User");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Author", b =>
+                {
+                    b.Navigation("Ebooks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
+                {
+                    b.Navigation("IncomingLinks");
+
+                    b.Navigation("OutgoingLinks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.NexusUser", b =>
+                {
+                    b.Navigation("Ebooks");
+
+                    b.Navigation("QuizResults");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/NexusReader.Data/Migrations/20260607104453_AddThemePreference.cs

@@ -0,0 +1,56 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+using Pgvector;
+
+#nullable disable
+
+namespace NexusReader.Data.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddThemePreference : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "Vector",
+                table: "SemanticKnowledgeCache");
+
+            migrationBuilder.DropColumn(
+                name: "Vector",
+                table: "KnowledgeUnits");
+
+            migrationBuilder.AlterDatabase()
+                .OldAnnotation("Npgsql:PostgresExtension:vector", ",,");
+
+            migrationBuilder.AddColumn<int>(
+                name: "ThemePreference",
+                table: "AspNetUsers",
+                type: "integer",
+                nullable: false,
+                defaultValue: 0);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "ThemePreference",
+                table: "AspNetUsers");
+
+            migrationBuilder.AlterDatabase()
+                .Annotation("Npgsql:PostgresExtension:vector", ",,");
+
+            migrationBuilder.AddColumn<Vector>(
+                name: "Vector",
+                table: "SemanticKnowledgeCache",
+                type: "vector(1536)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<Vector>(
+                name: "Vector",
+                table: "KnowledgeUnits",
+                type: "vector(768)",
+                nullable: true);
+        }
+    }
+}

src/NexusReader.Data/Migrations/20260611183927_AddBookVersioningSupport.Designer.cs

@@ -0,0 +1,865 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using NexusReader.Data.Persistence;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace NexusReader.Data.Migrations
+{
+    [DbContext(typeof(AppDbContext))]
+    [Migration("20260611183927_AddBookVersioningSupport")]
+    partial class AddBookVersioningSupport
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRole", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("NormalizedName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedName")
+                        .IsUnique()
+                        .HasDatabaseName("RoleNameIndex");
+
+                    b.ToTable("AspNetRoles", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("text");
+
+                    b.Property<string>("RoleId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetRoleClaims", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("text");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserClaims", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ProviderKey")
+                        .HasColumnType("text");
+
+                    b.Property<string>("ProviderDisplayName")
+                        .HasColumnType("text");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("LoginProvider", "ProviderKey");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserLogins", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("RoleId")
+                        .HasColumnType("text");
+
+                    b.HasKey("UserId", "RoleId");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetUserRoles", (string)null);
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("text");
+
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Value")
+                        .HasColumnType("text");
+
+                    b.HasKey("UserId", "LoginProvider", "Name");
+
+                    b.ToTable("AspNetUserTokens", (string)null);
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Author", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Authors");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Book", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid?>("CurrentDraftRevisionId")
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid?>("LivePublishedRevisionId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("CurrentDraftRevisionId");
+
+                    b.HasIndex("LivePublishedRevisionId");
+
+                    b.HasIndex("TenantId");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("Books");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.BookRevision", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid>("BookId")
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<bool>("IsPublished")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateTime?>("PublishedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("VersionString")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("BookId");
+
+                    b.ToTable("BookRevisions");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Chapter", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid>("BookRevisionId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("MarkdownContent")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<int>("SortOrder")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("BookRevisionId");
+
+                    b.ToTable("Chapters");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Ebook", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("AddedDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<int>("AuthorId")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("CoverUrl")
+                        .HasColumnType("text");
+
+                    b.Property<string>("Description")
+                        .HasColumnType("text");
+
+                    b.Property<string>("FilePath")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<bool>("IsReadyForReading")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("LastChapter")
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<int>("LastChapterIndex")
+                        .HasColumnType("integer");
+
+                    b.Property<DateTime?>("LastReadDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<double>("Progress")
+                        .HasColumnType("double precision");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("AuthorId");
+
+                    b.HasIndex("TenantId");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("Ebooks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Content")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<Guid?>("EbookId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("MetadataJson")
+                        .HasColumnType("text");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<int>("Type")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Version")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("EbookId");
+
+                    b.HasIndex("TenantId");
+
+                    b.ToTable("KnowledgeUnits");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnitLink", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("RelationType")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.Property<string>("SourceUnitId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("TargetUnitId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("SourceUnitId");
+
+                    b.HasIndex("TargetUnitId");
+
+                    b.ToTable("KnowledgeUnitLinks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.NexusUser", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("text");
+
+                    b.Property<int>("AITokenLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("AITokensUsed")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("AccessFailedCount")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("text");
+
+                    b.Property<string>("DisplayName")
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)");
+
+                    b.Property<string>("Email")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<bool>("EmailConfirmed")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateTime?>("LastAiActionDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTime?>("LastReadAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("LastReadPageId")
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<bool>("LockoutEnabled")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateTimeOffset?>("LockoutEnd")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("NormalizedEmail")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("NormalizedUserName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("PasswordHash")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasColumnType("text");
+
+                    b.Property<bool>("PhoneNumberConfirmed")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("SecurityStamp")
+                        .HasColumnType("text");
+
+                    b.Property<int>("SubscriptionPlanId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer")
+                        .HasDefaultValue(1);
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<int>("ThemePreference")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer")
+                        .HasDefaultValue(0);
+
+                    b.Property<bool>("TwoFactorEnabled")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("UserName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedEmail")
+                        .HasDatabaseName("EmailIndex");
+
+                    b.HasIndex("NormalizedUserName")
+                        .IsUnique()
+                        .HasDatabaseName("UserNameIndex");
+
+                    b.HasIndex("SubscriptionPlanId");
+
+                    b.HasIndex("TenantId");
+
+                    b.ToTable("AspNetUsers", (string)null);
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.QuizResult", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("CompletedDate")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<int>("Score")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Topic")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<int>("TotalQuestions")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("TenantId");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("QuizResults");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.SemanticKnowledgeCache", b =>
+                {
+                    b.Property<string>("ContentHash")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("JsonData")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("ModelId")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.Property<string>("OriginalText")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<string>("PromptVersion")
+                        .IsRequired()
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.HasKey("ContentHash");
+
+                    b.HasIndex("ContentHash")
+                        .IsUnique();
+
+                    b.HasIndex("TenantId");
+
+                    b.ToTable("SemanticKnowledgeCache");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.SubscriptionPlan", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("Id"));
+
+                    b.Property<int>("AITokenLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<bool>("IsUnlimitedTokens")
+                        .HasColumnType("boolean");
+
+                    b.Property<decimal>("MonthlyPrice")
+                        .HasColumnType("numeric");
+
+                    b.Property<string>("PlanName")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.Property<string>("StripeProductId")
+                        .IsRequired()
+                        .HasMaxLength(50)
+                        .HasColumnType("character varying(50)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("PlanName")
+                        .IsUnique();
+
+                    b.ToTable("SubscriptionPlans");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            AITokenLimit = 5000,
+                            IsUnlimitedTokens = false,
+                            MonthlyPrice = 0m,
+                            PlanName = "Free",
+                            StripeProductId = "prod_Free789"
+                        },
+                        new
+                        {
+                            Id = 2,
+                            AITokenLimit = 10000,
+                            IsUnlimitedTokens = false,
+                            MonthlyPrice = 9.99m,
+                            PlanName = "Basic",
+                            StripeProductId = "prod_basic_placeholder"
+                        },
+                        new
+                        {
+                            Id = 3,
+                            AITokenLimit = 50000,
+                            IsUnlimitedTokens = false,
+                            MonthlyPrice = 19.99m,
+                            PlanName = "Pro",
+                            StripeProductId = "prod_pro_placeholder"
+                        },
+                        new
+                        {
+                            Id = 4,
+                            AITokenLimit = 1000000000,
+                            IsUnlimitedTokens = true,
+                            MonthlyPrice = 99.99m,
+                            PlanName = "Enterprise",
+                            StripeProductId = "prod_enterprise_placeholder"
+                        });
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Book", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.BookRevision", "CurrentDraftRevision")
+                        .WithMany()
+                        .HasForeignKey("CurrentDraftRevisionId")
+                        .OnDelete(DeleteBehavior.Restrict);
+
+                    b.HasOne("NexusReader.Domain.Entities.BookRevision", "LivePublishedRevision")
+                        .WithMany()
+                        .HasForeignKey("LivePublishedRevisionId")
+                        .OnDelete(DeleteBehavior.Restrict);
+
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", "User")
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("CurrentDraftRevision");
+
+                    b.Navigation("LivePublishedRevision");
+
+                    b.Navigation("User");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.BookRevision", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.Book", "Book")
+                        .WithMany("Revisions")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Chapter", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.BookRevision", "BookRevision")
+                        .WithMany("Chapters")
+                        .HasForeignKey("BookRevisionId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("BookRevision");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Ebook", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.Author", "Author")
+                        .WithMany("Ebooks")
+                        .HasForeignKey("AuthorId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", "User")
+                        .WithMany("Ebooks")
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Author");
+
+                    b.Navigation("User");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.Ebook", "Ebook")
+                        .WithMany()
+                        .HasForeignKey("EbookId")
+                        .OnDelete(DeleteBehavior.Cascade);
+
+                    b.Navigation("Ebook");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnitLink", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.KnowledgeUnit", "SourceUnit")
+                        .WithMany("OutgoingLinks")
+                        .HasForeignKey("SourceUnitId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("NexusReader.Domain.Entities.KnowledgeUnit", "TargetUnit")
+                        .WithMany("IncomingLinks")
+                        .HasForeignKey("TargetUnitId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("SourceUnit");
+
+                    b.Navigation("TargetUnit");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.NexusUser", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.SubscriptionPlan", "SubscriptionPlan")
+                        .WithMany()
+                        .HasForeignKey("SubscriptionPlanId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.Navigation("SubscriptionPlan");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.QuizResult", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", "User")
+                        .WithMany("QuizResults")
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("User");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Author", b =>
+                {
+                    b.Navigation("Ebooks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Book", b =>
+                {
+                    b.Navigation("Revisions");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.BookRevision", b =>
+                {
+                    b.Navigation("Chapters");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
+                {
+                    b.Navigation("IncomingLinks");
+
+                    b.Navigation("OutgoingLinks");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.NexusUser", b =>
+                {
+                    b.Navigation("Ebooks");
+
+                    b.Navigation("QuizResults");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/NexusReader.Data/Migrations/20260611183927_AddBookVersioningSupport.cs

@@ -0,0 +1,141 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace NexusReader.Data.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddBookVersioningSupport : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "BookRevisions",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    BookId = table.Column<Guid>(type: "uuid", nullable: false),
+                    VersionString = table.Column<string>(type: "character varying(100)", maxLength: 100, nullable: false),
+                    IsPublished = table.Column<bool>(type: "boolean", nullable: false),
+                    CreatedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: false),
+                    PublishedAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_BookRevisions", x => x.Id);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "Books",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    Title = table.Column<string>(type: "character varying(255)", maxLength: 255, nullable: false),
+                    TenantId = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: false),
+                    UserId = table.Column<string>(type: "text", nullable: false),
+                    CurrentDraftRevisionId = table.Column<Guid>(type: "uuid", nullable: true),
+                    LivePublishedRevisionId = table.Column<Guid>(type: "uuid", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Books", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_Books_AspNetUsers_UserId",
+                        column: x => x.UserId,
+                        principalTable: "AspNetUsers",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_Books_BookRevisions_CurrentDraftRevisionId",
+                        column: x => x.CurrentDraftRevisionId,
+                        principalTable: "BookRevisions",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Restrict);
+                    table.ForeignKey(
+                        name: "FK_Books_BookRevisions_LivePublishedRevisionId",
+                        column: x => x.LivePublishedRevisionId,
+                        principalTable: "BookRevisions",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Restrict);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "Chapters",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    BookRevisionId = table.Column<Guid>(type: "uuid", nullable: false),
+                    Title = table.Column<string>(type: "character varying(255)", maxLength: 255, nullable: false),
+                    MarkdownContent = table.Column<string>(type: "text", nullable: false),
+                    SortOrder = table.Column<int>(type: "integer", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Chapters", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_Chapters_BookRevisions_BookRevisionId",
+                        column: x => x.BookRevisionId,
+                        principalTable: "BookRevisions",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_BookRevisions_BookId",
+                table: "BookRevisions",
+                column: "BookId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Books_CurrentDraftRevisionId",
+                table: "Books",
+                column: "CurrentDraftRevisionId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Books_LivePublishedRevisionId",
+                table: "Books",
+                column: "LivePublishedRevisionId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Books_TenantId",
+                table: "Books",
+                column: "TenantId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Books_UserId",
+                table: "Books",
+                column: "UserId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Chapters_BookRevisionId",
+                table: "Chapters",
+                column: "BookRevisionId");
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_BookRevisions_Books_BookId",
+                table: "BookRevisions",
+                column: "BookId",
+                principalTable: "Books",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Cascade);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropForeignKey(
+                name: "FK_BookRevisions_Books_BookId",
+                table: "BookRevisions");
+
+            migrationBuilder.DropTable(
+                name: "Chapters");
+
+            migrationBuilder.DropTable(
+                name: "Books");
+
+            migrationBuilder.DropTable(
+                name: "BookRevisions");
+        }
+    }
+}

src/NexusReader.Data/Migrations/AppDbContextModelSnapshot.cs

@@ -5,7 +5,6 @@ using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
 using NexusReader.Data.Persistence;
 using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
-using Pgvector;
 
 #nullable disable
 
@@ -21,7 +20,6 @@ namespace NexusReader.Data.Migrations
                 .HasAnnotation("ProductVersion", "10.0.7")
                 .HasAnnotation("Relational:MaxIdentifierLength", 63);
 
-            NpgsqlModelBuilderExtensions.HasPostgresExtension(modelBuilder, "vector");
             NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
 
             modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRole", b =>
@@ -174,6 +172,103 @@ namespace NexusReader.Data.Migrations
                     b.ToTable("Authors");
                 });
 
+            modelBuilder.Entity("NexusReader.Domain.Entities.Book", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid?>("CurrentDraftRevisionId")
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid?>("LivePublishedRevisionId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("TenantId")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("CurrentDraftRevisionId");
+
+                    b.HasIndex("LivePublishedRevisionId");
+
+                    b.HasIndex("TenantId");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("Books");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.BookRevision", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid>("BookId")
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("CreatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<bool>("IsPublished")
+                        .HasColumnType("boolean");
+
+                    b.Property<DateTime?>("PublishedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("VersionString")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("BookId");
+
+                    b.ToTable("BookRevisions");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Chapter", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid>("BookRevisionId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("MarkdownContent")
+                        .IsRequired()
+                        .HasColumnType("text");
+
+                    b.Property<int>("SortOrder")
+                        .HasColumnType("integer");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(255)
+                        .HasColumnType("character varying(255)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("BookRevisionId");
+
+                    b.ToTable("Chapters");
+                });
+
             modelBuilder.Entity("NexusReader.Domain.Entities.Ebook", b =>
                 {
                     b.Property<Guid>("Id")
@@ -264,9 +359,6 @@ namespace NexusReader.Data.Migrations
                     b.Property<int>("Type")
                         .HasColumnType("integer");
 
-                    b.Property<Vector>("Vector")
-                        .HasColumnType("vector(768)");
-
                     b.Property<string>("Version")
                         .IsRequired()
                         .HasMaxLength(50)
@@ -388,6 +480,11 @@ namespace NexusReader.Data.Migrations
                         .HasMaxLength(128)
                         .HasColumnType("character varying(128)");
 
+                    b.Property<int>("ThemePreference")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer")
+                        .HasDefaultValue(0);
+
                     b.Property<bool>("TwoFactorEnabled")
                         .HasColumnType("boolean");
 
@@ -480,9 +577,6 @@ namespace NexusReader.Data.Migrations
                         .HasMaxLength(128)
                         .HasColumnType("character varying(128)");
 
-                    b.Property<Vector>("Vector")
-                        .HasColumnType("vector(1536)");
-
                     b.HasKey("ContentHash");
 
                     b.HasIndex("ContentHash")
@@ -617,6 +711,53 @@ namespace NexusReader.Data.Migrations
                         .IsRequired();
                 });
 
+            modelBuilder.Entity("NexusReader.Domain.Entities.Book", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.BookRevision", "CurrentDraftRevision")
+                        .WithMany()
+                        .HasForeignKey("CurrentDraftRevisionId")
+                        .OnDelete(DeleteBehavior.Restrict);
+
+                    b.HasOne("NexusReader.Domain.Entities.BookRevision", "LivePublishedRevision")
+                        .WithMany()
+                        .HasForeignKey("LivePublishedRevisionId")
+                        .OnDelete(DeleteBehavior.Restrict);
+
+                    b.HasOne("NexusReader.Domain.Entities.NexusUser", "User")
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("CurrentDraftRevision");
+
+                    b.Navigation("LivePublishedRevision");
+
+                    b.Navigation("User");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.BookRevision", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.Book", "Book")
+                        .WithMany("Revisions")
+                        .HasForeignKey("BookId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Book");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.Chapter", b =>
+                {
+                    b.HasOne("NexusReader.Domain.Entities.BookRevision", "BookRevision")
+                        .WithMany("Chapters")
+                        .HasForeignKey("BookRevisionId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("BookRevision");
+                });
+
             modelBuilder.Entity("NexusReader.Domain.Entities.Ebook", b =>
                 {
                     b.HasOne("NexusReader.Domain.Entities.Author", "Author")
@@ -692,6 +833,16 @@ namespace NexusReader.Data.Migrations
                     b.Navigation("Ebooks");
                 });
 
+            modelBuilder.Entity("NexusReader.Domain.Entities.Book", b =>
+                {
+                    b.Navigation("Revisions");
+                });
+
+            modelBuilder.Entity("NexusReader.Domain.Entities.BookRevision", b =>
+                {
+                    b.Navigation("Chapters");
+                });
+
             modelBuilder.Entity("NexusReader.Domain.Entities.KnowledgeUnit", b =>
                 {
                     b.Navigation("IncomingLinks");

src/NexusReader.Data/Persistence/AppDbContext.cs

@@ -1,6 +1,7 @@
 using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore;
 using NexusReader.Domain.Entities;
+using NexusReader.Domain.Enums;
 
 namespace NexusReader.Data.Persistence;
 
@@ -24,6 +25,9 @@ public class AppDbContext : IdentityDbContext<NexusUser>
     public DbSet<QuizResult> QuizResults => Set<QuizResult>();
     public DbSet<SubscriptionPlan> SubscriptionPlans => Set<SubscriptionPlan>();
     public DbSet<Author> Authors => Set<Author>();
+    public DbSet<Book> Books => Set<Book>();
+    public DbSet<BookRevision> BookRevisions => Set<BookRevision>();
+    public DbSet<Chapter> Chapters => Set<Chapter>();
 
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
@@ -43,6 +47,10 @@ public class AppDbContext : IdentityDbContext<NexusUser>
             // Note: DefaultValue for int is 1 (which corresponds to 'Free' in our seed)
             entity.Property(u => u.SubscriptionPlanId)
                 .HasDefaultValue(1);
+
+            entity.Property(u => u.ThemePreference)
+                .HasConversion<int>()
+                .HasDefaultValue(ThemeMode.System);
         });
 
         modelBuilder.Entity<SubscriptionPlan>(entity =>
@@ -109,6 +117,48 @@ public class AppDbContext : IdentityDbContext<NexusUser>
             entity.HasIndex(e => e.TenantId);
         });
 
+        modelBuilder.Entity<Book>(entity =>
+        {
+            entity.HasKey(b => b.Id);
+            entity.HasIndex(b => b.TenantId);
+            entity.HasIndex(b => b.UserId);
+
+            entity.HasOne(e => e.User)
+                .WithMany()
+                .HasForeignKey(e => e.UserId)
+                .OnDelete(DeleteBehavior.Cascade);
+
+            entity.HasMany(b => b.Revisions)
+                .WithOne(r => r.Book)
+                .HasForeignKey(r => r.BookId)
+                .OnDelete(DeleteBehavior.Cascade);
+
+            entity.HasOne(b => b.CurrentDraftRevision)
+                .WithMany()
+                .HasForeignKey(b => b.CurrentDraftRevisionId)
+                .OnDelete(DeleteBehavior.Restrict);
+
+            entity.HasOne(b => b.LivePublishedRevision)
+                .WithMany()
+                .HasForeignKey(b => b.LivePublishedRevisionId)
+                .OnDelete(DeleteBehavior.Restrict);
+        });
+
+        modelBuilder.Entity<BookRevision>(entity =>
+        {
+            entity.HasKey(r => r.Id);
+
+            entity.HasMany(r => r.Chapters)
+                .WithOne(c => c.BookRevision)
+                .HasForeignKey(c => c.BookRevisionId)
+                .OnDelete(DeleteBehavior.Cascade);
+        });
+
+        modelBuilder.Entity<Chapter>(entity =>
+        {
+            entity.HasKey(c => c.Id);
+        });
+
         // Seed Subscription Plans with deterministic IDs
         modelBuilder.Entity<SubscriptionPlan>().HasData(
             new SubscriptionPlan { Id = 1, PlanName = SubscriptionPlan.FreeName, AITokenLimit = 5000, IsUnlimitedTokens = false, MonthlyPrice = 0m, StripeProductId = "prod_Free789" },

src/NexusReader.Data/Persistence/DbInitializer.cs

@@ -136,6 +136,72 @@ public static class DbInitializer
             {
                 Console.WriteLine("[Seeder] Admin user already exists.");
             }
+
+            // Seed Sample Authored Book for Creator Dashboard
+            var activeAdmin = await dbContext.Users.FirstOrDefaultAsync(u => u.NormalizedEmail == normalizedEmail);
+            if (activeAdmin != null)
+            {
+                if (!dbContext.Books.Any(b => b.UserId == activeAdmin.Id))
+                {
+                    var sampleBookId = Guid.NewGuid();
+                    var sampleBook = new Book
+                    {
+                        Id = sampleBookId,
+                        Title = "Przewodnik po platformie Nexus",
+                        UserId = activeAdmin.Id,
+                        TenantId = activeAdmin.TenantId ?? "global"
+                    };
+                    dbContext.Books.Add(sampleBook);
+                    await dbContext.SaveChangesAsync();
+
+                    var sampleRevisionId = Guid.NewGuid();
+                    var sampleRevision = new BookRevision
+                    {
+                        Id = sampleRevisionId,
+                        BookId = sampleBookId,
+                        VersionString = "Working Draft",
+                        IsPublished = false,
+                        CreatedAt = DateTime.UtcNow
+                    };
+                    dbContext.BookRevisions.Add(sampleRevision);
+                    await dbContext.SaveChangesAsync();
+
+                    var sampleChapter1 = new Chapter
+                    {
+                        Id = Guid.NewGuid(),
+                        BookRevisionId = sampleRevisionId,
+                        Title = "Rozdział 1: Wprowadzenie do Zen Mode",
+                        MarkdownContent = @"# Zen Mode Editor
+
+Welcome to your dedicated workspace. This premium panel supports Notion-like WYSIWYG editing.
+
+## Features:
+- **Zero Distraction**: Simple elevation and border framing.
+- **GFM Tables**: Consistent cell padding and hover striping.
+- **Clean Code Blocks**: Pre-rendered base64 font-loaded code-preview blocks.",
+                        SortOrder = 1
+                    };
+
+                    var sampleChapter2 = new Chapter
+                    {
+                        Id = Guid.NewGuid(),
+                        BookRevisionId = sampleRevisionId,
+                        Title = "Rozdział 2: Zabezpieczenia i XSS",
+                        MarkdownContent = @"# Security Overview
+
+This module provides Magic Number image signature checking and HtmlSanitizer filters.",
+                        SortOrder = 2
+                    };
+
+                    dbContext.Chapters.Add(sampleChapter1);
+                    dbContext.Chapters.Add(sampleChapter2);
+                    await dbContext.SaveChangesAsync();
+
+                    sampleBook.CurrentDraftRevisionId = sampleRevisionId;
+                    await dbContext.SaveChangesAsync();
+                    Console.WriteLine("[Seeder] Sample authored book and chapters seeded for admin.");
+                }
+            }
         }
         catch (Exception ex)
         {

src/NexusReader.Domain/Entities/Book.cs

@@ -0,0 +1,39 @@
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace NexusReader.Domain.Entities;
+
+/// <summary>
+/// Represents a Book metadata entry that references its decoupled revisions.
+/// </summary>
+public class Book
+{
+    [Key]
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    [Required]
+    [MaxLength(255)]
+    public string Title { get; set; } = string.Empty;
+
+    [Required]
+    [MaxLength(128)]
+    public string TenantId { get; set; } = "global";
+
+    [Required]
+    public string UserId { get; set; } = string.Empty;
+
+    [ForeignKey(nameof(UserId))]
+    public virtual NexusUser? User { get; set; }
+
+    public Guid? CurrentDraftRevisionId { get; set; }
+
+    [ForeignKey(nameof(CurrentDraftRevisionId))]
+    public virtual BookRevision? CurrentDraftRevision { get; set; }
+
+    public Guid? LivePublishedRevisionId { get; set; }
+
+    [ForeignKey(nameof(LivePublishedRevisionId))]
+    public virtual BookRevision? LivePublishedRevision { get; set; }
+
+    public virtual ICollection<BookRevision> Revisions { get; set; } = new List<BookRevision>();
+}

src/NexusReader.Domain/Entities/BookRevision.cs

@@ -0,0 +1,31 @@
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace NexusReader.Domain.Entities;
+
+/// <summary>
+/// Encapsulates a snapshot or draft version of a Book's chapters.
+/// </summary>
+public class BookRevision
+{
+    [Key]
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    [Required]
+    public Guid BookId { get; set; }
+
+    [ForeignKey(nameof(BookId))]
+    public virtual Book Book { get; set; } = null!;
+
+    [Required]
+    [MaxLength(100)]
+    public string VersionString { get; set; } = "Working Draft";
+
+    public bool IsPublished { get; set; } = false;
+
+    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+
+    public DateTime? PublishedAt { get; set; }
+
+    public virtual ICollection<Chapter> Chapters { get; set; } = new List<Chapter>();
+}

src/NexusReader.Domain/Entities/Chapter.cs

@@ -0,0 +1,29 @@
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace NexusReader.Domain.Entities;
+
+/// <summary>
+/// Represents a chapter belonging strictly to a specific BookRevision.
+/// </summary>
+public class Chapter
+{
+    [Key]
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    [Required]
+    public Guid BookRevisionId { get; set; }
+
+    [ForeignKey(nameof(BookRevisionId))]
+    public virtual BookRevision BookRevision { get; set; } = null!;
+
+    [Required]
+    [MaxLength(255)]
+    public string Title { get; set; } = string.Empty;
+
+    [Required]
+    public string MarkdownContent { get; set; } = string.Empty;
+
+    [Required]
+    public int SortOrder { get; set; }
+}

src/NexusReader.Domain/Entities/NexusUser.cs

@@ -1,6 +1,7 @@
 using Microsoft.AspNetCore.Identity;
 using System.ComponentModel.DataAnnotations;
 using System.ComponentModel.DataAnnotations.Schema;
+using NexusReader.Domain.Enums;
 
 namespace NexusReader.Domain.Entities;
 
@@ -65,4 +66,9 @@ public class NexusUser : IdentityUser
     /// Last read timestamp.
     /// </summary>
     public DateTime? LastReadAt { get; set; }
+
+    /// <summary>
+    /// User's visual theme preference.
+    /// </summary>
+    public ThemeMode ThemePreference { get; set; } = ThemeMode.System;
 }

src/NexusReader.Domain/Enums/ThemeMode.cs

@@ -0,0 +1,8 @@
+namespace NexusReader.Domain.Enums;
+
+public enum ThemeMode
+{
+    System = 0,
+    Dark = 1,
+    LightSepia = 2
+}

src/NexusReader.Domain/Exceptions/BookNotFoundException.cs

@@ -0,0 +1,12 @@
+namespace NexusReader.Domain.Exceptions;
+
+/// <summary>
+/// Custom domain exception thrown when a Book cannot be found by its ID.
+/// </summary>
+public class BookNotFoundException : Exception
+{
+    public BookNotFoundException(Guid bookId) 
+        : base($"Book with ID '{bookId}' was not found.")
+    {
+    }
+}

src/NexusReader.Infrastructure/Configuration/HtmlSanitizerSettings.cs

@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+
+namespace NexusReader.Infrastructure.Configuration;
+
+/// <summary>
+/// Settings for configuring allowed tags, attributes, CSS properties, and schemes in HtmlSanitizerService.
+/// </summary>
+public class HtmlSanitizerSettings
+{
+    public const string SectionName = "HtmlSanitizer";
+
+    /// <summary>
+    /// Gets or sets the list of HTML tags that are allowed.
+    /// If null or empty, the default allowed tags list is used.
+    /// </summary>
+    public List<string>? AllowedTags { get; set; }
+
+    /// <summary>
+    /// Gets or sets the list of HTML attributes that are allowed.
+    /// If null or empty, the default allowed attributes list is used.
+    /// </summary>
+    public List<string>? AllowedAttributes { get; set; }
+
+    /// <summary>
+    /// Gets or sets the list of CSS properties that are allowed.
+    /// If null or empty, the default allowed CSS properties list is used.
+    /// </summary>
+    public List<string>? AllowedCssProperties { get; set; }
+
+    /// <summary>
+    /// Gets or sets the list of URI schemes that are allowed (e.g. "http", "https").
+    /// If null or empty, the default allowed schemes list is used.
+    /// </summary>
+    public List<string>? AllowedSchemes { get; set; }
+}

src/NexusReader.Infrastructure/DependencyInjection.cs

@@ -2,6 +2,7 @@ using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Configuration;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.AI;
+using NexusReader.Application.Common;
 using GeminiDotnet;
 using GeminiDotnet.Extensions.AI;
 using NexusReader.Data.Persistence;
@@ -54,7 +55,15 @@ public static class DependencyInjection
 
         // Qdrant Client registration
         var qdrantUrl = configuration.GetConnectionString("QdrantConnection") ?? "http://localhost:6334";
-        services.AddSingleton<QdrantClient>(sp => new QdrantClient(new Uri(qdrantUrl)));
+        var qdrantApiKey = configuration["Qdrant:ApiKey"];
+        services.AddSingleton<QdrantClient>(sp => 
+        {
+            if (!string.IsNullOrEmpty(qdrantApiKey))
+            {
+                return new QdrantClient(new Uri(qdrantUrl), apiKey: qdrantApiKey);
+            }
+            return new QdrantClient(new Uri(qdrantUrl));
+        });
 
         // Neo4j Driver registration (supports optional authentication)
         var neo4jUrl = configuration.GetConnectionString("Neo4jConnection") ?? "bolt://localhost:7687";
@@ -76,6 +85,8 @@ public static class DependencyInjection
 
         services.Configure<AiSettings>(configuration.GetSection(AiSettings.SectionName));
         services.Configure<StripeSettings>(configuration.GetSection(StripeSettings.SectionName));
+        services.Configure<RagMonetizationOptions>(configuration.GetSection(RagMonetizationOptions.SectionName));
+        services.Configure<HtmlSanitizerSettings>(configuration.GetSection(HtmlSanitizerSettings.SectionName));
         var aiSettings = configuration.GetSection(AiSettings.SectionName).Get<AiSettings>() ?? new AiSettings();
 
         if (string.IsNullOrWhiteSpace(aiSettings.ApiKey) || aiSettings.ApiKey == "PLACEHOLDER")
@@ -122,11 +133,16 @@ public static class DependencyInjection
         // Fix #4: Scoped instead of Singleton — BookStorageService uses path resolution
         // that is environment-specific and incompatible with Singleton lifetime in MAUI.
         services.AddScoped<IBookStorageService, BookStorageService>();
+        services.AddScoped<IStorageService, LocalStorageService>();
+        services.AddSingleton<ISanitizerService, HtmlSanitizerService>();
 
         // Fix #1: Ebook repository (scoped, matches AppDbContext lifetime)
         services.AddScoped<IEbookRepository, EbookRepository>();
         services.AddScoped<IQuizResultRepository, QuizResultRepository>();
         services.AddScoped<IConceptsMapReadRepository, ConceptsMapReadRepository>();
+        services.AddScoped<IUserLibraryStore, UserLibraryStore>();
+        services.AddScoped<IUserReadingStateStore, UserReadingStateStore>();
+        services.AddScoped<IVectorSearchStore, VectorSearchStore>();
 
         // Fix #2: SignalR broadcaster (scoped, wraps IHubContext which is itself a singleton wrapper)
         services.AddScoped<ISyncBroadcaster, SignalRSyncBroadcaster>();

src/NexusReader.Infrastructure/NexusReader.Infrastructure.csproj

@@ -28,6 +28,8 @@
     <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" />
     <PackageReference Include="Polly" />
     <PackageReference Include="Polly.Extensions.Http" />
+    <PackageReference Include="HtmlSanitizer" />
+    <PackageReference Include="Markdig" />
     <PackageReference Include="Qdrant.Client" />
     <PackageReference Include="Stripe.net" />
     <PackageReference Include="VersOne.Epub" />

src/NexusReader.Infrastructure/Persistence/UserLibraryStore.cs

@@ -0,0 +1,45 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Persistence;
+using NexusReader.Data.Persistence;
+
+namespace NexusReader.Infrastructure.Persistence;
+
+/// <summary>
+/// EF Core implementation of <see cref="IUserLibraryStore"/> using <see cref="AppDbContext"/>.
+/// </summary>
+internal sealed class UserLibraryStore : IUserLibraryStore
+{
+    private readonly AppDbContext _context;
+
+    public UserLibraryStore(AppDbContext context)
+    {
+        _context = context;
+    }
+
+    /// <inheritdoc />
+    public async Task<List<Guid>> GetOwnedBookIdsAsync(string userId, CancellationToken cancellationToken = default)
+    {
+        return await _context.Ebooks
+            .Where(e => e.UserId == userId)
+            .Select(e => e.Id)
+            .ToListAsync(cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task<Dictionary<Guid, string>> GetBookTitlesAsync(List<Guid> bookIds, CancellationToken cancellationToken = default)
+    {
+        if (bookIds == null || !bookIds.Any())
+        {
+            return new Dictionary<Guid, string>();
+        }
+
+        return await _context.Ebooks
+            .Where(e => bookIds.Contains(e.Id))
+            .ToDictionaryAsync(e => e.Id, e => e.Title, cancellationToken);
+    }
+}

src/NexusReader.Infrastructure/Persistence/UserReadingStateStore.cs

@@ -0,0 +1,56 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using NexusReader.Application.Abstractions.Persistence;
+using NexusReader.Data.Persistence;
+
+namespace NexusReader.Infrastructure.Persistence;
+
+/// <summary>
+/// EF Core implementation of <see cref="IUserReadingStateStore"/>.
+/// </summary>
+internal sealed class UserReadingStateStore : IUserReadingStateStore
+{
+    private readonly IDbContextFactory<AppDbContext> _dbContextFactory;
+
+    public UserReadingStateStore(IDbContextFactory<AppDbContext> dbContextFactory)
+    {
+        _dbContextFactory = dbContextFactory;
+    }
+
+    /// <inheritdoc />
+    public async Task<(Guid? EbookId, string? ChapterId, string? TenantId)> GetActiveReadingStateAsync(string userId, CancellationToken cancellationToken = default)
+    {
+        await using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+
+        var userState = await dbContext.Users
+            .Where(u => u.Id == userId)
+            .Select(u => new
+            {
+                u.TenantId,
+                u.LastReadPageId,
+                LastReadBookId = u.Ebooks.OrderByDescending(e => e.LastReadDate).Select(e => (Guid?)e.Id).FirstOrDefault()
+            })
+            .FirstOrDefaultAsync(cancellationToken);
+
+        if (userState == null)
+        {
+            return (null, null, null);
+        }
+
+        return (userState.LastReadBookId, userState.LastReadPageId, userState.TenantId);
+    }
+
+    /// <inheritdoc />
+    public async Task<string?> GetChapterContentAsync(string chapterId, CancellationToken cancellationToken = default)
+    {
+        await using var dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
+
+        return await dbContext.KnowledgeUnits
+            .Where(ku => ku.Id == chapterId)
+            .Select(ku => ku.Content)
+            .FirstOrDefaultAsync(cancellationToken);
+    }
+}

src/NexusReader.Infrastructure/Persistence/VectorSearchStore.cs

@@ -0,0 +1,210 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Logging;
+using Qdrant.Client;
+using Qdrant.Client.Grpc;
+using Polly;
+using Polly.Registry;
+using NexusReader.Application.Abstractions.Persistence;
+
+namespace NexusReader.Infrastructure.Persistence;
+
+/// <summary>
+/// Infrastructure implementation of <see cref="IVectorSearchStore"/> utilizing <see cref="QdrantClient"/> 
+/// and <see cref="IEmbeddingGenerator{TInput, TEmbedding}"/> to execute semantic vector queries.
+/// </summary>
+internal sealed class VectorSearchStore : IVectorSearchStore
+{
+    private readonly QdrantClient _qdrantClient;
+    private readonly IEmbeddingGenerator<string, Embedding<float>> _embeddingGenerator;
+    private readonly ResiliencePipeline _retryPipeline;
+    private readonly ILogger<VectorSearchStore> _logger;
+
+    public VectorSearchStore(
+        QdrantClient qdrantClient,
+        IEmbeddingGenerator<string, Embedding<float>> embeddingGenerator,
+        ResiliencePipelineProvider<string> pipelineProvider,
+        ILogger<VectorSearchStore> logger)
+    {
+        _qdrantClient = qdrantClient;
+        _embeddingGenerator = embeddingGenerator;
+        _retryPipeline = pipelineProvider.GetPipeline("ai-retry");
+        _logger = logger;
+    }
+
+    /// <inheritdoc />
+    public async Task<List<VectorChunk>> SearchGlobalAsync(string queryText, string tenantId, int limit, CancellationToken cancellationToken = default)
+    {
+        var queryVector = await GenerateEmbeddingAsync(queryText, cancellationToken);
+        var filter = BuildTenantFilter(tenantId);
+
+        return await ExecuteSearchAsync(queryVector, filter, limit, cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task<List<VectorChunk>> SearchLocalAsync(string queryText, string tenantId, List<Guid> whitelistedBookIds, int limit, CancellationToken cancellationToken = default)
+    {
+        if (whitelistedBookIds == null || !whitelistedBookIds.Any())
+        {
+            return new List<VectorChunk>();
+        }
+
+        var queryVector = await GenerateEmbeddingAsync(queryText, cancellationToken);
+        var filter = BuildTenantFilter(tenantId);
+
+        var whitelistFilter = new Qdrant.Client.Grpc.Filter();
+        foreach (var bookId in whitelistedBookIds)
+        {
+            whitelistFilter.Should.Add(new Qdrant.Client.Grpc.Condition
+            {
+                Field = new Qdrant.Client.Grpc.FieldCondition
+                {
+                    Key = "ebookId",
+                    Match = new Qdrant.Client.Grpc.Match { Text = bookId.ToString() }
+                }
+            });
+        }
+        filter.Must.Add(new Qdrant.Client.Grpc.Condition { Filter = whitelistFilter });
+
+        return await ExecuteSearchAsync(queryVector, filter, limit, cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task<List<VectorChunk>> SearchGlobalExcludeAsync(string queryText, string tenantId, Guid excludeBookId, int limit, CancellationToken cancellationToken = default)
+    {
+        var queryVector = await GenerateEmbeddingAsync(queryText, cancellationToken);
+        var filter = BuildTenantFilter(tenantId);
+
+        // Exclude current book
+        filter.MustNot.Add(new Qdrant.Client.Grpc.Condition
+        {
+            Field = new Qdrant.Client.Grpc.FieldCondition
+            {
+                Key = "ebookId",
+                Match = new Qdrant.Client.Grpc.Match { Text = excludeBookId.ToString() }
+            }
+        });
+
+        return await ExecuteSearchAsync(queryVector, filter, limit, cancellationToken);
+    }
+
+    private async Task<float[]> GenerateEmbeddingAsync(string text, CancellationToken cancellationToken)
+    {
+        if (string.IsNullOrWhiteSpace(text))
+        {
+            _logger.LogWarning("[VectorSearchStore] Attempted to generate embedding from empty text. Returning zero vector.");
+            return Array.Empty<float>();
+        }
+
+        var sw = Stopwatch.StartNew();
+        var response = await _retryPipeline.ExecuteAsync(async ct => 
+            await _embeddingGenerator.GenerateAsync(
+                new[] { text }, 
+                new EmbeddingGenerationOptions { Dimensions = 768 }, 
+                cancellationToken: ct), cancellationToken);
+        sw.Stop();
+
+        _logger.LogDebug("[VectorSearchStore] Embedding generated in {ElapsedMs}ms for text of {Length} chars.", sw.ElapsedMilliseconds, text.Length);
+        return response.First().Vector.ToArray();
+    }
+
+    private Qdrant.Client.Grpc.Filter BuildTenantFilter(string tenantId)
+    {
+        var filter = new Qdrant.Client.Grpc.Filter();
+        var tenantFilter = new Qdrant.Client.Grpc.Filter();
+
+        tenantFilter.Should.Add(new Qdrant.Client.Grpc.Condition
+        {
+            Field = new Qdrant.Client.Grpc.FieldCondition
+            {
+                Key = "tenantId",
+                Match = new Qdrant.Client.Grpc.Match { Text = tenantId }
+            }
+        });
+
+        tenantFilter.Should.Add(new Qdrant.Client.Grpc.Condition
+        {
+            Field = new Qdrant.Client.Grpc.FieldCondition
+            {
+                Key = "tenantId",
+                Match = new Qdrant.Client.Grpc.Match { Text = "global" }
+            }
+        });
+
+        filter.Must.Add(new Qdrant.Client.Grpc.Condition { Filter = tenantFilter });
+        return filter;
+    }
+
+    private async Task<List<VectorChunk>> ExecuteSearchAsync(float[] queryVector, Qdrant.Client.Grpc.Filter filter, int limit, CancellationToken cancellationToken)
+    {
+        if (queryVector.Length == 0)
+        {
+            _logger.LogWarning("[VectorSearchStore] Empty query vector — skipping Qdrant search.");
+            return new List<VectorChunk>();
+        }
+
+        try
+        {
+            await EnsureCollectionExistsAsync("knowledge_units", cancellationToken);
+
+            var sw = Stopwatch.StartNew();
+            var response = await _qdrantClient.SearchAsync(
+                collectionName: "knowledge_units",
+                vector: queryVector,
+                filter: filter,
+                limit: (ulong)limit,
+                cancellationToken: cancellationToken
+            );
+            sw.Stop();
+            _logger.LogInformation("[VectorSearchStore] Qdrant search returned {Count} results in {ElapsedMs}ms.", response.Count, sw.ElapsedMilliseconds);
+
+            return response.Select(point => 
+            {
+                var content = point.Payload.TryGetValue("content", out var cv) ? cv.StringValue : string.Empty;
+                var ebookId = point.Payload.TryGetValue("ebookId", out var ev) ? ev.StringValue : string.Empty;
+                var metadataJson = point.Payload.TryGetValue("metadataJson", out var mv) ? mv.StringValue : string.Empty;
+                var bookTitle = point.Payload.TryGetValue("bookTitle", out var btv) ? btv.StringValue : string.Empty;
+                var chapterTitle = point.Payload.TryGetValue("chapterTitle", out var ctv) ? ctv.StringValue : string.Empty;
+
+                return new VectorChunk(content, ebookId, point.Score, metadataJson, bookTitle, chapterTitle);
+            }).ToList();
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "[VectorSearchStore] Qdrant search execution failed.");
+            throw;
+        }
+    }
+
+    private async Task EnsureCollectionExistsAsync(string collectionName, CancellationToken cancellationToken)
+    {
+        try
+        {
+            var exists = await _qdrantClient.CollectionExistsAsync(collectionName, cancellationToken);
+            if (!exists)
+            {
+                _logger.LogInformation("[VectorSearchStore] Collection '{CollectionName}' does not exist — creating.", collectionName);
+                await _qdrantClient.CreateCollectionAsync(
+                    collectionName: collectionName,
+                    vectorsConfig: new Qdrant.Client.Grpc.VectorParams
+                    {
+                        Size = 768,
+                        Distance = Distance.Cosine
+                    },
+                    cancellationToken: cancellationToken
+                );
+                _logger.LogInformation("[VectorSearchStore] Collection '{CollectionName}' created successfully.", collectionName);
+            }
+        }
+        catch (Exception ex)
+        {
+            // Log concurrent creation conflicts (e.g., AlreadyExists gRPC status) but do not propagate.
+            _logger.LogWarning(ex, "[VectorSearchStore] Non-fatal error while ensuring collection '{CollectionName}' exists. Possible concurrent creation.", collectionName);
+        }
+    }
+}

src/NexusReader.Infrastructure/Queries/GetContextualRecommendationsQueryHandler.cs

@@ -0,0 +1,145 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.Json;
+using System.Threading;
+using System.Threading.Tasks;
+using FluentResults;
+using MediatR;
+using Microsoft.Extensions.Logging;
+using NexusReader.Application.Abstractions.Persistence;
+using NexusReader.Application.Queries.Recommendations;
+
+namespace NexusReader.Infrastructure.Queries;
+
+/// <summary>
+/// Handles <see cref="GetContextualRecommendationsQuery"/> by discovering the active reading state,
+/// performing semantic search using <see cref="IVectorSearchStore"/> with book exclusion, and mapping upsells.
+/// </summary>
+public class GetContextualRecommendationsQueryHandler : IRequestHandler<GetContextualRecommendationsQuery, Result<ContextualRecommendationResponse>>
+{
+    private readonly IUserReadingStateStore _readingStateStore;
+    private readonly IUserLibraryStore _libraryStore;
+    private readonly IVectorSearchStore _vectorSearchStore;
+    private readonly ILogger<GetContextualRecommendationsQueryHandler> _logger;
+
+    /// <summary>
+    /// Initializes a new instance of <see cref="GetContextualRecommendationsQueryHandler"/>.
+    /// </summary>
+    public GetContextualRecommendationsQueryHandler(
+        IUserReadingStateStore readingStateStore,
+        IUserLibraryStore libraryStore,
+        IVectorSearchStore vectorSearchStore,
+        ILogger<GetContextualRecommendationsQueryHandler> logger)
+    {
+        _readingStateStore = readingStateStore;
+        _libraryStore = libraryStore;
+        _vectorSearchStore = vectorSearchStore;
+        _logger = logger;
+    }
+
+    /// <inheritdoc />
+    public async Task<Result<ContextualRecommendationResponse>> Handle(GetContextualRecommendationsQuery request, CancellationToken cancellationToken)
+    {
+        if (string.IsNullOrEmpty(request.UserId))
+        {
+            return Result.Fail("UserId cannot be empty.");
+        }
+
+        try
+        {
+            // Step 1: Discover active reading state
+            var (ebookId, chapterId, tenantId) = await _readingStateStore.GetActiveReadingStateAsync(request.UserId, cancellationToken);
+            if (ebookId == null)
+            {
+                _logger.LogInformation("[Recommendations] No active reading state for user {UserId}. Returning empty list.", request.UserId);
+                return Result.Ok(new ContextualRecommendationResponse(new List<RecommendationDto>()));
+            }
+
+            // Step 2: Fetch specific content associated with active ChapterId
+            string? chapterContent = null;
+            if (!string.IsNullOrEmpty(chapterId))
+            {
+                chapterContent = await _readingStateStore.GetChapterContentAsync(chapterId, cancellationToken);
+            }
+
+            // Guard: empty chapter content cannot produce a meaningful embedding
+            if (string.IsNullOrWhiteSpace(chapterContent))
+            {
+                _logger.LogWarning("[Recommendations] Chapter content is empty for chapterId={ChapterId}. Returning empty list.", chapterId);
+                return Result.Ok(new ContextualRecommendationResponse(new List<RecommendationDto>()));
+            }
+
+            // Step 3: Perform similarity search using IVectorSearchStore
+            var resolvedTenantId = tenantId ?? "global";
+            _logger.LogDebug("[Recommendations] Performing vector search for user {UserId}, book {EbookId}, tenant {TenantId}.", request.UserId, ebookId, resolvedTenantId);
+
+            var searchResults = await _vectorSearchStore.SearchGlobalExcludeAsync(
+                chapterContent,
+                resolvedTenantId,
+                ebookId.Value,
+                limit: 2,
+                cancellationToken: cancellationToken
+            );
+
+            // Step 4: Process recommendations and cross-reference owned books
+            var ownedBookIds = await _libraryStore.GetOwnedBookIdsAsync(request.UserId, cancellationToken);
+            var recommendations = new List<RecommendationDto>();
+
+            foreach (var point in searchResults)
+            {
+                var targetEbookIdStr = point.EbookId;
+                if (!Guid.TryParse(targetEbookIdStr, out var targetEbookId))
+                    continue;
+
+                // Load bookTitle from point
+                var bookTitle = point.BookTitle;
+                if (string.IsNullOrEmpty(bookTitle))
+                {
+                    bookTitle = "Nieznana książka";
+                }
+
+                // Load chapterTitle from point or metadataJson
+                var chapterTitle = point.ChapterTitle;
+                if (string.IsNullOrEmpty(chapterTitle))
+                {
+                    chapterTitle = "Wiedza z rozdziału";
+                    if (!string.IsNullOrEmpty(point.MetadataJson))
+                    {
+                        try
+                        {
+                            using var doc = JsonDocument.Parse(point.MetadataJson);
+                            if (doc.RootElement.TryGetProperty("label", out var labelProp))
+                            {
+                                chapterTitle = labelProp.GetString() ?? chapterTitle;
+                            }
+                        }
+                        catch (JsonException jsonEx)
+                        {
+                            _logger.LogWarning(jsonEx, "[Recommendations] Failed to parse metadataJson for chunk with ebookId={EbookId}.", targetEbookIdStr);
+                        }
+                    }
+                }
+
+                var isPremiumUpsell = !ownedBookIds.Contains(targetEbookId);
+                var matchPercentage = (int)Math.Round(point.Score * 100);
+
+                recommendations.Add(new RecommendationDto(
+                    BookTitle: bookTitle,
+                    ChapterTitle: chapterTitle,
+                    MatchPercentage: matchPercentage,
+                    IsPremiumUpsell: isPremiumUpsell,
+                    TargetBookId: targetEbookId
+                ));
+            }
+
+            _logger.LogInformation("[Recommendations] Returning {Count} recommendations for user {UserId}.", recommendations.Count, request.UserId);
+            return Result.Ok(new ContextualRecommendationResponse(recommendations));
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "[Recommendations] Downstream vector database or state query failed for user {UserId}.", request.UserId);
+            return Result.Fail(new Error("Downstream vector database or state query failed.").CausedBy(ex));
+        }
+    }
+}

src/NexusReader.Infrastructure/Services/HtmlSanitizerService.cs

@@ -0,0 +1,76 @@
+using Ganss.Xss;
+using Microsoft.Extensions.Options;
+using NexusReader.Application.Abstractions.Services;
+using NexusReader.Infrastructure.Configuration;
+using Markdig;
+
+namespace NexusReader.Infrastructure.Services;
+
+/// <summary>
+/// Infrastructure implementation of ISanitizerService using the Ganss.Xss HtmlSanitizer library.
+/// </summary>
+public class HtmlSanitizerService : ISanitizerService
+{
+    private readonly HtmlSanitizer _sanitizer;
+    private readonly MarkdownPipeline _pipeline;
+
+    public HtmlSanitizerService(IOptions<HtmlSanitizerSettings>? options = null)
+    {
+        _sanitizer = new HtmlSanitizer();
+        _pipeline = new MarkdownPipelineBuilder().UseAdvancedExtensions().Build();
+        
+        if (options?.Value != null)
+        {
+            var settings = options.Value;
+            
+            if (settings.AllowedTags != null && settings.AllowedTags.Count > 0)
+            {
+                _sanitizer.AllowedTags.Clear();
+                foreach (var tag in settings.AllowedTags)
+                {
+                    _sanitizer.AllowedTags.Add(tag);
+                }
+            }
+
+            if (settings.AllowedAttributes != null && settings.AllowedAttributes.Count > 0)
+            {
+                _sanitizer.AllowedAttributes.Clear();
+                foreach (var attr in settings.AllowedAttributes)
+                {
+                    _sanitizer.AllowedAttributes.Add(attr);
+                }
+            }
+
+            if (settings.AllowedCssProperties != null && settings.AllowedCssProperties.Count > 0)
+            {
+                _sanitizer.AllowedCssProperties.Clear();
+                foreach (var prop in settings.AllowedCssProperties)
+                {
+                    _sanitizer.AllowedCssProperties.Add(prop);
+                }
+            }
+
+            if (settings.AllowedSchemes != null && settings.AllowedSchemes.Count > 0)
+            {
+                _sanitizer.AllowedSchemes.Clear();
+                foreach (var scheme in settings.AllowedSchemes)
+                {
+                    _sanitizer.AllowedSchemes.Add(scheme);
+                }
+            }
+        }
+    }
+
+    public string Sanitize(string input)
+    {
+        if (string.IsNullOrEmpty(input))
+        {
+            return input;
+        }
+
+        // Translate raw Markdown input to HTML strictly before running HtmlSanitizer
+        var html = Markdown.ToHtml(input, _pipeline);
+
+        return _sanitizer.Sanitize(html).Trim();
+    }
+}

src/NexusReader.Infrastructure/Services/KnowledgeService.cs

@@ -4,6 +4,8 @@ using FluentResults;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.AI;
 using Microsoft.Extensions.Logging;
+using MediatR;
+using NexusReader.Application.Queries.Intelligence;
 using Microsoft.ML.Tokenizers;
 using NexusReader.Application.Abstractions.Services;
 using NexusReader.Application.DTOs.AI;
@@ -33,6 +35,7 @@ public class KnowledgeService : IKnowledgeService
     private readonly ILogger<KnowledgeService> _logger;
     private readonly QdrantClient _qdrantClient;
     private readonly IDriver _neo4jDriver;
+    private readonly IMediator _mediator;
     private const string PromptVersion = "1.7";
     private static readonly ConcurrentDictionary<string, Lazy<Task<Result<KnowledgePacket>>>> _activeRequests = new();
     private static readonly SemaphoreSlim _collectionSemaphore = new(1, 1);
@@ -45,7 +48,8 @@ public class KnowledgeService : IKnowledgeService
         IOptions<AiSettings> settings,
         ILogger<KnowledgeService> logger,
         QdrantClient qdrantClient,
-        IDriver neo4jDriver)
+        IDriver neo4jDriver,
+        IMediator mediator)
     {
         _chatClient = chatClient;
         _embeddingGenerator = embeddingGenerator;
@@ -55,6 +59,7 @@ public class KnowledgeService : IKnowledgeService
         _logger = logger;
         _qdrantClient = qdrantClient;
         _neo4jDriver = neo4jDriver;
+        _mediator = mediator;
         // Use Tiktoken (cl100k_base) which is a standard for modern LLMs and provides
         // a very reliable estimation for token usage in Gemini-based workloads.
         _tokenizer = TiktokenTokenizer.CreateForModel("gpt-4");
@@ -334,6 +339,17 @@ public class KnowledgeService : IKnowledgeService
         {
             try
             {
+                // Retrieve the book's title from the database using EF Core
+                string bookTitle = "Nieznana książka";
+                if (ebookId.HasValue)
+                {
+                    var ebook = await dbContext.Ebooks.FindAsync(new object[] { ebookId.Value }, cancellationToken);
+                    if (ebook != null)
+                    {
+                        bookTitle = ebook.Title;
+                    }
+                }
+
                 var contents = unitsToEmbed.Select(u => u.Content).ToList();
                 
                 var embeddingResponse = await _retryPipeline.ExecuteAsync(async ct => 
@@ -350,6 +366,12 @@ public class KnowledgeService : IKnowledgeService
                     var unitDto = unitsToEmbed[i];
                     var vector = embeddings[i].Vector.ToArray();
 
+                    string chapterTitle = "Wiedza z rozdziału";
+                    if (unitDto.Metadata != null && unitDto.Metadata.TryGetValue("label", out var labelVal) && labelVal is string labelStr)
+                    {
+                        chapterTitle = labelStr;
+                    }
+
                     var point = new PointStruct
                     {
                         Id = GetDeterministicGuid(unitDto.Id),
@@ -360,6 +382,8 @@ public class KnowledgeService : IKnowledgeService
                             ["type"] = unitDto.Type ?? string.Empty,
                             ["tenantId"] = tenantId,
                             ["ebookId"] = ebookId?.ToString() ?? string.Empty,
+                            ["bookTitle"] = bookTitle,
+                            ["chapterTitle"] = chapterTitle,
                             ["metadataJson"] = JsonSerializer.Serialize(unitDto.Metadata)
                         }
                     };
@@ -1187,6 +1211,12 @@ public class KnowledgeService : IKnowledgeService
         }
     }
 
+    /// <inheritdoc />
+    public async Task<Result<IntelligenceResponse>> GetGlobalIntelligenceAsync(string queryText, string userId, string tenantId, CancellationToken cancellationToken = default)
+    {
+        return await _mediator.Send(new GetGlobalIntelligenceQuery(queryText, userId, tenantId), cancellationToken);
+    }
+
     private int EstimateTokenCount(string text)
     {
         if (string.IsNullOrEmpty(text)) return 0;

src/NexusReader.Infrastructure/Services/LocalStorageService.cs

@@ -0,0 +1,58 @@
+using Microsoft.AspNetCore.Hosting;
+using NexusReader.Application.Abstractions.Services;
+
+namespace NexusReader.Infrastructure.Services;
+
+/// <summary>
+/// Infrastructure implementation of general storage utilizing local filesystem.
+/// Files are saved in wwwroot/uploads/media.
+/// </summary>
+public class LocalStorageService : IStorageService
+{
+    private readonly IWebHostEnvironment _environment;
+
+    public LocalStorageService(IWebHostEnvironment environment)
+    {
+        _environment = environment;
+    }
+
+    public async Task<string> UploadFileAsync(byte[] fileBytes, string fileName, string contentType)
+    {
+        using var stream = new MemoryStream(fileBytes);
+        return await UploadFileAsync(stream, fileName, contentType);
+    }
+
+    public async Task<string> UploadFileAsync(Stream fileStream, string fileName, string contentType)
+    {
+        var mediaFolder = Path.Combine(_environment.WebRootPath, "uploads");
+        var resolvedMediaFolder = Path.GetFullPath(mediaFolder);
+        var folderWithSeparator = resolvedMediaFolder.EndsWith(Path.DirectorySeparatorChar)
+            ? resolvedMediaFolder
+            : resolvedMediaFolder + Path.DirectorySeparatorChar;
+        
+        if (!Directory.Exists(resolvedMediaFolder))
+        {
+            Directory.CreateDirectory(resolvedMediaFolder);
+        }
+
+        // Clean file name to prevent path traversal issues
+        var safeFileName = Path.GetFileName(fileName);
+        var uniqueFileName = $"{Guid.NewGuid()}_{safeFileName}";
+        var filePath = Path.Combine(resolvedMediaFolder, uniqueFileName);
+        
+        // Guard against path traversal
+        var fullPath = Path.GetFullPath(filePath);
+        if (!fullPath.StartsWith(folderWithSeparator, StringComparison.OrdinalIgnoreCase))
+        {
+            throw new InvalidOperationException("Path traversal detected.");
+        }
+
+        using (var outputStream = new FileStream(fullPath, FileMode.Create))
+        {
+            await fileStream.CopyToAsync(outputStream);
+        }
+
+        // Return the public web-relative URL
+        return $"/uploads/{uniqueFileName}";
+    }
+}

src/NexusReader.Maui/MauiProgram.cs

@@ -8,6 +8,7 @@ using NexusReader.Application;
 using MediatR;
 using NexusReader.Maui.Infrastructure.Logging;
 using NexusReader.Maui.Infrastructure.Identity;
+using NexusReader.Maui.Services;
 
 namespace NexusReader.Maui;
 
@@ -44,7 +45,7 @@ public static class MauiProgram
 
 			// Minimal Infrastructure
 			builder.Services.AddSingleton<IPlatformService, MauiPlatformService>();
-			builder.Services.AddSingleton<INativeStorageService, MauiStorageService>();
+			builder.Services.AddSingleton<INativeStorageService, NexusReader.Infrastructure.Mobile.Services.MauiStorageService>();
 			
 			// Minimal Identity (Safe Mode)
 			builder.Services.AddScoped<NexusAuthenticationStateProvider>();
@@ -56,7 +57,7 @@ public static class MauiProgram
 			builder.Services.AddTransient<MobileAuthenticationHeaderHandler>();
 			builder.Services.AddHttpClient("NexusAPI", client =>
 			{
-				var apiBaseUrl = builder.Configuration["ApiSettings:BaseUrl"] ?? "http://localhost:5000";
+				var apiBaseUrl = builder.Configuration["ApiSettings:BaseUrl"] ?? "http://localhost:5104";
 				client.BaseAddress = new Uri(apiBaseUrl);
 			}).AddHttpMessageHandler<MobileAuthenticationHeaderHandler>();
 
@@ -67,13 +68,15 @@ public static class MauiProgram
 			var featureSettings = builder.Configuration.GetSection("Features").Get<FeatureSettings>() ?? new FeatureSettings();
 			builder.Services.AddSingleton(featureSettings);
 
-			builder.Services.AddScoped<IThemeService, ThemeService>();
+			builder.Services.AddSingleton<IUserPreferenceStore, MauiUserPreferenceStore>();
+			builder.Services.AddSingleton<IThemeService, ThemeService>();
 			builder.Services.AddScoped<IFocusModeService, FocusModeService>();
 			builder.Services.AddScoped<IQuizStateService, QuizStateService>();
 			builder.Services.AddScoped<IReaderNavigationService, ReaderNavigationService>();
 			builder.Services.AddScoped<IKnowledgeGraphService, KnowledgeGraphService>();
 			builder.Services.AddScoped<IReaderInteractionService, ReaderInteractionService>();
 			builder.Services.AddScoped<IReaderStateService, ReaderStateService>();
+			builder.Services.AddScoped<ILibraryStateService, LibraryStateService>();
 			builder.Services.AddScoped<KnowledgeCoordinator>();
 			builder.Services.AddScoped<ISyncService, SyncService>();
 			builder.Services.AddScoped<IIdentityService, IdentityService>();

src/NexusReader.Maui/Services/MauiUserPreferenceStore.cs

@@ -0,0 +1,61 @@
+using System.Net.Http;
+using System.Net.Http.Json;
+using FluentResults;
+using NexusReader.Application.DTOs.User;
+using NexusReader.Domain.Enums;
+using NexusReader.Application.Abstractions.Services;
+
+namespace NexusReader.Maui.Services;
+
+public class MauiUserPreferenceStore : IUserPreferenceStore
+{
+    private readonly IHttpClientFactory _httpClientFactory;
+
+    public MauiUserPreferenceStore(IHttpClientFactory httpClientFactory)
+    {
+        _httpClientFactory = httpClientFactory;
+    }
+
+    private HttpClient CreateClient() => _httpClientFactory.CreateClient("NexusAPI");
+
+    public async Task<Result> SaveThemePreferenceAsync(ThemeMode mode)
+    {
+        try
+        {
+            var client = CreateClient();
+            var response = await client.PostAsJsonAsync("identity/theme", new UpdateThemeRequest(mode));
+            if (response.IsSuccessStatusCode)
+            {
+                return Result.Ok();
+            }
+            
+            var error = await response.Content.ReadAsStringAsync();
+            return Result.Fail($"Failed to save cloud theme preference on mobile: {error}");
+        }
+        catch (Exception ex)
+        {
+            return Result.Fail(new Error("Network error saving mobile theme preference to cloud.").CausedBy(ex));
+        }
+    }
+
+    public async Task<Result<ThemeMode>> GetThemePreferenceAsync()
+    {
+        try
+        {
+            var client = CreateClient();
+            var response = await client.GetAsync("identity/profile");
+            if (response.IsSuccessStatusCode)
+            {
+                var profile = await response.Content.ReadFromJsonAsync<UserProfileDto>();
+                return profile != null 
+                    ? Result.Ok(profile.ThemePreference) 
+                    : Result.Fail("Failed to deserialize mobile profile response.");
+            }
+            return Result.Fail($"Failed to fetch theme preference from cloud on mobile: {response.ReasonPhrase}");
+        }
+        catch (Exception ex)
+        {
+            return Result.Fail(new Error("Network error retrieving theme preference on mobile.").CausedBy(ex));
+        }
+    }
+}

src/NexusReader.Maui/appsettings.json

@@ -1,6 +1,6 @@
 {
   "ApiSettings": {
-    "BaseUrl": "https://localhost:5000"
+    "BaseUrl": "http://localhost:5104"
   },
   "Serilog": {
     "Using": [

src/NexusReader.Maui/wwwroot/index.html

@@ -9,14 +9,29 @@
     <link rel="icon" type="image/png" href="favicon.png" />
     <script>
         (function () {
-            const savedTheme = localStorage.getItem('theme');
-            const systemPrefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-            const isLight = savedTheme === 'light' || (!savedTheme && !systemPrefersDark);
+            try {
+                var themeMode = localStorage.getItem('theme-mode');
+                var savedTheme = localStorage.getItem('theme');
+                var isLight = false;
+                
+                if (themeMode === '2' || savedTheme === 'light') {
+                    isLight = true;
+                } else if (themeMode === '1' || savedTheme === 'dark') {
+                    isLight = false;
+                } else {
+                    isLight = window.matchMedia && window.matchMedia('(prefers-color-scheme: light)').matches;
+                }
+                
                 if (isLight) {
                     document.documentElement.classList.add('theme-light');
+                    document.documentElement.classList.remove('theme-dark');
                 } else {
+                    document.documentElement.classList.add('theme-dark');
                     document.documentElement.classList.remove('theme-light');
                 }
+            } catch (e) {
+                // Fail silently
+            }
         })();
     </script>
 </head>

src/NexusReader.UI.Shared/Components/Atoms/NexusIcon.razor

@@ -101,6 +101,11 @@
                     <line x1="5" y1="12" x2="19" y2="12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
                     <polyline points="12 5 19 12 12 19" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
             break;
+        case "edit":
+        case "edit-2":
+                    <path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
+                    <path d="M18.5 2.5a2.121 2.121 0 1 1 3 3L12 15l-4 1 1-4 9.5-9.5z" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
+            break;
         case "log-out":
                     <path d="M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4M16 17l5-5-5-5M21 12H9" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
             break;

src/NexusReader.UI.Shared/Components/MarkdownEditor.razor

@@ -0,0 +1,559 @@
+@using Microsoft.JSInterop
+@implements IAsyncDisposable
+@inject IJSRuntime JS
+@inject HttpClient Http
+@inject NexusReader.Application.Abstractions.Services.INativeStorageService StorageService
+
+<div class="markdown-editor-container" style="height: @Height; width: @Width;">
+    @if (_showRestorationBanner)
+    {
+        <div class="restoration-banner">
+            <span class="banner-text">You have unsaved changes from an interrupted session.</span>
+            <div class="banner-actions">
+                <button type="button" class="banner-btn restore-btn" @onclick="RestoreBackupAsync">Restore</button>
+                <button type="button" class="banner-btn dismiss-btn" @onclick="DismissBackupAsync">Dismiss</button>
+            </div>
+        </div>
+    }
+    else
+    {
+        <div @key="_editorRenderKey" id="@EditorId" class="milkdown-editor-wrapper"></div>
+
+        <div class="editor-footer">
+            <div class="status-indicator">
+                <span class="status-dot @StatusClass"></span>
+                <span class="status-text">@StatusText</span>
+            </div>
+            @if (ShowFetchButton)
+            {
+                <div class="editor-actions">
+                    <button type="button" @onclick="FetchContentAsync" class="nexus-btn">
+                        Fetch Markdown Content
+                    </button>
+                </div>
+            }
+        </div>
+    }
+</div>
+
+@code {
+    private string EditorId { get; set; } = $"milkdown-editor-{Guid.NewGuid():N}";
+    private Guid _editorRenderKey = Guid.NewGuid();
+    private readonly CancellationTokenSource _cts = new();
+    private IJSObjectReference? _module;
+    private DotNetObjectReference<MarkdownEditor>? _dotNetHelper;
+    private string? _lastInitializedEditorId;
+    private bool _disposed;
+
+    private enum SaveStatus
+    {
+        SavedToCloud,
+        Saving,
+        OfflineLocalBackup
+    }
+
+    private SaveStatus _status = SaveStatus.SavedToCloud;
+    private string _currentMarkdown = string.Empty;
+    private CancellationTokenSource? _debounceCts;
+    private readonly object _timerLock = new();
+
+    private bool _showRestorationBanner = false;
+    private NexusReader.Application.DTOs.Media.LocalBackupEnvelope? _pendingBackup;
+    private bool _hasRunStorageInit = false;
+    private bool _reinitializeEditor = false;
+
+    private string StatusClass => _status switch
+    {
+        SaveStatus.SavedToCloud => "saved",
+        SaveStatus.Saving => "saving",
+        SaveStatus.OfflineLocalBackup => "offline",
+        _ => "saved"
+    };
+
+    private string StatusText => _status switch
+    {
+        SaveStatus.SavedToCloud => "Saved to Cloud",
+        SaveStatus.Saving => "Saving...",
+        SaveStatus.OfflineLocalBackup => "Offline - Local Backup Only",
+        _ => "Saved to Cloud"
+    };
+
+    [Parameter]
+    public bool ShowFetchButton { get; set; } = true;
+
+    [Parameter]
+    public string InitialMarkdown { get; set; } = string.Empty;
+
+    [Parameter]
+    public EventCallback<string> OnSave { get; set; }
+
+    [Parameter]
+    public string Height { get; set; } = "500px";
+
+    [Parameter]
+    public string Width { get; set; } = "100%";
+
+    [Parameter]
+    public Guid ChapterId { get; set; } = Guid.Empty;
+
+    [Parameter]
+    public DateTime? ServerTimestamp { get; set; }
+
+    protected override async Task OnInitializedAsync()
+    {
+        await base.OnInitializedAsync();
+        // Sweep keys and check restoration on init
+        await RunStorageSweepAndRestorationCheckAsync();
+    }
+
+    private Guid _prevChapterId = Guid.Empty;
+
+    protected override async Task OnParametersSetAsync()
+    {
+        await base.OnParametersSetAsync();
+        if (ChapterId != Guid.Empty && ChapterId != _prevChapterId)
+        {
+            _prevChapterId = ChapterId;
+            _hasRunStorageInit = false;
+            
+            if (_module != null)
+            {
+                try
+                {
+                    await _module.InvokeVoidAsync("destroyEditor", EditorId);
+                }
+                catch (Exception ex)
+                {
+                    Console.WriteLine($"[MarkdownEditor] Error destroying old editor on chapter switch: {ex.Message}");
+                }
+            }
+
+            _reinitializeEditor = true;
+            EditorId = $"milkdown-editor-{Guid.NewGuid():N}";
+            _editorRenderKey = Guid.NewGuid();
+
+            await RunStorageSweepAndRestorationCheckAsync();
+        }
+    }
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        var shouldInit = (firstRender || _reinitializeEditor) && (EditorId != _lastInitializedEditorId);
+        if (shouldInit)
+        {
+            _reinitializeEditor = false;
+            _lastInitializedEditorId = EditorId; // Set immediately before any async yield to prevent concurrent triggers
+
+            if (firstRender)
+            {
+                _dotNetHelper = DotNetObjectReference.Create(this);
+                // Retry if deferred during prerendering OnInitializedAsync
+                await RunStorageSweepAndRestorationCheckAsync();
+            }
+
+            try
+            {
+                if (_module == null)
+                {
+                    _module = await JS.InvokeAsync<IJSObjectReference>(
+                        "import", 
+                        $"./_content/NexusReader.UI.Shared/js/milkdownWrapper.js?v={Guid.NewGuid():N}"
+                    );
+                }
+                await _module.InvokeVoidAsync("initEditor", EditorId, _dotNetHelper, InitialMarkdown);
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"[MarkdownEditor] Error initializing Milkdown editor: {ex.Message}");
+            }
+        }
+    }
+
+    private async Task RunStorageSweepAndRestorationCheckAsync()
+    {
+        if (_hasRunStorageInit) return;
+
+        try
+        {
+            _hasRunStorageInit = true;
+
+            // Import wrapper module if not already loaded to access helper
+            if (_module == null)
+            {
+                _module = await JS.InvokeAsync<IJSObjectReference>(
+                    "import", 
+                    $"./_content/NexusReader.UI.Shared/js/milkdownWrapper.js?v={Guid.NewGuid():N}"
+                );
+            }
+
+            // Sweep and filter backup keys defensively
+            var keys = await _module.InvokeAsync<List<string>>("getBackupKeys");
+            if (keys != null)
+            {
+                var now = DateTime.UtcNow;
+                foreach (var key in keys)
+                {
+                    // Strict defensive check before doing any JSON deserialization
+                    if (!key.StartsWith("nexus-bkp-")) continue;
+
+                    try
+                    {
+                        var backupResult = await StorageService.GetStringAsync(key);
+                        if (backupResult.IsSuccess && !string.IsNullOrEmpty(backupResult.Value))
+                        {
+                            var envelope = System.Text.Json.JsonSerializer.Deserialize<NexusReader.Application.DTOs.Media.LocalBackupEnvelope>(
+                                backupResult.Value, 
+                                NexusReader.Application.Common.AppJsonContext.Default.LocalBackupEnvelope
+                            );
+                            if (envelope != null)
+                            {
+                                // Remove expired backups
+                                if ((now - envelope.Timestamp).TotalDays > 7)
+                                {
+                                    await StorageService.RemoveAsync(key);
+                                    Console.WriteLine($"[MarkdownEditor] Boot-up Eviction: Deleted expired backup key {key}");
+                                }
+                            }
+                        }
+                    }
+                    catch (Exception ex)
+                    {
+                        Console.WriteLine($"[MarkdownEditor] Error sweeping key {key}: {ex.Message}");
+                    }
+                }
+            }
+
+            // Restoration guard for this specific Chapter ID
+            var currentBackupKey = $"nexus-bkp-{ChapterId}";
+            var currentBackupResult = await StorageService.GetStringAsync(currentBackupKey);
+            if (currentBackupResult.IsSuccess && !string.IsNullOrEmpty(currentBackupResult.Value))
+            {
+                var envelope = System.Text.Json.JsonSerializer.Deserialize<NexusReader.Application.DTOs.Media.LocalBackupEnvelope>(
+                    currentBackupResult.Value, 
+                    NexusReader.Application.Common.AppJsonContext.Default.LocalBackupEnvelope
+                );
+                if (envelope != null)
+                {
+                    var serverTime = ServerTimestamp ?? DateTime.MinValue;
+                    if (envelope.Timestamp > serverTime && envelope.MarkdownContent != InitialMarkdown)
+                    {
+                        _pendingBackup = envelope;
+                        _showRestorationBanner = true;
+                        StateHasChanged();
+                    }
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            _hasRunStorageInit = false; // Reset to allow retry on client render
+            Console.WriteLine($"[MarkdownEditor] Storage initialization deferred/failed: {ex.Message}");
+        }
+    }
+
+    private async Task RestoreBackupAsync()
+    {
+        if (_pendingBackup != null)
+        {
+            if (_module != null)
+            {
+                try
+                {
+                    // Prevent memory leak by cleaning up old instance in JS
+                    await _module.InvokeVoidAsync("destroyEditor", EditorId);
+                }
+                catch (Exception ex)
+                {
+                    Console.WriteLine($"[MarkdownEditor] Error destroying old editor during restore: {ex.Message}");
+                }
+            }
+
+            InitialMarkdown = _pendingBackup.MarkdownContent;
+            _showRestorationBanner = false;
+            _pendingBackup = null;
+
+            // Regenerate render key and ID to trigger clean Blazor element-level re-initialization
+            _reinitializeEditor = true;
+            EditorId = $"milkdown-editor-{Guid.NewGuid():N}";
+            _editorRenderKey = Guid.NewGuid();
+
+            // Trigger an immediate background API autosave to synchronize the database with the restored content
+            _ = TriggerAutosaveAsync(InitialMarkdown, _cts.Token);
+
+            StateHasChanged();
+        }
+    }
+
+    private async Task DismissBackupAsync()
+    {
+        _showRestorationBanner = false;
+        _pendingBackup = null;
+        try
+        {
+            await StorageService.RemoveAsync($"nexus-bkp-{ChapterId}");
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[MarkdownEditor] Failed to dismiss backup from LocalStorage: {ex.Message}");
+        }
+        StateHasChanged();
+    }
+
+    public async Task FetchContentAsync()
+    {
+        if (_module is not null)
+        {
+            try
+            {
+                var markdown = await _module.InvokeAsync<string>("getMarkdownContent", EditorId);
+                
+                if (OnSave.HasDelegate)
+                {
+                    await OnSave.InvokeAsync(markdown);
+                }
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"[MarkdownEditor] Error fetching markdown content: {ex.Message}");
+            }
+        }
+    }
+
+    [JSInvokable]
+    public async Task OnEditorContentChanged(string currentMarkdown)
+    {
+        _currentMarkdown = currentMarkdown;
+
+        // Structured JSON Envelope Pattern
+        var envelope = new NexusReader.Application.DTOs.Media.LocalBackupEnvelope
+        {
+            ChapterId = ChapterId,
+            Timestamp = DateTime.UtcNow,
+            MarkdownContent = currentMarkdown
+        };
+
+        try
+        {
+            var envelopeJson = System.Text.Json.JsonSerializer.Serialize(
+                envelope, 
+                NexusReader.Application.Common.AppJsonContext.Default.LocalBackupEnvelope
+            );
+            await StorageService.SaveStringAsync($"nexus-bkp-{ChapterId}", envelopeJson);
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[MarkdownEditor] Failed to save backup to LocalStorage: {ex.Message}");
+        }
+
+        // Status indicator to Offline - Local Backup Only
+        _status = SaveStatus.OfflineLocalBackup;
+        await InvokeAsync(StateHasChanged);
+
+        // Cancel pending timers thread-safely
+        CancellationTokenSource? ctsToCancel = null;
+        CancellationToken token;
+        lock (_timerLock)
+        {
+            if (_debounceCts != null)
+            {
+                ctsToCancel = _debounceCts;
+                _debounceCts = null;
+            }
+            _debounceCts = new CancellationTokenSource();
+            token = _debounceCts.Token; // Capture token synchronously under lock on UI thread
+        }
+
+        if (ctsToCancel != null)
+        {
+            try
+            {
+                await ctsToCancel.CancelAsync();
+                ctsToCancel.Dispose();
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"[MarkdownEditor] Error cancelling debounce timer: {ex.Message}");
+            }
+        }
+
+        // Start 5-second idle debounce timer
+        _ = Task.Run(async () =>
+        {
+            try
+            {
+                await Task.Delay(5000, token);
+                await TriggerAutosaveAsync(currentMarkdown, token);
+            }
+            catch (TaskCanceledException)
+            {
+                // Task cancelled on new keystroke
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"[MarkdownEditor] Debounce timer exception: {ex.Message}");
+            }
+        });
+    }
+
+    private async Task TriggerAutosaveAsync(string markdown, CancellationToken token)
+    {
+        if (token.IsCancellationRequested || _disposed) return;
+
+        _status = SaveStatus.Saving;
+        await InvokeAsync(StateHasChanged);
+
+        try
+        {
+            var request = new NexusReader.Application.DTOs.Media.AutosaveChapterRequest(markdown);
+            var response = await Http.PutAsJsonAsync(
+                $"/api/chapters/{ChapterId}/autosave", 
+                request, 
+                NexusReader.Application.Common.AppJsonContext.Default.AutosaveChapterRequest, 
+                token
+            );
+
+            if (_disposed) return;
+
+            if (response.IsSuccessStatusCode)
+            {
+                // Purge LocalStorage backup key on HTTP success
+                await StorageService.RemoveAsync($"nexus-bkp-{ChapterId}");
+                _status = SaveStatus.SavedToCloud;
+            }
+            else
+            {
+                _status = SaveStatus.OfflineLocalBackup;
+                var errorMsg = await response.Content.ReadAsStringAsync(token);
+                Console.WriteLine($"[MarkdownEditor] Autosave HTTP error: {response.StatusCode} - {errorMsg}");
+            }
+        }
+        catch (Exception ex)
+        {
+            if (_disposed) return;
+            _status = SaveStatus.OfflineLocalBackup;
+            Console.WriteLine($"[MarkdownEditor] Autosave HTTP exception: {ex.Message}");
+        }
+
+        if (_disposed) return;
+        await InvokeAsync(StateHasChanged);
+    }
+
+    [JSInvokable]
+    public async Task<string> UploadImageFromJs(string filename, string contentType, IJSStreamReference streamRef)
+    {
+        try
+        {
+            const long maxFileSize = 5 * 1024 * 1024; // 5MB limit
+            using var stream = await streamRef.OpenReadStreamAsync(maxFileSize, _cts.Token);
+            using var memoryStream = new MemoryStream();
+            await stream.CopyToAsync(memoryStream, _cts.Token);
+            var fileBytes = memoryStream.ToArray();
+
+            using var content = new MultipartFormDataContent();
+            using var fileContent = new ByteArrayContent(fileBytes);
+            fileContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue(contentType);
+            content.Add(fileContent, "file", filename);
+
+            var response = await Http.PostAsync("/api/media/upload", content, _cts.Token);
+            if (response.IsSuccessStatusCode)
+            {
+                var result = await response.Content.ReadFromJsonAsync<NexusReader.Application.DTOs.Media.UploadResultDto>(
+                    NexusReader.Application.Common.AppJsonContext.Default.UploadResultDto, _cts.Token);
+                return result?.Url ?? "https://placehold.co/600x400?text=Upload+Failed";
+            }
+            else
+            {
+                var errorMsg = await response.Content.ReadAsStringAsync(_cts.Token);
+                Console.WriteLine($"[MarkdownEditor] Image upload failed: {response.StatusCode} - {errorMsg}");
+                return "https://placehold.co/600x400?text=Upload+Failed";
+            }
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[MarkdownEditor] Exception during image upload: {ex.Message}");
+            return "https://placehold.co/600x400?text=Upload+Failed";
+        }
+    }
+
+    public async ValueTask DisposeAsync()
+    {
+        _disposed = true;
+        try
+        {
+            _cts.Cancel();
+            _cts.Dispose();
+        }
+        catch
+        {
+            // Fail silently
+        }
+
+        CancellationTokenSource? ctsToCancel = null;
+        lock (_timerLock)
+        {
+            if (_debounceCts != null)
+            {
+                ctsToCancel = _debounceCts;
+                _debounceCts = null;
+            }
+        }
+
+        if (ctsToCancel != null)
+        {
+            try
+            {
+                ctsToCancel.Cancel();
+                ctsToCancel.Dispose();
+            }
+            catch
+            {
+                // Fail silently
+            }
+        }
+
+        try
+        {
+            // Always try to destroy via global window registration first to handle null _module
+            await JS.InvokeVoidAsync("milkdownWrapper.destroyEditor", EditorId);
+        }
+        catch
+        {
+            // Fallback to module if global is not set
+            if (_module is not null)
+            {
+                try
+                {
+                    await _module.InvokeVoidAsync("destroyEditor", EditorId);
+                }
+                catch
+                {
+                    // Fail silently
+                }
+            }
+        }
+
+        try
+        {
+            if (_module is not null)
+            {
+                await _module.DisposeAsync();
+            }
+        }
+        catch (JSDisconnectedException)
+        {
+            // Fail silently during circuit disconnection
+        }
+        catch (ObjectDisposedException)
+        {
+            // Fail silently if JS runtime/module is already disposed
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[MarkdownEditor] Unexpected error during JS cleanup: {ex.Message}");
+        }
+        finally
+        {
+            _dotNetHelper?.Dispose();
+        }
+    }
+}

src/NexusReader.UI.Shared/Components/MarkdownEditor.razor.css

@@ -0,0 +1,197 @@
+.markdown-editor-container {
+    display: flex;
+    flex-direction: column;
+    gap: 1rem;
+}
+
+.milkdown-editor-wrapper {
+    flex: 1;
+    border: 1px solid var(--border);
+    border-radius: var(--radius-md);
+    background: var(--bg-surface);
+    overflow: auto;
+    padding: 1.5rem;
+    position: relative;
+    transition: border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.milkdown-editor-wrapper:focus-within {
+    border-color: var(--accent);
+    box-shadow: 0 0 0 1px var(--accent-glow);
+}
+
+.editor-actions {
+    display: flex;
+    justify-content: flex-end;
+}
+
+/* 3. Bypassing Blazor CSS Isolation for Dynamic JS DOMs using ::deep */
+::deep .milkdown-editor-wrapper .crepe {
+    max-width: 100% !important;
+}
+
+::deep .milkdown-editor-wrapper .milkdown {
+    background-color: var(--bg-surface) !important;
+    color: var(--text-main) !important;
+    font-family: var(--nexus-font-sans) !important;
+    border: none !important;
+    box-shadow: none !important;
+    
+    /* Map Crepe's internal variables to our design tokens */
+    --crepe-color-background: var(--bg-surface);
+    --crepe-color-on-background: var(--text-main);
+    --crepe-color-surface: rgba(255, 255, 255, 0.03);
+    --crepe-color-surface-low: rgba(255, 255, 255, 0.01);
+    --crepe-color-primary: var(--accent);
+    --crepe-color-outline: var(--border);
+}
+
+::deep .milkdown-editor-wrapper .milkdown .editor {
+    color: var(--text-main) !important;
+    background: transparent !important;
+    outline: none !important;
+    padding: 0.5rem 0 !important;
+    min-height: 200px;
+}
+
+/* Style the buttons using variables from app.css */
+.nexus-btn {
+    font-family: var(--nexus-font-sans);
+    font-weight: 600;
+    border-radius: var(--radius-md);
+    transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.5rem;
+    border: none;
+    text-decoration: none;
+    background: var(--nexus-neon);
+    color: #000000;
+    padding: 8px 16px;
+    font-size: 0.9rem;
+    min-height: 36px;
+}
+
+.nexus-btn:hover {
+    transform: translateY(-2px);
+    filter: brightness(1.1);
+    box-shadow: 0 4px 15px var(--nexus-primary-glow);
+}
+
+.nexus-btn:focus-visible {
+    outline: 2px solid var(--accent);
+    outline-offset: 2px;
+}
+
+/* Stateful Status Indicator Footer */
+.editor-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 0.5rem 1rem;
+    background: var(--bg-surface-low, rgba(255, 255, 255, 0.02));
+    border-radius: var(--radius-sm, 6px);
+    border: 1px solid var(--border);
+    margin-top: -0.5rem;
+}
+
+.status-indicator {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    font-size: 0.8rem;
+    font-weight: 500;
+    color: var(--text-muted, #888888);
+}
+
+.status-dot {
+    width: 8px;
+    height: 8px;
+    border-radius: 50%;
+    display: inline-block;
+    position: relative;
+    box-shadow: 0 0 8px currentColor;
+}
+
+.status-dot.saved {
+    color: #10B981; /* Green */
+    background-color: #10B981;
+}
+
+.status-dot.saving {
+    color: #F59E0B; /* Amber */
+    background-color: #F59E0B;
+    animation: status-pulse 1s infinite alternate;
+}
+
+.status-dot.offline {
+    color: #EF4444; /* Red */
+    background-color: #EF4444;
+}
+
+/* Orange Restoration Warning Banner */
+.restoration-banner {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 0.75rem 1.25rem;
+    background: rgba(245, 158, 11, 0.1);
+    border: 1px solid rgba(245, 158, 11, 0.3);
+    border-radius: var(--radius-md, 8px);
+    color: var(--text-main);
+    font-size: 0.9rem;
+    gap: 1rem;
+    margin-bottom: 0.75rem;
+    animation: banner-fadeIn 0.3s ease-out;
+}
+
+.banner-text {
+    font-weight: 500;
+}
+
+.banner-actions {
+    display: flex;
+    gap: 0.75rem;
+}
+
+.banner-btn {
+    padding: 6px 12px;
+    border-radius: var(--radius-sm, 4px);
+    font-weight: 600;
+    font-size: 0.8rem;
+    cursor: pointer;
+    border: none;
+    transition: all 0.2s ease;
+}
+
+.restore-btn {
+    background: #F59E0B;
+    color: #000;
+}
+
+.restore-btn:hover {
+    background: #D97706;
+    transform: translateY(-1px);
+}
+
+.dismiss-btn {
+    background: transparent;
+    border: 1px solid var(--border);
+    color: var(--text-main);
+}
+
+.dismiss-btn:hover {
+    background: rgba(255, 255, 255, 0.05);
+}
+
+@keyframes status-pulse {
+    0% { opacity: 0.4; transform: scale(0.9); }
+    100% { opacity: 1; transform: scale(1.1); }
+}
+
+@keyframes banner-fadeIn {
+    from { opacity: 0; transform: translateY(-5px); }
+    to { opacity: 1; transform: translateY(0); }
+}

src/NexusReader.UI.Shared/Components/Molecules/AiAssistantBubble.razor

@@ -1,7 +1,9 @@
 @using NexusReader.UI.Shared.Services
 @using NexusReader.Application.DTOs.AI
+@using Microsoft.Extensions.Logging
 @inject IQuizStateService QuizState
 @inject KnowledgeCoordinator Coordinator
+@inject ILogger<AiAssistantBubble> Logger
 @implements IDisposable
 
 <div class="ai-bubble-container">
@@ -134,7 +136,7 @@
         catch (Exception ex)
         {
             _displayedText = string.IsNullOrEmpty(Dialogue) ? "Błąd analizy." : Dialogue;
-            Console.WriteLine($"[AiAssistantBubble] Error fetching summary: {ex.Message}");
+            Logger.LogError(ex, "[AiAssistantBubble] Error fetching summary for block {BlockId}.", ContextBlockId);
         }
         finally
         {

src/NexusReader.UI.Shared/Components/Molecules/AiResponseRenderer.razor

@@ -0,0 +1,279 @@
+@using NexusReader.UI.Shared.Models
+@using NexusReader.UI.Shared.Services
+@using NexusReader.Application.DTOs.AI
+@using NexusReader.Application.DTOs.User
+@using Microsoft.Extensions.Logging
+@using System.Net.Http.Json
+@inject HttpClient Http
+@inject ILibraryStateService LibraryStateService
+@inject NavigationManager NavigationManager
+@inject ILogger<AiResponseRenderer> Logger
+
+<div class="message-row @(Message.Sender == "User" ? "user-row" : "ai-row")">
+    <div class="message-avatar" aria-hidden="true">
+        @if (Message.Sender == "User")
+        {
+            <i class="bi bi-person-fill"></i>
+        }
+        else
+        {
+            <i class="bi bi-robot"></i>
+        }
+    </div>
+    
+    <div class="message-bubble @GetBubbleClass()">
+        <div class="message-header">
+            <span class="sender-name">@Message.Sender</span>
+            <span class="message-time">@Message.Timestamp.ToString("HH:mm")</span>
+        </div>
+        
+        <div class="message-content">
+            @if (Message.Sender == "User")
+            {
+                <p>@Message.Text</p>
+            }
+            else
+            {
+                @if (_hasPaywall)
+                {
+                    <div class="paywall-teaser" aria-hidden="true">
+                        @foreach (var segment in ParseSegments(_displayTeaserText))
+                        {
+                            @if (segment.IsCitation)
+                            {
+                                <NexusCitationMarker SourceId="@segment.CitationId" Citations="@Message.Citations" />
+                            }
+                            else
+                            {
+                                @RenderMarkdown(segment.Text)
+                            }
+                        }
+                    </div>
+                    
+                    <div class="upsell-card" role="alert" aria-live="polite">
+                        <div class="upsell-header">
+                            <span class="upsell-icon" aria-hidden="true">🔒</span>
+                            <h4>Dostęp Premium Zablokowany</h4>
+                        </div>
+                        
+                        <p class="upsell-text">
+                            Twoje zasoby odpowiadają na to pytanie w <strong>@_localScore%</strong>. W materiale <strong>'@_lockedBookTitle'</strong> znaleźliśmy odpowiedź dopasowaną w <strong>@_globalScore%</strong>.
+                        </p>
+                        
+                        <div class="upsell-actions">
+                            @if (_isSimulatingPayment)
+                            {
+                                <button class="btn-upsell btn-primary loading" disabled aria-busy="true">
+                                    <div class="payment-spinner" aria-hidden="true"></div>
+                                    PRZETWARZANIE PŁATNOŚCI...
+                                </button>
+                            }
+                            else
+                            {
+                                <button class="btn-upsell btn-primary" @onclick="HandlePurchase">
+                                    ODBLOKUJ PEŁNĄ TREŚĆ (29 PLN)
+                                </button>
+                            }
+                            <a href="/catalog?bookId=@_lockedBookId" class="btn-upsell btn-secondary">
+                                Zobacz szczegóły w Katalogu
+                            </a>
+                        </div>
+                    </div>
+                }
+                else
+                {
+                    <div class="full-response">
+                        @foreach (var segment in ParseSegments(GetCleanText()))
+                        {
+                            @if (segment.IsCitation)
+                            {
+                                <NexusCitationMarker SourceId="@segment.CitationId" Citations="@Message.Citations" />
+                            }
+                            else
+                            {
+                                @RenderMarkdown(segment.Text)
+                            }
+                        }
+                    </div>
+                    
+                    @if (_showSuccessBanner)
+                    {
+                        <div class="success-unlock-banner" role="status">
+                            <span class="success-icon" aria-hidden="true">✓</span>
+                            <span>Odblokowano pełną odpowiedź! Książka została dodana do Twojej biblioteki.</span>
+                        </div>
+                    }
+                }
+            }
+        </div>
+    </div>
+</div>
+
+@code {
+    [Parameter] public ChatMessage Message { get; set; } = default!;
+    [Parameter] public List<LastReadBookDto>? OwnedBooks { get; set; }
+    [Parameter] public EventCallback<Guid> OnUnlockRequested { get; set; }
+
+    private bool _hasPaywall;
+    private string _displayTeaserText = string.Empty;
+    private Guid _lockedBookId;
+    private string _lockedBookTitle = string.Empty;
+    private int _localScore;
+    private int _globalScore;
+
+    private bool _isUnlocked = false;
+    private bool _isSimulatingPayment = false;
+    private bool _showSuccessBanner = false;
+
+    protected override void OnParametersSet()
+    {
+        base.OnParametersSet();
+        
+        if (Message != null && Message.Sender != "User" && !_isUnlocked)
+        {
+            _hasPaywall = PaywallParser.TryParsePaywallTrigger(Message.Text, out _displayTeaserText, out _lockedBookId, out _lockedBookTitle, out _localScore, out _globalScore);
+            
+            // Additional check: if user already owns the book, don't show the paywall
+            if (_hasPaywall && OwnedBooks != null)
+            {
+                var isOwned = OwnedBooks.Any(b => 
+                    b.Id == _lockedBookId || 
+                    (!string.IsNullOrEmpty(b.Title) && b.Title.Equals(_lockedBookTitle, StringComparison.OrdinalIgnoreCase)));
+                if (isOwned)
+                {
+                    _hasPaywall = false;
+                }
+            }
+        }
+        else
+        {
+            _hasPaywall = false;
+        }
+    }
+
+    private string GetCleanText()
+    {
+        if (Message == null) return string.Empty;
+        if (PaywallParser.TryParsePaywallTrigger(Message.Text, out var cleanText, out _, out _, out _, out _))
+        {
+            return cleanText;
+        }
+        return Message.Text;
+    }
+
+    private string GetBubbleClass()
+    {
+        if (Message.Sender == "User") return "user-bubble";
+        return _hasPaywall ? "ai-bubble paywalled-bubble" : "ai-bubble";
+    }
+
+    private async Task HandlePurchase()
+    {
+        if (_isSimulatingPayment) return;
+        
+        _isSimulatingPayment = true;
+        StateHasChanged();
+
+        // Simulate payment gateway delay (1.5 seconds)
+        await Task.Delay(1500);
+
+        try
+        {
+            var bookTitle = string.IsNullOrEmpty(_lockedBookTitle) 
+                ? "Architektura .NET 10 i Ekosystem Blazor" 
+                : _lockedBookTitle;
+
+            // Call POST endpoint to persist the purchase
+            var response = await Http.PostAsJsonAsync("api/library/purchase", new { Title = bookTitle });
+            if (response.IsSuccessStatusCode)
+            {
+                _isUnlocked = true;
+                _hasPaywall = false;
+                _showSuccessBanner = true;
+                
+                // Fetch updated library list and update state manager
+                var updatedBooks = await Http.GetFromJsonAsync<List<LastReadBookDto>>("api/library/books");
+                LibraryStateService.OwnedBooks = updatedBooks;
+
+                if (OnUnlockRequested.HasDelegate)
+                {
+                    await OnUnlockRequested.InvokeAsync(_lockedBookId);
+                }
+            }
+            else
+            {
+                Logger.LogWarning("[AiResponseRenderer] Purchase failed on server for book {BookId}.", _lockedBookId);
+            }
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "[AiResponseRenderer] Error processing purchase for book {BookId}.", _lockedBookId);
+        }
+        finally
+        {
+            _isSimulatingPayment = false;
+            StateHasChanged();
+        }
+    }
+
+    private List<ResponseSegment> ParseSegments(string text)
+    {
+        var segments = new List<ResponseSegment>();
+        if (string.IsNullOrEmpty(text)) return segments;
+
+        var regex = new System.Text.RegularExpressions.Regex(
+            @"\[Source ID:\s*([^\]]+)\]|\[([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})\]", 
+            System.Text.RegularExpressions.RegexOptions.IgnoreCase);
+        var matches = regex.Matches(text);
+
+        int lastIndex = 0;
+        foreach (System.Text.RegularExpressions.Match match in matches)
+        {
+            if (match.Index > lastIndex)
+            {
+                segments.Add(new ResponseSegment
+                {
+                    Text = text.Substring(lastIndex, match.Index - lastIndex),
+                    IsCitation = false
+                });
+            }
+
+            var citationId = match.Groups[1].Success 
+                ? match.Groups[1].Value.Trim() 
+                : match.Groups[2].Value.Trim();
+
+            segments.Add(new ResponseSegment
+            {
+                IsCitation = true,
+                CitationId = citationId
+            });
+
+            lastIndex = match.Index + match.Length;
+        }
+
+        if (lastIndex < text.Length)
+        {
+            segments.Add(new ResponseSegment
+            {
+                Text = text.Substring(lastIndex),
+                IsCitation = false
+            });
+        }
+
+        return segments;
+    }
+
+    private MarkupString RenderMarkdown(string text)
+    {
+        if (string.IsNullOrEmpty(text)) return new MarkupString(string.Empty);
+
+        var html = System.Net.WebUtility.HtmlEncode(text);
+        html = System.Text.RegularExpressions.Regex.Replace(html, @"\*\*(.*?)\*\*", "<strong>$1</strong>");
+        html = System.Text.RegularExpressions.Regex.Replace(html, @"\*(.*?)\*", "<em>$1</em>");
+        html = System.Text.RegularExpressions.Regex.Replace(html, @"```(?:[a-zA-Z0-9+#]+)?\s*([\s\S]*?)\s*```", "<pre class=\"nexus-code-block\"><code>$1</code></pre>");
+        html = System.Text.RegularExpressions.Regex.Replace(html, @"`(.*?)`", "<code class=\"nexus-inline-code\">$1</code>");
+        html = html.Replace("\n", "<br />");
+
+        return new MarkupString(html);
+    }
+}

src/NexusReader.UI.Shared/Components/Molecules/AiResponseRenderer.razor.css

@@ -0,0 +1,314 @@
+.message-row {
+    display: flex;
+    gap: 1rem;
+    width: 100%;
+    max-width: 90%;
+    margin-bottom: 1.5rem;
+    animation: bubble-fade-in 0.35s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+}
+
+.user-row {
+    align-self: flex-end;
+    margin-left: auto;
+    flex-direction: row-reverse;
+}
+
+.ai-row {
+    align-self: flex-start;
+    margin-right: auto;
+}
+
+.message-avatar {
+    width: 38px;
+    height: 38px;
+    border-radius: 50%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 1.1rem;
+    flex-shrink: 0;
+}
+
+.user-row .message-avatar {
+    background: var(--bg-surface);
+    color: var(--text-main);
+    border: 1px solid var(--border);
+    box-shadow: 0 0 10px var(--border);
+}
+
+.ai-row .message-avatar {
+    background: linear-gradient(135deg, #005f38 0%, #004024 100%);
+    color: #e6fffa;
+    border: 1px solid var(--accent);
+    box-shadow: 0 0 10px var(--accent-glow);
+}
+
+.message-bubble {
+    padding: 1.25rem 1.5rem;
+    border-radius: 16px;
+    position: relative;
+    line-height: 1.6;
+    font-size: 0.975rem;
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+}
+
+.user-bubble {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    color: var(--text-main);
+    border-top-right-radius: 4px;
+    box-shadow: 0 4px 20px rgba(0, 0, 0, 0.02);
+}
+
+.ai-bubble {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    color: var(--text-main);
+    border-top-left-radius: 4px;
+    box-shadow: 0 4px 25px rgba(0, 0, 0, 0.03);
+}
+
+.paywalled-bubble {
+    border-color: var(--accent-glow);
+}
+
+.message-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 0.75rem;
+    font-size: 0.75rem;
+    opacity: 0.6;
+}
+
+.sender-name {
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+.message-time {
+    font-family: monospace;
+}
+
+.message-content {
+    word-break: break-word;
+}
+
+/* Paragraph spacing */
+.message-content p {
+    margin: 0 0 1rem 0;
+}
+.message-content p:last-child {
+    margin-bottom: 0;
+}
+
+/* Paywall Blur Styles */
+.paywall-teaser {
+    position: relative;
+    margin-bottom: 1.5rem;
+    -webkit-mask-image: linear-gradient(to bottom, #000 30%, transparent 100%);
+    mask-image: linear-gradient(to bottom, #000 30%, transparent 100%);
+    filter: blur(2px);
+    pointer-events: none;
+    -webkit-user-select: none;
+    user-select: none;
+}
+
+/* Upsell Card */
+.upsell-card {
+    background: var(--bg-base);
+    border-radius: 12px;
+    border: 1px solid var(--accent-glow);
+    padding: 1.5rem;
+    margin-top: 1rem;
+    box-shadow: 0 8px 32px var(--accent-glow), 0 4px 12px var(--border);
+    animation: card-slide-in 0.4s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+}
+
+.upsell-header {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    margin-bottom: 0.75rem;
+}
+
+.upsell-icon {
+    font-size: 1.25rem;
+}
+
+.upsell-header h4 {
+    margin: 0;
+    color: var(--accent);
+    font-size: 1.1rem;
+    font-weight: 700;
+    letter-spacing: 0.5px;
+}
+
+.upsell-text {
+    color: var(--text-main);
+    font-size: 0.9rem;
+    line-height: 1.55;
+    margin: 0 0 1.25rem 0;
+}
+
+.upsell-actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 1rem;
+}
+
+.btn-upsell {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0.75rem 1.5rem;
+    font-size: 0.85rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    border-radius: 8px;
+    cursor: pointer;
+    transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+    text-decoration: none;
+    letter-spacing: 0.5px;
+    min-height: 44px;
+}
+
+.btn-primary {
+    background: var(--accent);
+    border: none;
+    color: var(--bg-surface);
+}
+
+.btn-primary:hover:not(:disabled) {
+    background: var(--accent);
+    opacity: 0.9;
+    transform: translateY(-2px);
+    box-shadow: 0 4px 15px var(--accent-glow);
+}
+
+.btn-primary:active:not(:disabled) {
+    transform: translateY(0);
+}
+
+.btn-primary:disabled {
+    background: var(--accent-glow);
+    color: var(--text-muted);
+    cursor: not-allowed;
+}
+
+.btn-secondary {
+    background: transparent;
+    border: 1px solid var(--accent);
+    color: var(--accent);
+}
+
+.btn-secondary:hover {
+    background: var(--accent-glow);
+    transform: translateY(-2px);
+}
+
+.btn-secondary:active {
+    transform: translateY(0);
+}
+
+/* Success Banner */
+.success-unlock-banner {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    background: var(--accent-glow);
+    border: 1px solid var(--accent);
+    color: var(--accent);
+    padding: 1rem;
+    border-radius: 8px;
+    margin-top: 1.25rem;
+    font-size: 0.9rem;
+    font-weight: 600;
+    animation: fade-in 0.5s ease-out;
+}
+
+.success-icon {
+    font-weight: bold;
+    font-size: 1.1rem;
+}
+
+/* Payment Spinner */
+.payment-spinner {
+    width: 16px;
+    height: 16px;
+    border: 2px solid var(--border);
+    border-top-color: var(--accent);
+    border-radius: 50%;
+    margin-right: 0.75rem;
+    animation: spin 0.8s linear infinite;
+}
+
+/* Keyframes */
+@keyframes bubble-fade-in {
+    0% { opacity: 0; transform: translateY(12px) scale(0.98); }
+    100% { opacity: 1; transform: translateY(0) scale(1); }
+}
+
+@keyframes card-slide-in {
+    0% { opacity: 0; transform: translateY(10px); }
+    100% { opacity: 1; transform: translateY(0); }
+}
+
+@keyframes fade-in {
+    from { opacity: 0; }
+    to { opacity: 1; }
+}
+
+@keyframes spin {
+    0% { transform: rotate(0deg); }
+    100% { transform: rotate(360deg); }
+}
+
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .ai-row .message-avatar {
+    background: linear-gradient(135deg, #10b981 0%, #059669 100%);
+    color: #ffffff;
+    border: 1px solid rgba(16, 185, 129, 0.2);
+    box-shadow: 0 2px 8px rgba(16, 185, 129, 0.15);
+}
+
+.theme-light .user-row .message-avatar {
+    box-shadow: 0 2px 8px rgba(139, 130, 115, 0.1);
+}
+
+.theme-light .upsell-card {
+    box-shadow: 0 8px 32px rgba(16, 185, 129, 0.08), 0 4px 12px rgba(0, 0, 0, 0.04);
+}
+
+.theme-light .btn-primary {
+    background: var(--accent);
+    color: #ffffff;
+}
+
+.theme-light .btn-primary:hover:not(:disabled) {
+    background: #059669;
+    color: #ffffff;
+    opacity: 1;
+    box-shadow: 0 4px 12px rgba(16, 185, 129, 0.15);
+}
+
+.theme-light .btn-secondary {
+    border-color: var(--accent);
+    color: var(--accent);
+}
+
+.theme-light .btn-secondary:hover {
+    background: rgba(16, 185, 129, 0.05);
+}
+
+.theme-light .paywall-teaser {
+    -webkit-mask-image: linear-gradient(to bottom, #000 30%, transparent 100%);
+    mask-image: linear-gradient(to bottom, #000 30%, transparent 100%);
+}
+

src/NexusReader.UI.Shared/Components/Molecules/IntelligenceToolbar.razor

@@ -1,10 +1,13 @@
 @using NexusReader.UI.Shared.Services
 @using NexusReader.Application.Abstractions.Services
+@using Microsoft.Extensions.Logging
+@using System.Linq
 @inject IFocusModeService FocusMode
 @inject IIdentityService IdentityService
 @inject NavigationManager NavigationManager
 @inject IThemeService ThemeService
 @inject IKnowledgeService KnowledgeService
+@inject ILogger<IntelligenceToolbar> Logger
 @implements IDisposable
 
 <aside class="intelligence-toolbar">
@@ -46,26 +49,30 @@
     protected override void OnInitialized()
     {
         FocusMode.OnFocusModeChanged += HandleUpdate;
-        ThemeService.OnThemeChanged += HandleThemeChangedAsync;
+        ThemeService.OnThemeChanged += HandleThemeChanged;
     }
 
     private async Task HandleClearCache()
     {
-        Console.WriteLine("[IntelligenceToolbar] Requesting cache clear...");
+        Logger.LogInformation("[IntelligenceToolbar] Requesting cache clear...");
         var result = await KnowledgeService.ClearCacheAsync();
         if (result.IsSuccess)
         {
-            Console.WriteLine("[IntelligenceToolbar] Cache cleared successfully!");
+            Logger.LogInformation("[IntelligenceToolbar] Cache cleared successfully.");
+        }
+        else
+        {
+            Logger.LogWarning("[IntelligenceToolbar] Cache clear failed: {Errors}", string.Join("; ", result.Errors.Select(e => e.Message)));
         }
     }
 
     private Task HandleUpdate() => InvokeAsync(StateHasChanged);
 
-    private Task HandleThemeChangedAsync() => InvokeAsync(StateHasChanged);
+    private void HandleThemeChanged(ThemeMode mode) => InvokeAsync(StateHasChanged);
 
     public void Dispose()
     {
         FocusMode.OnFocusModeChanged -= HandleUpdate;
-        ThemeService.OnThemeChanged -= HandleThemeChangedAsync;
+        ThemeService.OnThemeChanged -= HandleThemeChanged;
     }
 }

src/NexusReader.UI.Shared/Components/Molecules/SelectionAiPanel.razor

@@ -1,10 +1,12 @@
 @using NexusReader.UI.Shared.Services
 @using NexusReader.UI.Shared.Models
 @using NexusReader.Application.DTOs.AI
+@using Microsoft.Extensions.Logging
 @inject KnowledgeCoordinator Coordinator
 @inject IReaderInteractionService InteractionService
 @inject IQuizStateService QuizService
 @inject IJSRuntime JS
+@inject ILogger<SelectionAiPanel> Logger
 
 @if (IsVisible)
 {
@@ -64,7 +66,7 @@
 
     protected override void OnParametersSet()
     {
-        Console.WriteLine($"[SelectionAiPanel] Parameters set. SelectedText: {SelectedText.Length} chars, Coordinates: {Coordinates?.Top}");
+        Logger.LogDebug("[SelectionAiPanel] Parameters set. SelectedText: {Length} chars, Coordinates: {Top}", SelectedText.Length, Coordinates?.Top);
         
         if (Coordinates != _lastCoordinates)
         {
@@ -100,7 +102,7 @@
             }
             catch (Exception ex)
             {
-                Console.WriteLine($"[SelectionAiPanel] Error positioning toolbar: {ex.Message}");
+                Logger.LogWarning(ex, "[SelectionAiPanel] Error positioning toolbar.");
             }
         }
     }
@@ -133,7 +135,7 @@
         }
         catch (Exception ex)
         {
-            Console.WriteLine($"[SelectionAiPanel] Error requesting summary: {ex.Message}");
+            Logger.LogError(ex, "[SelectionAiPanel] Error requesting summary for block {BlockId}.", BlockId);
         }
         finally
         {
@@ -173,7 +175,7 @@
         }
         catch (Exception ex)
         {
-            Console.WriteLine($"[SelectionAiPanel] Error generating quiz: {ex.Message}");
+            Logger.LogError(ex, "[SelectionAiPanel] Error generating quiz for block {BlockId}.", BlockId);
         }
         finally
         {

src/NexusReader.UI.Shared/Components/Organisms/ConceptsMap.razor.css

@@ -233,3 +233,126 @@
 .lock-icon {
     color: rgba(255, 255, 255, 0.2);
 }
+
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .concepts-map::-webkit-scrollbar-thumb:hover {
+    background: var(--accent);
+}
+
+.theme-light .empty-map-state {
+    background: rgba(0, 0, 0, 0.01);
+    border-color: var(--border);
+    color: var(--text-muted);
+}
+
+.theme-light .empty-map-state .dim-icon {
+    color: var(--text-muted);
+    opacity: 0.4;
+}
+
+.theme-light .timeline-step:hover {
+    background: rgba(0, 0, 0, 0.02);
+}
+
+.theme-light .timeline-step.unlocked:hover {
+    border-color: rgba(16, 185, 129, 0.15);
+    box-shadow: 0 4px 20px rgba(16, 185, 129, 0.05);
+}
+
+.theme-light .timeline-step.selected {
+    background: rgba(16, 185, 129, 0.04);
+    border-color: var(--accent);
+    box-shadow: 0 0 12px rgba(16, 185, 129, 0.15);
+}
+
+.theme-light .node-circle {
+    background: var(--bg-surface);
+}
+
+.theme-light .unlocked .node-circle {
+    background: var(--bg-surface);
+    border-color: var(--accent);
+    color: var(--accent);
+    box-shadow: none;
+}
+
+.theme-light .locked .node-circle {
+    background: var(--bg-base);
+    border-color: var(--border);
+    color: var(--text-muted);
+}
+
+.theme-light .node-glow {
+    display: none;
+}
+
+.theme-light .track-active {
+    background: var(--accent);
+    box-shadow: none;
+}
+
+.theme-light .track-inactive {
+    background: var(--border);
+}
+
+.theme-light .node-content {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+}
+
+.theme-light .timeline-step.selected .node-content {
+    background: var(--bg-surface);
+    border-color: rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .segment-tag {
+    color: var(--text-muted);
+}
+
+.theme-light .unlocked .segment-tag {
+    color: var(--accent);
+}
+
+.theme-light .badge-unlocked {
+    background: rgba(16, 185, 129, 0.08);
+    color: var(--accent);
+    border-color: rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .badge-locked {
+    background: var(--bg-base);
+    color: var(--text-muted);
+    border-color: var(--border);
+}
+
+.theme-light .node-title {
+    color: var(--text-main);
+}
+
+.theme-light .timeline-step.unlocked:hover .node-title {
+    color: var(--accent);
+}
+
+.theme-light .locked .node-title {
+    color: var(--text-muted);
+}
+
+.theme-light .node-desc {
+    color: var(--text-muted);
+}
+
+.theme-light .locked .node-desc {
+    color: var(--text-muted);
+}
+
+.theme-light .check-icon {
+    color: var(--accent);
+}
+
+.theme-light .lock-icon {
+    color: var(--text-muted);
+}
+

src/NexusReader.UI.Shared/Components/Organisms/ContextualRecommendationsWidget.razor

@@ -0,0 +1,112 @@
+@using NexusReader.UI.Shared.Components.Atoms
+@using Microsoft.Extensions.Logging
+@inject IRecommendationService RecommendationService
+@inject NavigationManager NavigationManager
+@inject ILogger<ContextualRecommendationsWidget> Logger
+
+<section class="recommendations-panel glass-panel" aria-label="Kontekstowe rekomendacje">
+    <div class="panel-header">
+        <div class="header-left">
+            <NexusIcon Name="sparkles" Size="18" />
+            <h4>Odkryj Więcej</h4>
+        </div>
+        <span class="panel-badge">AI</span>
+    </div>
+
+    @if (_isLoading)
+    {
+        <div @key='"loading"' class="loading-state" role="status" aria-label="Ładowanie rekomendacji">
+            <div class="spinner-ring">
+                <div class="spinner-track"></div>
+                <div class="spinner-head"></div>
+            </div>
+            <span class="loading-label">Analizowanie kontekstu lektury…</span>
+        </div>
+    }
+    else if (_hasError)
+    {
+        <div @key='"error"' class="empty-state">
+            <NexusIcon Name="alert-circle" Size="32" />
+            <p>Nie udało się załadować rekomendacji.</p>
+        </div>
+    }
+    else if (_recommendations is null || _recommendations.Count == 0)
+    {
+        <div @key='"empty"' class="empty-state">
+            <NexusIcon Name="book-open" Size="32" />
+            <p>Zacznij czytać, aby odkryć powiązane tytuły.</p>
+        </div>
+    }
+    else
+    {
+        <ul @key='"list"' class="recommendations-list" role="list">
+            @foreach (var rec in _recommendations)
+            {
+                <li @key="rec.TargetBookId" class="recommendation-item @(rec.IsPremiumUpsell ? "premium" : "owned")"
+                    role="listitem">
+                    <div class="rec-content">
+                        <div class="rec-meta">
+                            <span class="match-badge" title="Dopasowanie semantyczne @rec.MatchPercentage%">
+                                @rec.MatchPercentage<span class="match-unit">%</span>
+                            </span>
+                            @if (rec.IsPremiumUpsell)
+                            {
+                                <span class="upsell-tag" aria-label="Książka premium">Premium</span>
+                            }
+                        </div>
+                        <p class="rec-book-title">@rec.BookTitle</p>
+                        <p class="rec-chapter-title">@rec.ChapterTitle</p>
+                    </div>
+                    <button class="rec-action-btn"
+                            @onclick="() => HandleRecommendationClick(rec)"
+                            aria-label="@(rec.IsPremiumUpsell ? "Kup " + rec.BookTitle : "Przejdź do " + rec.BookTitle)">
+                        <NexusIcon Name="@(rec.IsPremiumUpsell ? "shopping-cart" : "arrow-right")" Size="16" />
+                    </button>
+                </li>
+            }
+        </ul>
+    }
+</section>
+
+@code {
+    private List<RecommendationDto>? _recommendations;
+    private bool _isLoading = true;
+    private bool _hasError;
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadRecommendationsAsync();
+    }
+
+    private async Task LoadRecommendationsAsync()
+    {
+        _isLoading = true;
+        _hasError = false;
+
+        try
+        {
+            _recommendations = await RecommendationService.GetRecommendationsAsync();
+            if (_recommendations is null)
+            {
+                _hasError = true;
+                Logger.LogWarning("[ContextualRecommendationsWidget] RecommendationService returned null; displaying error state.");
+            }
+        }
+        finally
+        {
+            _isLoading = false;
+        }
+    }
+
+    private void HandleRecommendationClick(RecommendationDto rec)
+    {
+        if (rec.IsPremiumUpsell)
+        {
+            NavigationManager.NavigateTo($"/catalog?highlight={rec.TargetBookId}");
+        }
+        else
+        {
+            NavigationManager.NavigateTo($"/reader/{rec.TargetBookId}");
+        }
+    }
+}

src/NexusReader.UI.Shared/Components/Organisms/ContextualRecommendationsWidget.razor.css

@@ -0,0 +1,331 @@
+/* ContextualRecommendationsWidget.razor.css
+   Uses Nexus Design System tokens (--nexus-*) for consistency.
+*/
+
+.recommendations-panel {
+    width: 100%;
+    padding: 1.75rem;
+    margin-top: 2.5rem;
+    background: var(--nexus-surface, #1a1a1e);
+    border: 1px solid var(--nexus-border, rgba(255, 255, 255, 0.05));
+    border-radius: 12px;
+    transition: border-color 0.3s ease, box-shadow 0.3s ease;
+}
+
+.recommendations-panel:hover {
+    border-color: rgba(16, 185, 129, 0.2);
+    box-shadow: 0 8px 24px rgba(0, 0, 0, 0.25);
+}
+
+/* ── Panel Header ── */
+.panel-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 1.5rem;
+}
+
+.header-left {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    color: var(--nexus-accent, #10b981);
+}
+
+.header-left h4 {
+    margin: 0;
+    font-size: 0.95rem;
+    font-weight: 600;
+    color: var(--nexus-text-primary, #ffffff);
+    letter-spacing: 0.02em;
+}
+
+.panel-badge {
+    font-size: 0.7rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    padding: 0.2rem 0.55rem;
+    border-radius: 100px;
+    background: linear-gradient(135deg, rgba(16, 185, 129, 0.15), rgba(59, 130, 246, 0.1));
+    border: 1px solid rgba(16, 185, 129, 0.3);
+    color: var(--nexus-accent, #10b981);
+    text-transform: uppercase;
+}
+
+/* ── Loading State ── */
+.loading-state {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 1rem;
+    padding: 2rem 1rem;
+}
+
+.spinner-ring {
+    position: relative;
+    width: 40px;
+    height: 40px;
+}
+
+.spinner-track {
+    position: absolute;
+    inset: 0;
+    border-radius: 50%;
+    border: 3px solid rgba(255, 255, 255, 0.05);
+}
+
+.spinner-head {
+    position: absolute;
+    inset: 0;
+    border-radius: 50%;
+    border: 3px solid transparent;
+    border-top-color: var(--nexus-accent, #10b981);
+    animation: nexus-spin 0.8s linear infinite;
+    box-shadow: 0 0 12px rgba(16, 185, 129, 0.4);
+}
+
+@keyframes nexus-spin {
+    to { transform: rotate(360deg); }
+}
+
+.loading-label {
+    font-size: 0.82rem;
+    color: var(--nexus-text-secondary, #a1a1aa);
+    font-style: italic;
+}
+
+/* ── Empty / Error State ── */
+.empty-state {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 1.5rem;
+    text-align: center;
+    color: var(--nexus-text-secondary, #a1a1aa);
+    opacity: 0.65;
+}
+
+.empty-state p {
+    margin: 0;
+    font-size: 0.875rem;
+}
+
+/* ── Recommendations List ── */
+.recommendations-list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+}
+
+.recommendation-item {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.75rem;
+    padding: 1rem 1.1rem;
+    border-radius: 10px;
+    background: rgba(255, 255, 255, 0.02);
+    border: 1px solid rgba(255, 255, 255, 0.06);
+    transition: background 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
+    cursor: default;
+}
+
+.recommendation-item:hover {
+    background: rgba(255, 255, 255, 0.04);
+    transform: translateX(2px);
+}
+
+.recommendation-item.premium {
+    border-color: rgba(245, 158, 11, 0.2);
+}
+
+.recommendation-item.premium:hover {
+    border-color: rgba(245, 158, 11, 0.4);
+    background: rgba(245, 158, 11, 0.04);
+}
+
+.recommendation-item.owned {
+    border-color: rgba(16, 185, 129, 0.1);
+}
+
+.recommendation-item.owned:hover {
+    border-color: rgba(16, 185, 129, 0.25);
+}
+
+/* ── Rec Content ── */
+.rec-content {
+    flex: 1;
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+}
+
+.rec-meta {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin-bottom: 0.15rem;
+}
+
+.match-badge {
+    font-size: 0.8rem;
+    font-weight: 700;
+    color: var(--nexus-accent, #10b981);
+    background: rgba(16, 185, 129, 0.1);
+    border-radius: 4px;
+    padding: 0.1rem 0.45rem;
+}
+
+.match-unit {
+    font-size: 0.65rem;
+    font-weight: 500;
+}
+
+.upsell-tag {
+    font-size: 0.7rem;
+    font-weight: 600;
+    letter-spacing: 0.05em;
+    color: #f59e0b;
+    background: rgba(245, 158, 11, 0.1);
+    border: 1px solid rgba(245, 158, 11, 0.2);
+    border-radius: 4px;
+    padding: 0.1rem 0.45rem;
+    text-transform: uppercase;
+}
+
+.rec-book-title {
+    margin: 0;
+    font-size: 0.9rem;
+    font-weight: 600;
+    color: var(--nexus-text-primary, #ffffff);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.rec-chapter-title {
+    margin: 0;
+    font-size: 0.78rem;
+    color: var(--nexus-text-secondary, #a1a1aa);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+/* ── Action Button ── */
+.rec-action-btn {
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 32px;
+    height: 32px;
+    border-radius: 8px;
+    border: 1px solid rgba(255, 255, 255, 0.08);
+    background: transparent;
+    color: var(--nexus-text-secondary, #a1a1aa);
+    cursor: pointer;
+    transition: all 0.2s ease;
+}
+
+.rec-action-btn:hover {
+    background: rgba(16, 185, 129, 0.1);
+    border-color: rgba(16, 185, 129, 0.3);
+    color: var(--nexus-accent, #10b981);
+    transform: scale(1.1);
+}
+
+.premium .rec-action-btn:hover {
+    background: rgba(245, 158, 11, 0.1);
+    border-color: rgba(245, 158, 11, 0.3);
+    color: #f59e0b;
+}
+
+@media (max-width: 768px) {
+    .recommendations-panel {
+        padding: 1.25rem;
+    }
+}
+
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .recommendations-panel {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+}
+
+.theme-light .recommendations-panel:hover {
+    box-shadow: 0 8px 24px rgba(139, 130, 115, 0.12);
+}
+
+.theme-light .header-left h4 {
+    color: var(--text-main);
+}
+
+.theme-light .spinner-track {
+    border: 3px solid rgba(0, 0, 0, 0.05);
+}
+
+.theme-light .loading-label,
+.theme-light .empty-state {
+    color: var(--text-muted);
+}
+
+.theme-light .recommendation-item {
+    background: rgba(0, 0, 0, 0.02);
+    border: 1px solid rgba(0, 0, 0, 0.06);
+}
+
+.theme-light .recommendation-item:hover {
+    background: rgba(0, 0, 0, 0.04);
+}
+
+.theme-light .recommendation-item.premium {
+    border-color: rgba(245, 158, 11, 0.2);
+}
+
+.theme-light .recommendation-item.premium:hover {
+    border-color: rgba(245, 158, 11, 0.4);
+    background: rgba(245, 158, 11, 0.04);
+}
+
+.theme-light .recommendation-item.owned {
+    border-color: rgba(16, 185, 129, 0.1);
+}
+
+.theme-light .recommendation-item.owned:hover {
+    border-color: rgba(16, 185, 129, 0.25);
+}
+
+.theme-light .rec-book-title {
+    color: var(--text-main);
+}
+
+.theme-light .rec-chapter-title {
+    color: var(--text-muted);
+}
+
+.theme-light .rec-action-btn {
+    border: 1px solid rgba(0, 0, 0, 0.08);
+    color: var(--text-muted);
+}
+
+.theme-light .rec-action-btn:hover {
+    background: rgba(16, 185, 129, 0.1);
+    border-color: rgba(16, 185, 129, 0.3);
+    color: var(--accent);
+}
+
+.theme-light .premium .rec-action-btn:hover {
+    background: rgba(245, 158, 11, 0.1);
+    border-color: rgba(245, 158, 11, 0.3);
+    color: #f59e0b;
+}

src/NexusReader.UI.Shared/Components/Organisms/CurrentReadingWidget.razor

@@ -5,14 +5,14 @@
 <section class="current-reading-card glass-panel">
     @if (Book != null)
     {
-        <div class="card-layout">
+        <div @key='"current-reading-book"' class="card-layout">
             <div class="book-cover">
-                <img src="@(Book.CoverUrl ?? "https://via.placeholder.com/120x180?text=No+Cover")" alt="@Book.Title" />
+                <img src="@(string.IsNullOrEmpty(Book.CoverUrl) ? "https://via.placeholder.com/120x180?text=No+Cover" : Book.CoverUrl)" alt="@Book.Title" aria-describedby="book-title-@Book.Id" />
             </div>
             
             <div class="book-details">
                 <div class="header-info">
-                    <h3 class="book-title">@Book.Title</h3>
+                    <h3 id="book-title-@Book.Id" class="book-title">@Book.Title</h3>
                     <span class="author-name">by @Book.Author.Name</span>
                 </div>
 
@@ -41,8 +41,8 @@
                 }
 
                 <div class="actions">
-                    <button class="btn-nexus outline" @onclick="HandleContinueReading">
-                        Continue Reading
+                    <button class="btn-nexus outline" @onclick="HandleContinueReading" aria-label="Kontynuuj czytanie">
+                        Kontynuuj czytanie
                         <NexusIcon Name="arrow-right" Size="16" />
                     </button>
                 </div>
@@ -51,7 +51,7 @@
     }
     else
     {
-        <div class="empty-state">
+        <div @key='"current-reading-empty"' class="empty-state">
             <div class="empty-icon">
                 <NexusIcon Name="book-open" Size="48" />
             </div>

src/NexusReader.UI.Shared/Components/Organisms/CurrentReadingWidget.razor.css

@@ -194,19 +194,155 @@
     margin: 0;
 }
 
-@media (max-width: 768px) {
-    .card-layout {
-        flex-direction: column;
-        align-items: center;
-        text-align: center;
-        gap: 1.5rem;
+@media (max-width: 767px) {
+    .current-reading-card {
+        background: #1e1e22; /* Lighter anthracite slate for depth */
+        box-shadow: 0 12px 24px rgba(0, 0, 0, 0.3); /* Ambient card shadow */
+        padding: 14px;
+        border-radius: 16px;
+        border: 1px solid var(--border);
     }
 
-    .book-title, .chapter-name {
+    .card-layout {
+        flex-direction: column;
+        align-items: stretch;
+        text-align: left;
+        gap: 0.75rem;
+    }
+    
+    .book-cover {
+        align-self: center;
+        width: 90px;
+    }
+    
+    .book-details {
+        width: 100%;
+        text-align: left;
+    }
+    
+    .book-title {
+        font-size: 1.25rem;
+        text-align: left;
         white-space: normal;
     }
 
+    .author-name {
+        text-align: left;
+        font-size: 0.8rem;
+    }
+    
     .header-info, .chapter-progress {
-        align-items: center;
+        align-items: stretch;
+    }
+
+    .chapter-name {
+        white-space: normal;
+        font-size: 0.8rem;
+    }
+    
+    .chapter-progress {
+        margin: 0.5rem 0; /* Margin separator before tracking bar */
+        width: 100%;
+    }
+    
+    .progress-bar-container {
+        width: 100%;
+    }
+
+    .book-excerpt {
+        display: -webkit-box; /* Normal display to wrap synopsis */
+        overflow: hidden;
+        -webkit-line-clamp: 2;
+        -webkit-box-orient: vertical;
+        margin-bottom: 0.75rem;
+        text-align: left;
+        font-size: 0.85rem;
+    }
+    
+    .actions {
+        width: 100%;
+        margin-top: 0.25rem;
+    }
+    
+    .actions .btn-nexus.outline {
+        width: 100%;
+        justify-content: center;
+        padding: 0.75rem 1.25rem; /* Larger touch target */
+        box-sizing: border-box;
+        background: transparent !important;
+        color: var(--accent) !important;
+        border: 1px solid var(--accent) !important;
+        display: inline-flex !important;
+        align-items: center !important;
+        font-weight: 600 !important;
+    }
+
+    .actions .btn-nexus.outline:hover {
+        background: var(--accent-glow) !important;
+        color: var(--accent) !important;
+    }
+
+    .theme-light .current-reading-card {
+        background: #ffffff; /* Pure white card surface for light theme */
+        box-shadow: 0 12px 24px rgba(139, 130, 115, 0.12);
     }
 }
+
+
+
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .current-reading-card {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+}
+
+.theme-light .current-reading-card:hover {
+    background: var(--bg-surface);
+    border-color: var(--accent);
+    box-shadow: 0 10px 30px rgba(139, 130, 115, 0.12);
+}
+
+.theme-light .book-cover img {
+    box-shadow: 0 15px 35px rgba(139, 130, 115, 0.18);
+    border: 1px solid rgba(0, 0, 0, 0.06);
+}
+
+.theme-light .book-title {
+    color: var(--text-main);
+}
+
+.theme-light .author-name {
+    color: var(--text-muted);
+}
+
+.theme-light .chapter-name {
+    color: var(--text-main);
+}
+
+.theme-light .progress-bar-container {
+    background: #e4e1d9;
+}
+
+.theme-light .progress-bar-fill {
+    box-shadow: 0 0 6px rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .book-excerpt {
+    color: var(--text-muted);
+}
+
+.theme-light .empty-text h3 {
+    color: var(--text-main);
+}
+
+.theme-light .empty-text p {
+    color: var(--text-muted);
+}
+
+.theme-light .empty-icon {
+    color: var(--accent);
+    filter: none;
+}

src/NexusReader.UI.Shared/Components/Organisms/MobileReaderToolbar.razor

@@ -114,7 +114,7 @@
         ThemeService.OnThemeChanged += HandleThemeChanged;
     }
 
-    private Task HandleThemeChanged() => InvokeAsync(StateHasChanged);
+    private void HandleThemeChanged(ThemeMode mode) => InvokeAsync(StateHasChanged);
 
     private double GetDashOffset()
     {

src/NexusReader.UI.Shared/Components/Organisms/ReaderCanvas.razor

@@ -127,7 +127,7 @@
     protected override async Task OnInitializedAsync()
     {
         await Coordinator.ClearAsync();
-        ThemeService.OnThemeChanged += HandleUpdate;
+        ThemeService.OnThemeChanged += HandleThemeChanged;
         NavigationService.OnNavigationChanged += OnNavigationChanged;
         QuizService.OnQuizUpdated += HandleUpdate;
 
@@ -451,6 +451,8 @@
 
     private Task HandleUpdate() => InvokeAsync(StateHasChanged);
 
+    private void HandleThemeChanged(ThemeMode mode) => InvokeAsync(StateHasChanged);
+
     private void HandleEscape()
     {
         if (ViewModel != null)
@@ -466,7 +468,7 @@
 
     public async ValueTask DisposeAsync()
     {
-        ThemeService.OnThemeChanged -= HandleUpdate;
+        ThemeService.OnThemeChanged -= HandleThemeChanged;
         NavigationService.OnNavigationChanged -= OnNavigationChanged;
         QuizService.OnQuizUpdated -= HandleUpdate;
 

src/NexusReader.UI.Shared/Layout/MainHubLayout.razor

@@ -1,4 +1,5 @@
 @inherits LayoutComponentBase
+@implements IDisposable
 @using NexusReader.UI.Shared.Components.Molecules
 @using NexusReader.UI.Shared.Components.Atoms
 @using NexusReader.Application.Abstractions.Services
@@ -6,13 +7,13 @@
 
 @if (!_isFullyLoaded)
 {
-    <div class="app-preloader" style="backdrop-filter: blur(15px); background: rgba(18, 18, 18, 0.95); z-index: 100000; color: #ffffff;">
+    <div @key='"preloader"' class="app-preloader" style="backdrop-filter: blur(15px); background: rgba(18, 18, 18, 0.95); z-index: 100000; color: #ffffff;">
         <div class="preloader-spinner"></div>
         <div class="preloader-text" style="color: #ffffff;">Synchronizing Secure Session...</div>
     </div>
 }
 
-<div class="hub-container @(_isMobileMenuOpen ? "mobile-menu-open" : "")">
+<div @key='"hub-container"' class="hub-container @(_isMobileMenuOpen ? "mobile-menu-open" : "") @(ThemeService.IsLightMode ? "theme-light" : "theme-dark")">
     <AuthorizeView>
         <Authorized>
             <!-- Mobile Sticky Top-bar -->
@@ -94,6 +95,12 @@
                         </div>
                         <span class="nav-text">Koncentry</span>
                     </NavLink>
+                    <NavLink class="nav-item" href="/creator" @onclick="CloseMobileMenu" title="Kreator" aria-label="Kreator">
+                        <div class="nav-icon">
+                            <NexusIcon Name="edit" Size="20" />
+                        </div>
+                        <span class="nav-text">Kreator</span>
+                    </NavLink>
                 </nav>
 
                 <div class="sidebar-footer">
@@ -110,6 +117,32 @@
                     </button>
                 </div>
             </aside>
+
+            <!-- Reader Mobile Dock v3 -->
+            <nav class="reader-mobile-dock">
+                <NavLink class="dock-item" href="/dashboard" Match="NavLinkMatch.All" title="Pulpit">
+                    <NexusIcon Name="home" Size="20" />
+                    <span class="dock-text">Pulpit</span>
+                </NavLink>
+                <NavLink class="dock-item" href="/catalog" title="Katalog">
+                    <NexusIcon Name="layout" Size="20" />
+                    <span class="dock-text">Katalog</span>
+                </NavLink>
+                <NavLink class="dock-item central-action" href="/intelligence" title="Globalne AI">
+                    <div class="central-action-inner">
+                        <NexusIcon Name="robot" Size="20" />
+                    </div>
+                    <span class="dock-text">AI</span>
+                </NavLink>
+                <NavLink class="dock-item" href="/my-books" title="Moje">
+                    <NexusIcon Name="book-open" Size="20" />
+                    <span class="dock-text">Moje</span>
+                </NavLink>
+                <NavLink class="dock-item" href="/profile" title="Konto">
+                    <NexusIcon Name="user" Size="20" />
+                    <span class="dock-text">Konto</span>
+                </NavLink>
+            </nav>
         </Authorized>
     </AuthorizeView>
 
@@ -124,6 +157,7 @@
     [Inject] private AuthenticationStateProvider AuthStateProvider { get; set; } = default!;
     [Inject] private IIdentityService IdentityService { get; set; } = default!;
     [Inject] private NavigationManager NavigationManager { get; set; } = default!;
+    [Inject] private IThemeService ThemeService { get; set; } = default!;
 
     private bool _isSyncing = false;
     private bool _isMobileMenuOpen = false;
@@ -131,6 +165,8 @@
 
     protected override async Task OnInitializedAsync()
     {
+        ThemeService.OnThemeChanged += HandleThemeChanged;
+
         if (_isSyncing) return;
         
         var authState = await AuthStateProvider.GetAuthenticationStateAsync();
@@ -142,10 +178,16 @@
         }
     }
 
-    protected override void OnAfterRender(bool firstRender)
+    private void HandleThemeChanged(ThemeMode mode)
+    {
+        InvokeAsync(StateHasChanged);
+    }
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
     {
         if (firstRender)
         {
+            await ThemeService.InitializeAsync();
             _isFullyLoaded = true;
             StateHasChanged();
         }
@@ -167,4 +209,10 @@
         await IdentityService.LogoutAsync();
         NavigationManager.NavigateTo("/account/logout-form", true);
     }
+
+    public void Dispose()
+    {
+        ThemeService.OnThemeChanged -= HandleThemeChanged;
+        GC.SuppressFinalize(this);
+    }
 }

src/NexusReader.UI.Shared/Layout/MainHubLayout.razor.css

@@ -2,16 +2,16 @@
     display: flex;
     width: 100vw;
     height: 100vh;
-    background: #121214;
-    color: #e4e4e7;
+    background: var(--bg-base);
+    color: var(--text-main);
     overflow: hidden;
 }
 
 ::deep .hub-sidebar {
     width: 80px;
     height: 100%;
-    background: #0d0d0d;
-    border-right: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border-right: 1px solid var(--border);
     display: flex;
     flex-direction: column;
     z-index: 100;
@@ -55,7 +55,7 @@
     justify-content: center;
     width: 100%;
     height: 54px;
-    color: #8b8273;
+    color: var(--text-muted);
     text-decoration: none;
     transition: color 0.2s ease, background-color 0.2s ease;
     position: relative;
@@ -63,7 +63,7 @@
 
 ::deep .nav-item:hover {
     color: #10b981;
-    background: rgba(255, 255, 255, 0.01);
+    background: rgba(0, 0, 0, 0.04);
 }
 
 ::deep .nav-item:focus-visible {
@@ -103,7 +103,7 @@
 
 ::deep .sidebar-footer {
     padding: 1.5rem 0;
-    border-top: 1px solid rgba(255, 255, 255, 0.05);
+    border-top: 1px solid var(--border);
     display: flex;
     flex-direction: column;
     align-items: center;
@@ -119,15 +119,15 @@
 ::deep .user-avatar {
     width: 36px;
     height: 36px;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
     border-radius: 50%;
     display: flex;
     align-items: center;
     justify-content: center;
     font-size: 0.9rem;
     font-weight: 600;
-    color: #e4e4e7;
+    color: var(--text-main);
     flex-shrink: 0;
 }
 
@@ -138,7 +138,7 @@
 ::deep .logout-btn {
     background: transparent;
     border: none;
-    color: #8b8273;
+    color: var(--text-muted);
     cursor: pointer;
     padding: 0.5rem;
     border-radius: 8px;
@@ -157,7 +157,7 @@
     flex: 1;
     height: 100%;
     overflow-y: auto;
-    background: #121214;
+    background: var(--bg-base);
 }
 
 .hub-content {
@@ -194,7 +194,11 @@
     display: none;
 }
 
-@media (max-width: 768px) {
+.reader-mobile-dock {
+    display: none;
+}
+
+@media (max-width: 767px) {
     .nexus-mobile-topbar {
         display: flex;
         align-items: center;
@@ -204,10 +208,10 @@
         left: 0;
         right: 0;
         height: 60px;
-        background: rgba(18, 18, 18, 0.85);
+        background: var(--bg-surface);
         backdrop-filter: blur(20px);
         -webkit-backdrop-filter: blur(20px);
-        border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+        border-bottom: 1px solid var(--border);
         padding: 0 1.25rem;
         z-index: 150;
     }
@@ -262,7 +266,7 @@
         width: 32px;
         height: 32px;
         background: linear-gradient(135deg, var(--nexus-neon) 0%, #0099ff 100%);
-        border: 1px solid rgba(255, 255, 255, 0.1);
+        border: 1px solid var(--border);
         border-radius: 50%;
         display: flex;
         align-items: center;
@@ -295,7 +299,7 @@
         bottom: 0;
         width: 280px;
         height: 100%;
-        background: #141414;
+        background: var(--bg-surface);
         z-index: 200;
         transform: translateX(-100%);
         will-change: transform;
@@ -324,7 +328,7 @@
 
     ::deep .sidebar-header {
         padding: 1.5rem 1.25rem;
-        border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+        border-bottom: 1px solid var(--border);
     }
 
     ::deep .sidebar-nav {
@@ -342,4 +346,217 @@
     }
 }
 
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   Scoped via .theme-light on an ancestor element.
+   ============================================================ */
 
+/* --- Desktop Sidebar: warm paper shadow --- */
+.theme-light ::deep .hub-sidebar {
+    box-shadow: 4px 0 20px rgba(139, 130, 115, 0.08);
+    background: var(--bg-surface) !important;
+    border-right: 1px solid var(--border) !important;
+}
+
+/* --- Logo icon: remove neon glow --- */
+.theme-light ::deep .logo-icon {
+    filter: none;
+}
+
+/* --- Nav item hover: ensure green text, warm hover bg --- */
+.theme-light ::deep .nav-item:hover {
+    color: #10b981;
+    background: rgba(0, 0, 0, 0.02);
+}
+
+/* --- Nav active indicator: reduced glow --- */
+.theme-light ::deep .nav-item.active::before {
+    box-shadow: 0 0 8px rgba(16, 185, 129, 0.3);
+}
+
+/* --- Nexus loader: remove neon drop-shadow --- */
+.theme-light ::deep .nexus-loader {
+    filter: none;
+}
+
+/* --- Mobile Styles --- */
+@media (max-width: 768px) {
+
+    /* Hamburger button: dark text on warm paper */
+    .theme-light .hamburger-btn {
+        color: #292524;
+    }
+
+    .theme-light .hamburger-btn:hover {
+        background: rgba(0, 0, 0, 0.04);
+    }
+
+    /* User avatar mini: solid accent, white text, no neon glow */
+    .theme-light .user-avatar-mini {
+        background: #10b981;
+        color: #ffffff;
+        box-shadow: 0 2px 8px rgba(16, 185, 129, 0.15);
+    }
+
+    /* Pulsing logo: subtle accent pulse, no neon glow */
+    .theme-light .pulsing-logo {
+        animation: pulse-glow-light 2s infinite ease-in-out;
+    }
+
+    @keyframes pulse-glow-light {
+        0%, 100% {
+            filter: none;
+            opacity: 0.85;
+        }
+        50% {
+            filter: drop-shadow(0 0 4px rgba(16, 185, 129, 0.2));
+            opacity: 1;
+        }
+    }
+
+    /* Mobile sidebar open state: warm shadow instead of dark */
+    .theme-light .mobile-menu-open ::deep .hub-sidebar {
+        box-shadow: 10px 0 30px rgba(139, 130, 115, 0.2);
+    }
+
+
+    /* Content padding for bottom navigation dock */
+    .hub-content {
+        padding: 1.25rem 1.25rem calc(1.25rem + 96px + env(safe-area-inset-bottom, 0px)) !important;
+    }
+
+    /* Reader Mobile Dock v3 */
+    ::deep .reader-mobile-dock {
+        display: flex;
+        position: fixed;
+        bottom: calc(16px + env(safe-area-inset-bottom, 0px));
+        left: 20px;
+        right: 20px;
+        height: 64px;
+        background: rgba(26, 26, 30, 0.75); /* Translucent dark mode */
+        backdrop-filter: blur(20px);
+        -webkit-backdrop-filter: blur(20px);
+        border: 1px solid var(--border); /* Microscopic perimeter border */
+        border-radius: 30px; /* Floating capsule rounded borders */
+        z-index: 150;
+        padding: 0 16px;
+        justify-content: space-around;
+        align-items: center;
+        box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
+    }
+    
+    ::deep .dock-item {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        flex: 1;
+        height: 100%;
+        color: var(--text-muted);
+        text-decoration: none;
+        transition: color 0.2s ease, filter 0.2s ease;
+        position: relative;
+        gap: 2px;
+    }
+    
+    ::deep .dock-item:hover, ::deep .dock-item.active {
+        color: var(--accent) !important;
+        filter: drop-shadow(0 0 4px var(--accent-glow)); /* Clean accent glow drop-shadow */
+    }
+
+    ::deep .dock-item ::deep svg,
+    ::deep .dock-item ::deep .nexus-icon,
+    ::deep .dock-item svg,
+    ::deep .dock-item .nexus-icon {
+        color: inherit !important;
+        fill: currentColor !important;
+    }
+    
+    ::deep .dock-text {
+        display: block !important;
+        font-size: 10px;
+        font-weight: 500;
+        margin-top: 2px;
+        white-space: nowrap;
+        color: inherit;
+    }
+
+    /* Central action button style */
+    ::deep .dock-item.central-action {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        position: relative;
+        flex: 1;
+        height: 100%;
+        gap: 2px;
+        margin-top: 0;
+        transform: none !important;
+        z-index: 160;
+    }
+    
+    ::deep .central-action-inner {
+        width: 36px;
+        height: 36px;
+        border-radius: 50%;
+        background: var(--accent); /* Solid green background */
+        color: #ffffff !important; /* White robot icon */
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        border: none !important;
+        box-shadow: 0 4px 10px rgba(0, 255, 153, 0.3);
+        transition: transform 0.2s cubic-bezier(0.4, 0, 0.2, 1), box-shadow 0.2s ease;
+    }
+
+    ::deep .central-action-inner ::deep svg,
+    ::deep .central-action-inner ::deep .nexus-icon,
+    ::deep .central-action-inner svg,
+    ::deep .central-action-inner .nexus-icon {
+        color: #ffffff !important;
+        fill: currentColor !important;
+    }
+    
+    ::deep .dock-item.central-action:hover .central-action-inner,
+    ::deep .dock-item.central-action.active .central-action-inner {
+        transform: scale(1.05);
+        box-shadow: 0 4px 14px rgba(0, 255, 153, 0.5);
+    }
+
+    ::deep .central-action-glow {
+        display: none; /* Purged background glow */
+    }
+
+    /* Light Theme Overrides */
+    .theme-light ::deep .reader-mobile-dock {
+        background: rgba(244, 241, 234, 0.9); /* Translucent light mode warm paper background */
+        box-shadow: 0 8px 30px rgba(139, 130, 115, 0.15);
+    }
+    
+    .theme-light ::deep .dock-item {
+        color: var(--text-muted);
+    }
+    
+    .theme-light ::deep .dock-item:hover, .theme-light ::deep .dock-item.active {
+        color: var(--accent) !important;
+        filter: drop-shadow(0 0 3px var(--accent-glow));
+    }
+    
+    .theme-light ::deep .central-action-inner {
+        background: var(--accent) !important;
+        color: #ffffff !important;
+        border: none !important;
+        box-shadow: 0 4px 10px rgba(16, 185, 129, 0.25) !important;
+    }
+    
+    .theme-light ::deep .dock-item.central-action:hover .central-action-inner,
+    .theme-light ::deep .dock-item.central-action.active .central-action-inner {
+        box-shadow: 0 4px 14px rgba(16, 185, 129, 0.35) !important;
+        transform: scale(1.05);
+    }
+    
+    .theme-light ::deep .central-action-glow {
+        display: none;
+    }
+}

src/NexusReader.UI.Shared/Layout/ReaderLayout.razor

@@ -343,7 +343,7 @@
         InteractionService.OnAssistantRequested += HandleAssistantRequestedAsync;
         InteractionService.OnScrollPercentChanged += HandleScrollPercentChanged;
         GraphService.OnGraphUpdated += HandleGraphUpdatedAsync;
-        ThemeService.OnThemeChanged += HandleThemeChangedAsync;
+        ThemeService.OnThemeChanged += HandleThemeChanged;
         Coordinator.OnSelectionSummaryStateChanged += HandleUpdate;
 
         var context = PlatformService.GetDeviceContext();
@@ -359,7 +359,7 @@
         }
     }
 
-    private async Task HandleThemeChangedAsync() => await InvokeAsync(StateHasChanged);
+    private void HandleThemeChanged(ThemeMode mode) => InvokeAsync(StateHasChanged);
 
     private void SetActiveTab(SidebarTab tab)
     {
@@ -520,7 +520,7 @@
         InteractionService.OnAssistantRequested -= HandleAssistantRequestedAsync;
         InteractionService.OnScrollPercentChanged -= HandleScrollPercentChanged;
         GraphService.OnGraphUpdated -= HandleGraphUpdatedAsync;
-        ThemeService.OnThemeChanged -= HandleThemeChangedAsync;
+        ThemeService.OnThemeChanged -= HandleThemeChanged;
         Coordinator.OnSelectionSummaryStateChanged -= HandleUpdate;
 
         try

src/NexusReader.UI.Shared/Models/ReaderModels.cs

@@ -28,6 +28,12 @@ public class ChatMessage
     public DateTime Timestamp { get; set; } = DateTime.UtcNow;
     public List<ResponseSegment> Segments { get; set; } = new();
     public List<CitationDto> Citations { get; set; } = new();
+
+    public string ClearText { get; set; } = string.Empty;
+    public string BlurredTeaserText { get; set; } = string.Empty;
+    public bool IsPaywalled { get; set; }
+    public string SourceBookTitle { get; set; } = string.Empty;
+    public string DocumentId { get; set; } = string.Empty;
 }
 
 /// <summary>

src/NexusReader.UI.Shared/Pages/Account/Login.razor

@@ -33,7 +33,7 @@
             <span>lub</span>
         </div>
 
-        <EditForm Model="@_loginModel" OnValidSubmit="HandleLogin" class="auth-form">
+        <EditForm FormName="login-form" Model="@_loginModel" OnValidSubmit="HandleLogin" class="auth-form">
             <DataAnnotationsValidator />
 
             <div class="field-group">
@@ -98,7 +98,7 @@
     </div>
 </div>
 
-<form id="nexusLoginForm" method="post" action="/account/login-form" style="display:none">
+<form @formname="hidden-login-form" id="nexusLoginForm" method="post" action="/account/login-form" style="display:none">
     <input type="hidden" name="email" value="@_loginModel.Email" />
     <input type="hidden" name="password" value="@_loginModel.Password" />
     <input type="hidden" name="rememberMe" value="@(_loginModel.RememberMe ? "true" : "false")" />
@@ -117,7 +117,10 @@
     [SupplyParameterFromQuery(Name = "returnUrl")]
     public string? ReturnUrl { get; set; }
 
-    private LoginModel _loginModel = new();
+#pragma warning disable BL0008
+    [SupplyParameterFromForm(FormName = "login-form")]
+    private LoginModel _loginModel { get; set; } = new();
+#pragma warning restore BL0008
     private string? _errorMessage;
     private bool _isSubmitting;
     private bool _showPassword;

src/NexusReader.UI.Shared/Pages/Account/Profile.razor

@@ -4,8 +4,10 @@
 @using NexusReader.UI.Shared.Services
 @using NexusReader.UI.Shared.Components.Atoms
 @attribute [Authorize]
+@using NexusReader.Domain.Enums
 @inject IIdentityService IdentityService
 @inject NavigationManager NavigationManager
+@inject IThemeService ThemeService
 
 <div class="profile-page-container">
     <div class="background-radial"></div>
@@ -97,6 +99,31 @@
                         </div>
                     </div>
                 </div>
+
+                <!-- Theme Preferences Card -->
+                <div class="metric-card glass-panel full-width theme-preference-card">
+                    <div class="card-header">
+                        <NexusIcon Name="settings" Size="24" Color="#10b981" />
+                        <h3>Preferencje Wizualne</h3>
+                    </div>
+                    <div class="card-body theme-selector-layout">
+                        <p class="theme-description">Wybierz profil wizualny systemu zoptymalizowany dla Twojego urządzenia i warunków czytania.</p>
+                        <div class="theme-options">
+                            <button class="theme-option-btn @(ThemeService.Mode == ThemeMode.System ? "active" : "")" @onclick="() => ChangeTheme(ThemeMode.System)">
+                                <NexusIcon Name="cpu" Size="16" />
+                                <span>Systemowy</span>
+                            </button>
+                            <button class="theme-option-btn @(ThemeService.Mode == ThemeMode.Dark ? "active" : "")" @onclick="() => ChangeTheme(ThemeMode.Dark)">
+                                <NexusIcon Name="moon" Size="16" />
+                                <span>Modern Deep Dark</span>
+                            </button>
+                            <button class="theme-option-btn @(ThemeService.Mode == ThemeMode.LightSepia ? "active" : "")" @onclick="() => ChangeTheme(ThemeMode.LightSepia)">
+                                <NexusIcon Name="sun" Size="16" />
+                                <span>Warm Sepia</span>
+                            </button>
+                        </div>
+                    </div>
+                </div>
             </div>
         </div>
     }
@@ -110,6 +137,7 @@
 
     protected override async Task OnInitializedAsync()
     {
+        await ThemeService.InitializeAsync();
         var result = await IdentityService.GetProfileAsync();
         if (result.IsSuccess) 
         {
@@ -118,6 +146,12 @@
         StateHasChanged();
     }
 
+    private async Task ChangeTheme(ThemeMode mode)
+    {
+        await ThemeService.SetThemeAsync(mode);
+        StateHasChanged();
+    }
+
     private int CalculateProgress()
     {
         if (_profile == null || _profile.AITokenLimit == 0) return 0;

src/NexusReader.UI.Shared/Pages/Account/Profile.razor.css

@@ -2,8 +2,8 @@
     position: relative;
     width: 100%;
     min-height: 100vh;
-    background-color: #121214;
-    color: #e4e4e7;
+    background-color: var(--bg-base);
+    color: var(--text-main);
     overflow-x: hidden;
     display: flex;
     justify-content: center;
@@ -26,7 +26,7 @@
 .mesh-overlay {
     position: absolute;
     top: 0; left: 0; width: 100%; height: 100%;
-    background-image: radial-gradient(circle at 1px 1px, rgba(255, 255, 255, 0.02) 1px, transparent 0);
+    background-image: radial-gradient(circle at 1px 1px, var(--border) 1px, transparent 0);
     background-size: 32px 32px;
     z-index: 1;
 }
@@ -63,7 +63,7 @@
 .avatar-inner {
     width: 120px;
     height: 120px;
-    background: #1a1a1e;
+    background: var(--bg-surface);
     border: 2px solid #10b981;
     border-radius: 50%;
     display: flex;
@@ -98,7 +98,7 @@
     font-weight: 700;
     margin: 0;
     letter-spacing: -0.01em;
-    color: #ffffff;
+    color: var(--text-main);
 }
 
 .system-rank {
@@ -120,17 +120,17 @@
 
 .glass-panel {
     padding: 32px;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     border-radius: 12px;
     transition: all 0.3s ease;
 }
 
 .glass-panel:hover {
-    border-color: rgba(16, 185, 129, 0.2);
+    border-color: var(--accent);
     transform: translateY(-4px);
-    background: #1e1e24;
-    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.3);
+    background: var(--bg-surface);
+    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.1);
 }
 
 .metric-card {
@@ -154,7 +154,7 @@
     font-weight: 600;
     text-transform: uppercase;
     letter-spacing: 0.1em;
-    color: #a0aec0;
+    color: var(--text-muted);
     margin: 0;
 }
 
@@ -177,14 +177,14 @@
     gap: 8px;
 }
 
-.usage-values .current { font-size: 2.5rem; font-weight: 800; color: #fff; line-height: 1; }
-.usage-values .separator { font-size: 1.2rem; color: #4a5568; }
-.usage-values .total { font-size: 1.2rem; color: #718096; font-weight: 600; }
+.usage-values .current { font-size: 2.5rem; font-weight: 800; color: var(--text-main); line-height: 1; }
+.usage-values .separator { font-size: 1.2rem; color: var(--border); }
+.usage-values .total { font-size: 1.2rem; color: var(--text-muted); font-weight: 600; }
 
 .usage-progress {
     width: 100%;
     height: 6px;
-    background: rgba(255, 255, 255, 0.05);
+    background: var(--border);
     border-radius: 10px;
     overflow: hidden;
 }
@@ -198,7 +198,7 @@
 
 .metric-label {
     font-size: 0.75rem;
-    color: #718096;
+    color: var(--text-muted);
     text-transform: uppercase;
     letter-spacing: 0.05em;
 }
@@ -218,7 +218,7 @@
 
 .score-label {
     font-size: 0.75rem;
-    color: #718096;
+    color: var(--text-muted);
     text-transform: uppercase;
     margin-top: 4px;
 }
@@ -229,11 +229,11 @@
     align-items: center;
     gap: 8px;
     padding: 10px 16px;
-    background: rgba(16, 185, 129, 0.05);
-    border: 1px solid rgba(16, 185, 129, 0.1);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
     border-radius: 12px;
     font-size: 0.85rem;
-    color: #cbd5e0;
+    color: var(--text-main);
 }
 
 .truncate {
@@ -273,9 +273,9 @@
 }
 
 .plan-badge.free {
-    background: rgba(255, 255, 255, 0.05);
-    color: #a1a1aa;
-    border: 1px solid rgba(255, 255, 255, 0.1);
+    background: var(--bg-base);
+    color: var(--text-muted);
+    border: 1px solid var(--border);
 }
 
 .tenant-tag {
@@ -348,3 +348,111 @@
     .btn-nexus { width: 100%; justify-content: center; }
     .username { font-size: 2.2rem; }
 }
+
+/* Theme Preference Card Styles */
+.theme-preference-card {
+    margin-top: 12px;
+}
+
+.theme-description {
+    font-size: 0.9rem;
+    color: var(--text-muted);
+    margin: 0 0 16px 0;
+}
+
+.theme-options {
+    display: flex;
+    gap: 16px;
+    width: 100%;
+}
+
+.theme-option-btn {
+    flex: 1;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    padding: 14px 20px;
+    background: var(--bg-base);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    color: var(--text-muted);
+    font-size: 0.9rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: all 0.2s ease;
+}
+
+.theme-option-btn:hover {
+    background: rgba(0, 0, 0, 0.04);
+    color: var(--text-main);
+}
+
+.theme-option-btn.active {
+    background: rgba(16, 185, 129, 0.1);
+    color: #10b981;
+    border-color: #10b981;
+    box-shadow: 0 0 15px rgba(16, 185, 129, 0.15);
+}
+
+@media (max-width: 768px) {
+    .theme-options {
+        flex-direction: column;
+    }
+}
+
+/* ============================================
+   Light Theme Overrides — Warm Paper / Soft Sepia
+   ============================================ */
+
+/* Background radial — warmer, slightly stronger glow */
+.theme-light .background-radial {
+    background: radial-gradient(circle, rgba(16, 185, 129, 0.04) 0%, transparent 70%);
+}
+
+/* Avatar — keep green accent, reduce glow intensity */
+.theme-light .avatar-inner {
+    box-shadow: 0 0 20px rgba(16, 185, 129, 0.12), inset 0 0 15px rgba(16, 185, 129, 0.05);
+}
+
+/* Avatar glow ring — softer border */
+.theme-light .avatar-glow {
+    border-color: rgba(16, 185, 129, 0.2);
+}
+
+/* Glass panel hover — warm sepia shadow instead of pure black */
+.theme-light .glass-panel:hover {
+    box-shadow: 0 10px 30px rgba(139, 130, 115, 0.12);
+}
+
+/* Progress bar — reduce neon glow */
+.theme-light .progress-bar {
+    box-shadow: 0 0 10px rgba(16, 185, 129, 0.2);
+}
+
+/* Decorative text — dark ink on light bg instead of light on dark */
+.theme-light .decoration {
+    color: rgba(0, 0, 0, 0.04);
+}
+
+/* Tenant tag — warm stone gray */
+.theme-light .tenant-tag {
+    color: #78716c;
+}
+
+/* Loader — disable neon drop-shadow, softer border */
+.theme-light .nexus-loader {
+    border-color: rgba(16, 185, 129, 0.15);
+    border-top-color: #10b981;
+    filter: none;
+}
+
+/* Theme option active — reduce glow in light mode */
+.theme-light .theme-option-btn.active {
+    box-shadow: 0 0 10px rgba(16, 185, 129, 0.1);
+}
+
+/* Progress bar track — light stone gray */
+.theme-light .usage-progress {
+    background: #e4e1d9;
+}

src/NexusReader.UI.Shared/Pages/Account/Register.razor

@@ -21,7 +21,7 @@
             <p class="auth-subtitle">Utwórz nowe konto</p>
         </div>
 
-        <EditForm Model="@_registerModel" OnValidSubmit="HandleRegister" class="auth-form">
+        <EditForm FormName="register-form" Model="@_registerModel" OnValidSubmit="HandleRegister" class="auth-form">
             <DataAnnotationsValidator />
 
             <div class="field-group">
@@ -71,14 +71,17 @@
     </div>
 </div>
 
-<form id="nexusLoginForm" method="post" action="/account/login-form" style="display:none">
+<form @formname="hidden-register-login-form" id="nexusLoginForm" method="post" action="/account/login-form" style="display:none">
     <input type="hidden" name="email" value="@_registerModel.Email" />
     <input type="hidden" name="password" value="@_registerModel.Password" />
     <input type="hidden" name="rememberMe" value="false" />
 </form>
 
 @code {
-    private RegisterModel _registerModel = new();
+#pragma warning disable BL0008
+    [SupplyParameterFromForm(FormName = "register-form")]
+    private RegisterModel _registerModel { get; set; } = new();
+#pragma warning restore BL0008
     private string? _errorMessage;
     private bool _isSubmitting;
 

src/NexusReader.UI.Shared/Pages/Catalog.razor

@@ -1,12 +1,16 @@
 @page "/catalog"
 @attribute [Authorize]
+@implements IDisposable
 @using NexusReader.UI.Shared.Components.Organisms
 @using NexusReader.Application.DTOs.User
 @using NexusReader.UI.Shared.Services
+@using Microsoft.Extensions.Logging
 @using System.Net.Http.Json
 @inject HttpClient Http
 @inject IReaderNavigationService ReaderNavigation
 @inject NavigationManager NavigationManager
+@inject ILibraryStateService LibraryStateService
+@inject ILogger<Catalog> Logger
 
 <div class="catalog-page">
     <header class="catalog-header">
@@ -189,6 +193,11 @@
     private bool _isLoading = true;
     private List<LastReadBookDto>? _books;
 
+    protected override void OnInitialized()
+    {
+        LibraryStateService.OnBooksChanged += HandleBooksChanged;
+    }
+
     protected override async Task OnAfterRenderAsync(bool firstRender)
     {
         if (firstRender)
@@ -197,6 +206,11 @@
         }
     }
 
+    private void HandleBooksChanged()
+    {
+        _ = InvokeAsync(LoadBooksAsync);
+    }
+
     private async Task LoadBooksAsync()
     {
         _isLoading = true;
@@ -209,7 +223,7 @@
         }
         catch (Exception ex)
         {
-            Console.WriteLine($"[Catalog] Failed to load books: {ex.Message}");
+            Logger.LogError(ex, "[Catalog] Failed to load books.");
             if (OperatingSystem.IsBrowser())
             {
                 _isLoading = false;
@@ -231,4 +245,9 @@
         // Showcase callback
         NavigationManager.NavigateTo("/profile");
     }
+
+    public void Dispose()
+    {
+        LibraryStateService.OnBooksChanged -= HandleBooksChanged;
+    }
 }

src/NexusReader.UI.Shared/Pages/Catalog.razor.css

@@ -14,13 +14,13 @@
     font-size: 2.5rem;
     font-weight: 700;
     margin: 0 0 0.5rem 0;
-    color: #ffffff;
+    color: var(--text-main);
     letter-spacing: -0.5px;
 }
 
 .catalog-header .subtitle {
     font-size: 1rem;
-    color: #a1a1aa;
+    color: var(--text-muted);
     margin: 0;
 }
 
@@ -38,27 +38,27 @@
     height: 100%;
     overflow: hidden;
     border-radius: 12px;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
     position: relative;
 }
 
 .course-card:hover {
     transform: translateY(-4px);
-    box-shadow: 0 12px 30px rgba(0, 0, 0, 0.3);
-    border-color: rgba(16, 185, 129, 0.2);
+    box-shadow: 0 12px 30px rgba(0, 0, 0, 0.1);
+    border-color: var(--accent);
 }
 
 .card-cover-container {
     position: relative;
     height: 200px;
-    background: rgba(0, 0, 0, 0.2);
+    background: rgba(0, 0, 0, 0.05);
     overflow: hidden;
     display: flex;
     align-items: center;
     justify-content: center;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    border-bottom: 1px solid var(--border);
 }
 
 .card-cover {
@@ -147,8 +147,9 @@
     align-self: flex-start;
     font-size: 0.7rem;
     font-weight: 700;
-    color: #a1a1aa;
-    background: rgba(255, 255, 255, 0.05);
+    color: var(--text-muted);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
     padding: 0.2rem 0.5rem;
     border-radius: 4px;
     text-transform: uppercase;
@@ -175,21 +176,21 @@
     font-size: 1.25rem;
     font-weight: 600;
     margin: 0 0 0.4rem 0;
-    color: #ffffff;
+    color: var(--text-main);
     line-height: 1.3;
     font-family: var(--nexus-font-sans, "Outfit", sans-serif);
 }
 
 .course-author {
     font-size: 0.85rem;
-    color: #a1a1aa;
+    color: var(--text-muted);
     margin: 0 0 1rem 0;
 }
 
 .course-desc {
     font-size: 0.88rem;
     line-height: 1.5;
-    color: #a1a1aa;
+    color: var(--text-muted);
     margin: 0 0 1.5rem 0;
     display: -webkit-box;
     -webkit-line-clamp: 3;
@@ -204,8 +205,8 @@
     justify-content: space-between;
     align-items: center;
     font-size: 0.8rem;
-    color: #a1a1aa;
-    border-top: 1px solid rgba(255, 255, 255, 0.05);
+    color: var(--text-muted);
+    border-top: 1px solid var(--border);
     padding-top: 0.75rem;
 }
 
@@ -256,14 +257,14 @@
     border-radius: 12px;
     overflow: hidden;
     height: 440px;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     opacity: 0.6;
 }
 
 .skeleton-cover {
     height: 200px;
-    background: linear-gradient(90deg, rgba(255,255,255,0.02) 25%, rgba(255,255,255,0.06) 50%, rgba(255,255,255,0.02) 75%);
+    background: linear-gradient(90deg, var(--bg-base) 25%, var(--border) 50%, var(--bg-base) 75%);
     background-size: 200% 100%;
     animation: loading 1.5s infinite;
 }
@@ -276,7 +277,7 @@
 }
 
 .skeleton-line {
-    background: linear-gradient(90deg, rgba(255,255,255,0.02) 25%, rgba(255,255,255,0.06) 50%, rgba(255,255,255,0.02) 75%);
+    background: linear-gradient(90deg, var(--bg-base) 25%, var(--border) 50%, var(--bg-base) 75%);
     background-size: 200% 100%;
     animation: loading 1.5s infinite;
     border-radius: 4px;
@@ -314,9 +315,9 @@
     gap: 1.25rem;
     padding: 1.25rem 2.25rem;
     border-radius: 40px;
-    background: rgba(13, 13, 15, 0.85);
+    background: var(--bg-surface);
     backdrop-filter: blur(16px);
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    border: 1px solid var(--border);
     animation: scaleIn 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
 }
 
@@ -332,7 +333,7 @@
 
 .loader-text {
     font-weight: 500;
-    color: #ffffff;
+    color: var(--text-main);
     font-size: 0.95rem;
 }
 
@@ -356,3 +357,54 @@
     from { transform: translate(-50%, -50%) scale(0.9); opacity: 0; }
     to { transform: translate(-50%, -50%) scale(1); opacity: 1; }
 }
+
+/* ============================================
+   LIGHT THEME OVERRIDES — Warm Paper / Soft Sepia
+   ============================================ */
+
+.theme-light .course-card:hover {
+    box-shadow: 0 12px 30px rgba(139, 130, 115, 0.15);
+}
+
+.theme-light .card-cover-container {
+    background: rgba(0, 0, 0, 0.03);
+}
+
+.theme-light .cover-overlay {
+    background: rgba(0, 0, 0, 0.5);
+}
+
+.theme-light .course-card:hover .start-action {
+    color: #292524;
+}
+
+.theme-light .dotnet-gradient,
+.theme-light .blazor-gradient,
+.theme-light .graph-gradient {
+    background: #e4e1d9;
+}
+
+.theme-light .cover-code-text {
+    color: var(--text-main);
+    text-shadow: none;
+}
+
+@media (max-width: 767px) {
+    .catalog-page {
+        padding: 1.5rem 1rem calc(1.5rem + 72px + env(safe-area-inset-bottom, 0px)) !important;
+    }
+    
+    .catalog-header {
+        margin-bottom: 1.5rem;
+    }
+    
+    .catalog-header h1 {
+        font-size: 1.75rem;
+    }
+    
+    .catalog-grid, .loading-grid {
+        grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+        gap: 1.25rem;
+    }
+}
+

src/NexusReader.UI.Shared/Pages/ConceptsDashboard.razor.css

@@ -17,11 +17,11 @@
     align-items: center;
     gap: 2rem;
     padding: 1.25rem 2rem;
-    background: rgba(20, 20, 20, 0.35);
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     border-radius: 16px;
     backdrop-filter: blur(12px);
-    box-shadow: 0 4px 30px rgba(0, 0, 0, 0.2);
+    box-shadow: 0 4px 30px rgba(0, 0, 0, 0.05);
 }
 
 .header-back .btn-back {
@@ -30,22 +30,22 @@
 }
 
 .header-back .btn-back:hover {
-    border-color: var(--nexus-neon);
-    color: var(--nexus-neon);
-    background: var(--nexus-primary-glow);
-    box-shadow: 0 0 10px var(--nexus-primary-glow);
+    border-color: var(--accent);
+    color: var(--accent);
+    background: var(--accent-glow);
+    box-shadow: 0 0 10px var(--accent-glow);
 }
 
 .header-title h1 {
     margin: 0;
     font-size: 1.5rem;
     font-weight: 700;
-    color: #fff;
+    color: var(--text-main);
 }
 
 .header-title .subtitle {
     font-size: 0.85rem;
-    color: rgba(255, 255, 255, 0.4);
+    color: var(--text-muted);
 }
 
 .header-actions .btn-action {
@@ -56,7 +56,7 @@
 }
 
 .header-actions .btn-action:hover {
-    box-shadow: 0 0 20px var(--nexus-primary-glow);
+    box-shadow: 0 0 20px var(--accent-glow);
 }
 
 /* Grid Layout */
@@ -73,28 +73,26 @@
     flex-direction: column;
     overflow: hidden;
     padding: 0;
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-xl, 16px);
 }
 
 .pane-header {
     padding: 1.25rem 1.5rem;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    border-bottom: 1px solid var(--border);
 }
 
 .pane-header h3 {
     margin: 0;
     font-size: 1rem;
     font-weight: 600;
-    color: #fff;
+    color: var(--text-main);
     display: flex;
     align-items: center;
     gap: 0.5rem;
 }
 
-.pane-content {
-    flex-grow: 1;
-    overflow: hidden;
-}
-
 /* Loading, Error and Empty States */
 .loading-state, .error-state, .empty-dashboard-state {
     display: flex;
@@ -118,15 +116,15 @@
 }
 
 .neon-pulse {
-    color: var(--nexus-neon);
-    filter: drop-shadow(0 0 10px var(--nexus-neon));
+    color: var(--accent);
+    filter: drop-shadow(0 0 10px var(--accent-glow));
     animation: robot-pulse 2s infinite ease-in-out;
 }
 
 @keyframes robot-pulse {
-    0% { transform: scale(1); filter: drop-shadow(0 0 10px var(--nexus-neon)); }
-    50% { transform: scale(1.08); filter: drop-shadow(0 0 25px var(--nexus-neon)); }
-    100% { transform: scale(1); filter: drop-shadow(0 0 10px var(--nexus-neon)); }
+    0% { transform: scale(1); filter: drop-shadow(0 0 10px var(--accent-glow)); }
+    50% { transform: scale(1.08); filter: drop-shadow(0 0 25px var(--accent-glow)); }
+    100% { transform: scale(1); filter: drop-shadow(0 0 10px var(--accent-glow)); }
 }
 
 .scan-line {
@@ -135,8 +133,8 @@
     left: 0;
     width: 100%;
     height: 2px;
-    background: var(--nexus-neon);
-    box-shadow: 0 0 15px var(--nexus-neon);
+    background: var(--accent);
+    box-shadow: 0 0 15px var(--accent);
     animation: scan 2s infinite linear;
     opacity: 0.8;
 }
@@ -149,7 +147,7 @@
 
 .loading-text {
     font-size: 0.95rem;
-    color: rgba(255, 255, 255, 0.7);
+    color: var(--text-muted);
     margin-top: 1rem;
     letter-spacing: 0.05em;
 }
@@ -164,17 +162,18 @@
 }
 
 .dim-icon {
-    color: rgba(255, 255, 255, 0.15);
+    color: var(--text-muted);
+    opacity: 0.4;
 }
 
 .empty-dashboard-state h2, .error-state h3 {
-    color: #fff;
+    color: var(--text-main);
     margin: 0 0 0.75rem 0;
     font-weight: 600;
 }
 
 .empty-dashboard-state p, .error-state p {
-    color: rgba(255, 255, 255, 0.45);
+    color: var(--text-muted);
     font-size: 0.88rem;
     line-height: 1.5;
     margin: 0 0 2rem 0;
@@ -189,25 +188,25 @@
     flex-grow: 1;
     padding: 3rem;
     text-align: center;
-    color: rgba(255, 255, 255, 0.4);
+    color: var(--text-muted);
 }
 
 .empty-glowing-brain {
     width: 80px;
     height: 80px;
     border-radius: 50%;
-    background: rgba(0, 255, 153, 0.04);
-    border: 1px solid rgba(0, 255, 153, 0.15);
+    background: var(--accent-glow);
+    border: 1px solid var(--accent);
     display: flex;
     align-items: center;
     justify-content: center;
     margin-bottom: 1.5rem;
-    box-shadow: 0 0 20px var(--nexus-primary-glow);
+    box-shadow: 0 0 20px var(--accent-glow);
 }
 
 .workspace-empty h4 {
     margin: 0 0 0.75rem 0;
-    color: #fff;
+    color: var(--text-main);
     font-size: 1.1rem;
     font-weight: 600;
 }
@@ -227,7 +226,7 @@
 
 .workspace-header {
     padding: 1.5rem;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    border-bottom: 1px solid var(--border);
 }
 
 .node-meta {
@@ -242,7 +241,7 @@
     font-size: 0.75rem;
     font-weight: 700;
     letter-spacing: 0.08em;
-    color: var(--nexus-neon);
+    color: var(--accent);
 }
 
 .badge {
@@ -256,22 +255,22 @@
 }
 
 .badge-unlocked {
-    background: rgba(0, 255, 153, 0.08);
-    color: var(--nexus-neon);
-    border: 1px solid rgba(0, 255, 153, 0.2);
+    background: var(--accent-glow);
+    color: var(--accent);
+    border: 1px solid var(--accent);
 }
 
 .badge-locked {
-    background: rgba(255, 255, 255, 0.05);
-    color: rgba(255, 255, 255, 0.4);
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-base);
+    color: var(--text-muted);
+    border: 1px solid var(--border);
 }
 
 .workspace-title {
     margin: 0;
     font-size: 1.4rem;
     font-weight: 700;
-    color: #fff;
+    color: var(--text-main);
 }
 
 .workspace-body {
@@ -291,22 +290,22 @@
     background: transparent;
 }
 .workspace-body::-webkit-scrollbar-thumb {
-    background: rgba(255, 255, 255, 0.08);
+    background: var(--border);
     border-radius: 3px;
 }
 .workspace-body::-webkit-scrollbar-thumb:hover {
-    background: var(--nexus-neon);
+    background: var(--accent);
 }
 
 .locked-warning {
     display: flex;
     flex-direction: row;
     gap: 1rem;
-    background: rgba(255, 171, 0, 0.04);
-    border: 1px solid rgba(255, 171, 0, 0.15);
+    background: rgba(217, 119, 6, 0.05);
+    border: 1px solid rgba(217, 119, 6, 0.15);
     border-radius: 8px;
     padding: 1rem;
-    color: rgba(255, 255, 255, 0.85);
+    color: var(--text-main);
 }
 
 .lock-warning-icon {
@@ -326,14 +325,14 @@
     margin: 0;
     font-size: 0.8rem;
     line-height: 1.4;
-    color: rgba(255, 255, 255, 0.55);
+    color: var(--text-muted);
 }
 
 .metadata-section h4 {
     margin: 0 0 0.5rem 0;
     font-size: 0.85rem;
     font-weight: 600;
-    color: #aaa;
+    color: var(--text-muted);
     display: flex;
     align-items: center;
     gap: 0.35rem;
@@ -345,12 +344,12 @@
     margin: 0;
     font-size: 0.88rem;
     line-height: 1.6;
-    color: rgba(255, 255, 255, 0.7);
+    color: var(--text-main);
 }
 
 .summary-box {
-    background: rgba(255, 255, 255, 0.02);
-    border-left: 3px solid var(--nexus-neon);
+    background: var(--bg-base);
+    border-left: 3px solid var(--accent);
     border-radius: 0 8px 8px 0;
     padding: 1rem;
     margin-top: 0.25rem;
@@ -365,9 +364,9 @@
 
 .term-pill {
     font-size: 0.75rem;
-    background: rgba(255, 255, 255, 0.03);
-    border: 1px solid rgba(255, 255, 255, 0.05);
-    color: rgba(255, 255, 255, 0.6);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
+    color: var(--text-muted);
     padding: 0.3rem 0.75rem;
     border-radius: 20px;
     font-weight: 500;
@@ -375,14 +374,14 @@
 }
 
 .term-pill:hover {
-    border-color: rgba(0, 255, 153, 0.2);
-    color: var(--nexus-neon);
-    background: rgba(0, 255, 153, 0.03);
+    border-color: var(--accent);
+    color: var(--accent);
+    background: var(--accent-glow);
 }
 
 .workspace-footer {
     padding: 1.25rem 1.5rem;
-    border-top: 1px solid rgba(255, 255, 255, 0.05);
+    border-top: 1px solid var(--border);
 }
 
 @media (max-width: 1024px) {
@@ -403,3 +402,68 @@
         justify-content: center;
     }
 }
+
+/* ============================================
+   Light Theme Overrides — Warm Paper / Soft Sepia
+   ============================================ */
+
+/* Dashboard header — warm sepia shadow instead of pure black */
+.theme-light .dashboard-header {
+    box-shadow: 0 4px 30px rgba(139, 130, 115, 0.05);
+}
+
+/* Neon pulse icon — disable glow filter entirely */
+.theme-light .neon-pulse {
+    filter: none;
+}
+
+/* Override the neon pulse keyframe states in light mode */
+.theme-light .neon-pulse {
+    animation-name: robot-pulse-light;
+}
+
+@keyframes robot-pulse-light {
+    0% { transform: scale(1); filter: none; }
+    50% { transform: scale(1.08); filter: none; }
+    100% { transform: scale(1); filter: none; }
+}
+
+/* Scan line — reduce glow intensity */
+.theme-light .scan-line {
+    box-shadow: 0 0 8px rgba(16, 185, 129, 0.3);
+    opacity: 0.5;
+}
+
+/* Glowing brain empty state — subtle warm glow */
+.theme-light .empty-glowing-brain {
+    box-shadow: 0 0 12px rgba(16, 185, 129, 0.1);
+}
+
+/* Error icon — reduce drop-shadow intensity */
+.theme-light .error-icon {
+    filter: drop-shadow(0 0 4px rgba(255, 74, 74, 0.2));
+}
+
+/* Back button hover — warm glow instead of neon */
+.theme-light .header-back .btn-back:hover {
+    box-shadow: 0 0 8px rgba(16, 185, 129, 0.1);
+}
+
+/* Action button hover — warm glow */
+.theme-light .header-actions .btn-action:hover {
+    box-shadow: 0 0 12px rgba(16, 185, 129, 0.1);
+}
+
+@media (max-width: 767px) {
+    .concepts-dashboard-container {
+        padding: 1rem 0.75rem calc(1.5rem + 72px + env(safe-area-inset-bottom, 0px)) !important;
+        gap: 1rem;
+    }
+    .dashboard-header {
+        padding: 1rem;
+        gap: 0.75rem;
+    }
+    .header-title h1 {
+        font-size: 1.25rem;
+    }
+}

src/NexusReader.UI.Shared/Pages/CreatorDashboard.razor

@@ -0,0 +1,542 @@
+@page "/creator"
+@attribute [Authorize]
+@using System.Net.Http.Json
+@using Microsoft.Extensions.Logging
+@using System.ComponentModel.DataAnnotations
+@using NexusReader.Application.DTOs.Creator
+@inject HttpClient Http
+@inject NavigationManager NavigationManager
+@inject ILogger<CreatorDashboard> Logger
+
+<PageTitle>Creator Dashboard | Nexus Reader</PageTitle>
+
+<div class="dashboard-container">
+    <header class="dashboard-header">
+        <div class="header-visual">
+            <h1 class="dashboard-title">Panel Autora</h1>
+            <p class="subtitle">Monitoruj zaangażowanie czytelników i publikuj wersje zamrożone z poziomu kontroli wersji.</p>
+        </div>
+    </header>
+
+    <main class="dashboard-content">
+        <!-- Metrics Section -->
+        <section class="metrics-grid">
+            @if (_isLoading)
+            {
+                @for (int i = 0; i < 4; i++)
+                {
+                    <div class="metric-card skeleton-card">
+                        <div class="skeleton-line label"></div>
+                        <div class="skeleton-line value"></div>
+                    </div>
+                }
+            }
+            else if (_dashboardData != null)
+            {
+                <div class="metric-card glass-panel">
+                    <span class="metric-label">Całkowite Odczyty</span>
+                    <h2 class="metric-value">@_dashboardData.Metrics.TotalReads</h2>
+                    <div class="metric-trend positive">
+                        <span class="trend-icon">↑</span>
+                        <span class="trend-text">System stabilny</span>
+                    </div>
+                </div>
+
+                <div class="metric-card glass-panel">
+                    <span class="metric-label">Średni Czas Czytania</span>
+                    <h2 class="metric-value">@_dashboardData.Metrics.AvgReadTimeMinutes min</h2>
+                    <div class="metric-trend neutral">
+                        <span class="trend-icon">→</span>
+                        <span class="trend-text">Na rozdział</span>
+                    </div>
+                </div>
+
+                <div class="metric-card glass-panel">
+                    <div class="metric-label-container">
+                        <span class="metric-label">Aktywni Czytelnicy</span>
+                        <div class="pulse-indicator">
+                            <span class="pulse-dot"></span>
+                            <span class="pulse-text">Live Now</span>
+                        </div>
+                    </div>
+                    <h2 class="metric-value">@_dashboardData.Metrics.ActiveReaders</h2>
+                    <div class="metric-trend positive">
+                        <span class="trend-icon">↑</span>
+                        <span class="trend-text">Ruch w czasie rzeczywistym</span>
+                    </div>
+                </div>
+
+                <div class="metric-card glass-panel">
+                    <span class="metric-label">Przychód Gross</span>
+                    <h2 class="metric-value">@_dashboardData.Metrics.GrossRevenue.ToString("C2")</h2>
+                    <div class="metric-trend positive">
+                        <span class="trend-icon">↑</span>
+                        <span class="trend-text">Rozliczenia w toku</span>
+                    </div>
+                </div>
+            }
+        </section>
+
+        <!-- Publication Cards Grid Section -->
+        <section class="publications-section">
+            <div class="section-header">
+                <h2>Twoje Publikacje</h2>
+                <button type="button" class="btn-nexus primary glow-btn" @onclick="OpenCreateBookModal">
+                    [ + Nowa Publikacja ]
+                </button>
+            </div>
+
+            @if (_isLoading)
+            {
+                <div class="books-grid">
+                    @for (int i = 0; i < 3; i++)
+                    {
+                        <div class="book-card skeleton-card">
+                            <div class="skeleton-card-header"></div>
+                            <div class="skeleton-line title"></div>
+                            <div class="skeleton-line metadata"></div>
+                            <div class="skeleton-card-actions"></div>
+                        </div>
+                    }
+                </div>
+            }
+            else if (_dashboardData == null || !_dashboardData.Books.Any())
+            {
+                <div class="empty-state glass-panel">
+                    <div class="empty-icon">
+                        <svg width="64" height="64" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">
+                            <path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"></path>
+                            <path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"></path>
+                        </svg>
+                    </div>
+                    <h3>Brak publikacji</h3>
+                    <p>Nie utworzyłeś jeszcze żadnych książek do autorskiej edycji.</p>
+                    <button type="button" class="btn-nexus primary glow-btn" style="margin-top: 1.5rem;" @onclick="OpenCreateBookModal">
+                        [ + Nowa Publikacja ]
+                    </button>
+                </div>
+            }
+            else
+            {
+                <div class="books-grid">
+                    @foreach (var book in _dashboardData.Books)
+                    {
+                        <div class="book-card glass-panel">
+                            <div class="card-glow"></div>
+                            <div class="book-card-header">
+                                <h3 class="book-title" title="@book.Title">@book.Title</h3>
+                                <div class="badges-row">
+                                    @if (book.LivePublishedRevision != null)
+                                    {
+                                        <span class="badge badge-published" title="Opublikowana wersja dostępna dla czytelników">
+                                            Live @book.LivePublishedRevision.VersionString
+                                        </span>
+                                    }
+                                    @if (book.CurrentDraftRevision != null)
+                                    {
+                                        <span class="badge badge-draft pulsing" title="Szkic roboczy z nieopublikowanymi zmianami">
+                                            Szkic
+                                        </span>
+                                    }
+                                </div>
+                            </div>
+
+                            <div class="book-telemetry">
+                                <div class="telemetry-item">
+                                    <span class="telemetry-label">Słowa:</span>
+                                    <span class="telemetry-value">@book.WordCount.ToString("N0")</span>
+                                </div>
+                                <div class="telemetry-item">
+                                    <span class="telemetry-label">Wyświetlenia:</span>
+                                    <span class="telemetry-value">@book.AggregatedReads.ToString("N0")</span>
+                                </div>
+                            </div>
+
+                            <div class="book-card-actions">
+                                <button type="button" class="btn-nexus secondary" @onclick="() => NavigateToEditor(book)">
+                                    Edytuj szkic
+                                </button>
+                                <button type="button" class="btn-nexus primary glow-btn" @onclick="() => OpenPublishModal(book)">
+                                    Publikuj
+                                </button>
+                                <button type="button" class="btn-nexus link-btn" @onclick="() => OpenRevisionsModalAsync(book)">
+                                    Rejestr zmian
+                                </button>
+                            </div>
+                        </div>
+                    }
+                </div>
+            }
+        </section>
+    </main>
+</div>
+
+<!-- Defensively-Scoped Version Publish Modal -->
+@if (_isPublishModalOpen && _activePublishBookId.HasValue)
+{
+    <div class="modal-backdrop" @onclick="ClosePublishModal">
+        <div class="modal-content glass-panel" @onclick:stopPropagation>
+            <div class="modal-header">
+                <h3>Publikowanie Nowej Wersji</h3>
+                <button class="close-btn" @onclick="ClosePublishModal">&times;</button>
+            </div>
+            <div class="modal-body">
+                <p>Zamrażasz obecny szkic książki <strong>@_activePublishBookTitle</strong> jako nową wersję publiczną.</p>
+                <div class="form-group">
+                    <label for="versionInput">Sygnatura Wersji (np. v1.0.0)</label>
+                    <input id="versionInput" type="text" class="form-control" @bind="_customVersionString" @bind:event="oninput" placeholder="Wpisz tag wersji..." />
+                </div>
+                @if (!string.IsNullOrEmpty(_errorMessage))
+                {
+                    <div class="error-banner">@_errorMessage</div>
+                }
+            </div>
+            <div class="modal-footer">
+                <button type="button" class="btn-nexus secondary" @onclick="ClosePublishModal">Anuluj</button>
+                <button type="button" class="btn-nexus primary glow-btn" @onclick="SubmitPublishVersionAsync" disabled="@_isSubmitting">
+                    @(_isSubmitting ? "Wysyłanie..." : "Zatwierdź wersję")
+                </button>
+            </div>
+        </div>
+    </div>
+}
+
+<!-- Manage Revisions Modal -->
+@if (_isRevisionsModalOpen && _activeRevisionsBookId.HasValue)
+{
+    <div class="modal-backdrop" @onclick="CloseRevisionsModal">
+        <div class="modal-content glass-panel" @onclick:stopPropagation>
+            <div class="modal-header">
+                <h3>Rejestr Rewizji: @_activeRevisionsBookTitle</h3>
+                <button class="close-btn" @onclick="CloseRevisionsModal">&times;</button>
+            </div>
+            <div class="modal-body">
+                @if (_revisionsLoading)
+                {
+                    <div class="spinner-container">
+                        <div class="spinner-glow small"></div>
+                        <span>Wczytywanie historii...</span>
+                    </div>
+                }
+                else if (_revisionsList == null || !_revisionsList.Any())
+                {
+                    <p class="empty-revisions">Brak zarejestrowanych rewizji.</p>
+                }
+                else
+                {
+                    <div class="revisions-list">
+                        @foreach (var revision in _revisionsList)
+                        {
+                            <div class="revision-item">
+                                <div class="revision-header">
+                                    <span class="revision-tag @(revision.IsPublished ? "published" : "draft")">
+                                        @(revision.IsPublished ? revision.VersionString : "Szkic roboczy")
+                                    </span>
+                                    <span class="revision-date">
+                                        @(revision.PublishedAt.HasValue ? revision.PublishedAt.Value.ToString("g") : revision.CreatedAt.ToString("g"))
+                                    </span>
+                                </div>
+                                <div class="revision-meta">
+                                    <span>Utworzono: @revision.CreatedAt.ToString("yyyy-MM-dd HH:mm")</span>
+                                </div>
+                            </div>
+                        }
+                    </div>
+                }
+            </div>
+            <div class="modal-footer">
+                <button type="button" class="btn-nexus secondary" @onclick="CloseRevisionsModal">Zamknij</button>
+            </div>
+        </div>
+    </div>
+}
+
+<!-- Create Book Modal -->
+@if (_isCreateBookModalOpen)
+{
+    <div class="modal-backdrop" @onclick="CloseCreateBookModal">
+        <div class="modal-content glass-panel" @onclick:stopPropagation>
+            <div class="modal-header">
+                <h2>Nowa Publikacja</h2>
+                <button class="close-btn" @onclick="CloseCreateBookModal">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
+                </button>
+            </div>
+            <EditForm Model="_createBookModel" OnValidSubmit="SubmitCreateBookAsync">
+                <DataAnnotationsValidator />
+                <div class="modal-body">
+                    <div class="creator-layout">
+                        <!-- Book Cover Preview -->
+                        <div class="cover-preview creator-cover">
+                            <div class="cover-mockup-design">
+                                <div class="cover-accent-line"></div>
+                                <div class="cover-main-content">
+                                    <span class="cover-title-text">
+                                        @(string.IsNullOrWhiteSpace(_createBookModel.Title) ? "Tytuł Książki" : _createBookModel.Title)
+                                    </span>
+                                    <span class="cover-author-text">
+                                        Szkic roboczy
+                                    </span>
+                                </div>
+                                <div class="cover-logo-container">
+                                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"></polygon></svg>
+                                    <span class="cover-brand">Nexus</span>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Form inputs -->
+                        <div class="creator-form-inputs">
+                            <div class="form-group">
+                                <label for="newBookTitle">Tytuł Książki</label>
+                                <InputText id="newBookTitle" class="form-input" @bind-Value="_createBookModel.Title" placeholder="Wpisz tytuł książki..." />
+                                <ValidationMessage For="@(() => _createBookModel.Title)" class="validation-message" />
+                            </div>
+                            <div class="form-group">
+                                <label for="newBookDescription">Opis (opcjonalny)</label>
+                                <InputTextArea id="newBookDescription" class="form-input" @bind-Value="_createBookModel.Description" rows="3" placeholder="Wpisz krótki opis książki..." />
+                                <ValidationMessage For="@(() => _createBookModel.Description)" class="validation-message" />
+                            </div>
+                            @if (!string.IsNullOrEmpty(_createBookError))
+                            {
+                                <div class="error-banner">@_createBookError</div>
+                            }
+                        </div>
+                    </div>
+                </div>
+                <div class="actions">
+                    <button type="button" class="btn-nexus secondary" @onclick="CloseCreateBookModal">Anuluj</button>
+                    <button type="submit" class="btn-nexus primary glow-btn" disabled="@_isCreatingBook">
+                        @(_isCreatingBook ? "Tworzenie..." : "Utwórz książkę")
+                    </button>
+                </div>
+            </EditForm>
+        </div>
+    </div>
+}
+
+@code {
+    private bool _isLoading = true;
+    private CreatorDashboardDataDto? _dashboardData;
+
+    // Create Book Model and state
+    private bool _isCreateBookModalOpen;
+    private CreateBookModel _createBookModel = new();
+    private bool _isCreatingBook;
+    private string? _createBookError;
+
+    // Defensively-scoped state variables for modal isolation
+    private bool _isPublishModalOpen;
+    private Guid? _activePublishBookId;
+    private string _activePublishBookTitle = string.Empty;
+    private string _customVersionString = string.Empty;
+    private bool _isSubmitting;
+    private string? _errorMessage;
+
+    // Revisions modal state variables
+    private bool _isRevisionsModalOpen;
+    private Guid? _activeRevisionsBookId;
+    private string _activeRevisionsBookTitle = string.Empty;
+    private bool _revisionsLoading;
+    private List<CreatorBookRevisionDto> _revisionsList = new();
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (firstRender)
+        {
+            await LoadDashboardDataAsync();
+        }
+    }
+
+    private async Task LoadDashboardDataAsync()
+    {
+        _isLoading = true;
+        StateHasChanged();
+
+        try
+        {
+            _dashboardData = await Http.GetFromJsonAsync<CreatorDashboardDataDto>("api/creator/dashboard");
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Error loading creator dashboard data.");
+        }
+        finally
+        {
+            _isLoading = false;
+            StateHasChanged();
+        }
+    }
+
+    private void NavigateToEditor(CreatorBookDto book)
+    {
+        if (book.FirstChapterId.HasValue)
+        {
+            NavigationManager.NavigateTo($"/creator/edit/{book.Id}/{book.FirstChapterId.Value}");
+        }
+        else
+        {
+            NavigationManager.NavigateTo($"/creator/edit/{book.Id}");
+        }
+    }
+
+    private void OpenPublishModal(CreatorBookDto book)
+    {
+        // Explicitly lock context boundaries to the selected book
+        _activePublishBookId = book.Id;
+        _activePublishBookTitle = book.Title;
+        _customVersionString = "v1.0.0";
+        _errorMessage = null;
+        _isPublishModalOpen = true;
+    }
+
+    private void ClosePublishModal()
+    {
+        _isPublishModalOpen = false;
+        _activePublishBookId = null;
+        _activePublishBookTitle = string.Empty;
+        _customVersionString = string.Empty;
+        _errorMessage = null;
+    }
+
+    private async Task SubmitPublishVersionAsync()
+    {
+        if (!_activePublishBookId.HasValue || string.IsNullOrWhiteSpace(_customVersionString))
+        {
+            return;
+        }
+
+        _isSubmitting = true;
+        _errorMessage = null;
+        StateHasChanged();
+
+        try
+        {
+            // Explicitly lock the parameters during sending execution
+            var bookId = _activePublishBookId.Value;
+            var response = await Http.PostAsync($"api/creator/books/{bookId}/publish?version={Uri.EscapeDataString(_customVersionString)}", null);
+
+            if (response.IsSuccessStatusCode)
+            {
+                ClosePublishModal();
+                await LoadDashboardDataAsync();
+            }
+            else
+            {
+                _errorMessage = await response.Content.ReadAsStringAsync();
+                if (string.IsNullOrWhiteSpace(_errorMessage))
+                {
+                    _errorMessage = "Publish version endpoint returned an error.";
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Exception thrown during publication.");
+            _errorMessage = $"Mutation failed: {ex.Message}";
+        }
+        finally
+        {
+            _isSubmitting = false;
+            StateHasChanged();
+        }
+    }
+
+    private async Task OpenRevisionsModalAsync(CreatorBookDto book)
+    {
+        _activeRevisionsBookId = book.Id;
+        _activeRevisionsBookTitle = book.Title;
+        _revisionsList = new();
+        _revisionsLoading = true;
+        _isRevisionsModalOpen = true;
+        StateHasChanged();
+
+        try
+        {
+            _revisionsList = await Http.GetFromJsonAsync<List<CreatorBookRevisionDto>>($"api/creator/books/{book.Id}/revisions") ?? new();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to load revisions.");
+        }
+        finally
+        {
+            _revisionsLoading = false;
+            StateHasChanged();
+        }
+    }
+
+    private void CloseRevisionsModal()
+    {
+        _isRevisionsModalOpen = false;
+        _activeRevisionsBookId = null;
+        _activeRevisionsBookTitle = string.Empty;
+        _revisionsList.Clear();
+    }
+
+    private void OpenCreateBookModal()
+    {
+        _createBookModel = new CreateBookModel();
+        _createBookError = null;
+        _isCreateBookModalOpen = true;
+    }
+
+    private void CloseCreateBookModal()
+    {
+        _isCreateBookModalOpen = false;
+        _createBookError = null;
+    }
+
+    private async Task SubmitCreateBookAsync()
+    {
+        _isCreatingBook = true;
+        _createBookError = null;
+        StateHasChanged();
+
+        try
+        {
+            var response = await Http.PostAsJsonAsync("api/creator/books", _createBookModel);
+            if (response.IsSuccessStatusCode)
+            {
+                var result = await response.Content.ReadFromJsonAsync<CreateBookResponseDto>();
+                if (result != null)
+                {
+                    // Reset modal state BEFORE routing to prevent it lingering in the DOM tree
+                    _isCreateBookModalOpen = false;
+                    _createBookError = null;
+                    StateHasChanged();
+
+                    NavigationManager.NavigateTo($"/creator/edit/{result.BookId}");
+                }
+                else
+                {
+                    _createBookError = "Otrzymano nieprawidłową odpowiedź z serwera.";
+                }
+            }
+            else
+            {
+                var errorMsg = await response.Content.ReadAsStringAsync();
+                _createBookError = !string.IsNullOrWhiteSpace(errorMsg) ? errorMsg : "Wystąpił błąd podczas tworzenia książki.";
+            }
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Błąd podczas tworzenia książki.");
+            _createBookError = $"Krytyczny błąd: {ex.Message}";
+        }
+        finally
+        {
+            _isCreatingBook = false;
+            StateHasChanged();
+        }
+    }
+
+    public class CreateBookModel
+    {
+        [Required(ErrorMessage = "Tytuł książki jest wymagany.")]
+        [StringLength(255, ErrorMessage = "Tytuł książki nie może przekraczać 255 znaków.")]
+        public string Title { get; set; } = string.Empty;
+
+        public string? Description { get; set; }
+    }
+}

src/NexusReader.UI.Shared/Pages/CreatorDashboard.razor.css

@@ -0,0 +1,763 @@
+.dashboard-container {
+    min-height: 100%;
+    display: flex;
+    flex-direction: column;
+    animation: fade-in 0.6s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+@keyframes fade-in {
+    from { opacity: 0; transform: translateY(15px); }
+    to { opacity: 1; transform: translateY(0); }
+}
+
+/* --- Dashboard Header --- */
+.dashboard-header {
+    padding: 3rem 2rem 2rem;
+    background: var(--bg-surface);
+    border-bottom: 1px solid var(--border);
+    position: relative;
+    overflow: hidden;
+}
+
+.dashboard-title {
+    font-family: var(--nexus-font-serif, serif);
+    font-size: 2.25rem;
+    font-weight: 700;
+    color: var(--text-main);
+    margin-bottom: 0.5rem;
+}
+
+.subtitle {
+    font-size: 0.95rem;
+    color: var(--text-muted);
+    max-width: 600px;
+    line-height: 1.5;
+}
+
+/* --- Main Content Layout --- */
+.dashboard-content {
+    padding: 2.5rem 2rem;
+    max-width: 1200px;
+    margin: 0 auto;
+    width: 100%;
+    display: flex;
+    flex-direction: column;
+    gap: 3rem;
+}
+
+/* --- Metrics Grid --- */
+.metrics-grid {
+    display: grid;
+    grid-template-columns: repeat(1, minmax(0, 1fr));
+    gap: 1.5rem;
+}
+
+@media (min-width: 768px) {
+    .metrics-grid {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+}
+
+@media (min-width: 1024px) {
+    .metrics-grid {
+        grid-template-columns: repeat(4, minmax(0, 1fr));
+    }
+}
+
+.metric-card {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    padding: 1.5rem;
+    position: relative;
+}
+
+.metric-label-container {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+}
+
+.metric-label {
+    font-size: 0.85rem;
+    font-weight: 500;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+}
+
+.metric-value {
+    font-size: 1.85rem;
+    font-weight: 700;
+    color: var(--text-main);
+    margin: 0.25rem 0;
+}
+
+.metric-trend {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+    font-size: 0.75rem;
+}
+
+.metric-trend.positive {
+    color: var(--nexus-neon);
+}
+
+.metric-trend.neutral {
+    color: var(--text-muted);
+}
+
+/* Glassmorphism Panel styles */
+.glass-panel {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    box-shadow: 0 4px 30px rgba(0, 0, 0, 0.03);
+    backdrop-filter: blur(10px);
+    -webkit-backdrop-filter: blur(10px);
+    transition: transform 0.2s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.glass-panel:hover {
+    transform: translateY(-4px);
+    border-color: var(--accent);
+    box-shadow: 0 10px 30px rgba(16, 185, 129, 0.06);
+}
+
+/* --- Pulsing indicator --- */
+.pulse-indicator {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    background: rgba(255, 68, 68, 0.1);
+    border: 1px solid rgba(255, 68, 68, 0.3);
+    border-radius: 100px;
+    padding: 2px 8px;
+}
+
+.pulse-dot {
+    width: 6px;
+    height: 6px;
+    background-color: #ff4444;
+    border-radius: 50%;
+    animation: beacon-pulse 1.8s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+}
+
+.pulse-text {
+    font-size: 0.65rem;
+    font-weight: 700;
+    color: #ff4444;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+}
+
+@keyframes beacon-pulse {
+    0%, 100% { opacity: 1; transform: scale(1); }
+    50% { opacity: 0.4; transform: scale(1.3); }
+}
+
+/* --- Publications Section --- */
+.publications-section {
+    display: flex;
+    flex-direction: column;
+    gap: 1.5rem;
+}
+
+.section-header h2 {
+    font-family: var(--nexus-font-serif, serif);
+    font-size: 1.5rem;
+    font-weight: 600;
+    color: var(--text-main);
+    margin: 0;
+}
+
+/* --- Publication Grid & Cards --- */
+.books-grid {
+    display: grid;
+    grid-template-columns: repeat(1, minmax(0, 1fr));
+    gap: 1.5rem;
+}
+
+@media (min-width: 768px) {
+    .books-grid {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+}
+
+@media (min-width: 1024px) {
+    .books-grid {
+        grid-template-columns: repeat(3, minmax(0, 1fr));
+    }
+}
+
+.book-card {
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    gap: 1.5rem;
+    padding: 1.5rem;
+    position: relative;
+    overflow: hidden;
+}
+
+.card-glow {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 3px;
+    background: linear-gradient(90deg, var(--border), var(--accent), var(--border));
+    opacity: 0.4;
+}
+
+.book-card:hover .card-glow {
+    opacity: 1;
+    background: linear-gradient(90deg, var(--accent), var(--nexus-neon), var(--accent));
+}
+
+.book-card-header {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+}
+
+.book-title {
+    font-size: 1.15rem;
+    font-weight: 600;
+    color: var(--text-main);
+    margin: 0;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.badges-row {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.5rem;
+}
+
+.badge {
+    padding: 0.25rem 0.6rem;
+    border-radius: 6px;
+    font-size: 0.7rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    border: 1px solid transparent;
+}
+
+.badge-published {
+    background: rgba(16, 185, 129, 0.1);
+    color: var(--nexus-neon);
+    border-color: rgba(16, 185, 129, 0.3);
+}
+
+.badge-draft {
+    background: rgba(245, 158, 11, 0.1);
+    color: #f59e0b;
+    border-color: rgba(245, 158, 11, 0.3);
+}
+
+.badge-draft.pulsing {
+    animation: draft-pulse 2s infinite ease-in-out;
+}
+
+@keyframes draft-pulse {
+    0%, 100% { box-shadow: 0 0 0 0 rgba(245, 158, 11, 0.2); }
+    50% { box-shadow: 0 0 8px 2px rgba(245, 158, 11, 0.4); }
+}
+
+.book-telemetry {
+    display: flex;
+    justify-content: space-between;
+    padding: 0.75rem 0;
+    border-top: 1px dashed var(--border);
+    border-bottom: 1px dashed var(--border);
+}
+
+.telemetry-item {
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+}
+
+.telemetry-label {
+    font-size: 0.75rem;
+    color: var(--text-muted);
+}
+
+.telemetry-value {
+    font-size: 0.95rem;
+    font-weight: 600;
+    color: var(--text-main);
+}
+
+.book-card-actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.75rem;
+    margin-top: 0.5rem;
+}
+
+.book-card-actions .btn-nexus {
+    flex: 1;
+    min-width: 90px;
+    text-align: center;
+    justify-content: center;
+}
+
+.book-card-actions .link-btn {
+    flex: unset;
+    width: 100%;
+}
+
+/* --- Buttons --- */
+.btn-nexus {
+    padding: 0.6rem 1.1rem;
+    border-radius: 8px;
+    font-size: 0.85rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+    border: none;
+    display: inline-flex;
+    align-items: center;
+}
+
+.btn-nexus.primary {
+    background: #10b981;
+    color: #000;
+}
+
+.btn-nexus.secondary {
+    background: var(--bg-base);
+    color: var(--text-main);
+    border: 1px solid var(--border);
+}
+
+.btn-nexus.link-btn {
+    background: transparent;
+    color: var(--text-muted);
+    border: none;
+    font-size: 0.8rem;
+    padding: 0.25rem 0.5rem;
+    text-decoration: underline;
+}
+
+.btn-nexus:hover {
+    transform: translateY(-2px);
+}
+
+.btn-nexus.primary:hover {
+    filter: brightness(1.15);
+}
+
+.btn-nexus.secondary:hover {
+    border-color: var(--accent);
+    background: var(--bg-surface);
+}
+
+.btn-nexus.link-btn:hover {
+    color: var(--text-main);
+}
+
+.btn-nexus.glow-btn {
+    position: relative;
+    box-shadow: 0 0 10px rgba(16, 185, 129, 0.2);
+}
+
+.btn-nexus.glow-btn:hover {
+    box-shadow: 0 0 20px rgba(16, 185, 129, 0.4);
+}
+
+/* --- Modal styles --- */
+.modal-backdrop {
+    position: fixed;
+    inset: 0;
+    background: rgba(0, 0, 0, 0.7);
+    backdrop-filter: blur(5px);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    z-index: 1000;
+    animation: fade-in-backdrop 0.3s ease;
+}
+
+/* --- Modal Content & Header --- */
+.modal-content {
+    width: 90%;
+    max-width: 620px; /* Wider split layout */
+    max-height: 90vh;
+    display: flex;
+    flex-direction: column;
+    padding: 2rem !important;
+    animation: modal-slide 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    box-shadow: 0 20px 50px rgba(0, 0, 0, 0.3);
+}
+
+@keyframes fade-in-backdrop {
+    from { opacity: 0; }
+    to { opacity: 1; }
+}
+
+@keyframes modal-slide {
+    from { opacity: 0; transform: translateY(-30px); }
+    to { opacity: 1; transform: translateY(0); }
+}
+
+.modal-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 1.5rem;
+}
+
+.modal-header h2, .modal-header h3 {
+    margin: 0;
+    font-size: 1.5rem;
+    font-weight: 700;
+    color: var(--text-main);
+}
+
+.close-btn {
+    background: transparent;
+    border: none;
+    color: var(--text-muted);
+    cursor: pointer;
+    transition: all 0.2s;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0;
+}
+
+.close-btn:hover {
+    color: #10b981;
+    transform: rotate(90deg);
+}
+
+.modal-body {
+    flex: 1;
+    overflow-y: auto;
+    margin-bottom: 1.5rem;
+}
+
+.form-group {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    margin-top: 1rem;
+}
+
+.form-group label {
+    font-size: 0.75rem;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 1px;
+    color: var(--text-muted);
+}
+
+.form-control, .form-input, ::deep .form-control, ::deep .form-input {
+    padding: 0.75rem 1rem;
+    background: rgba(255, 255, 255, 0.03) !important;
+    border: 1px solid rgba(255, 255, 255, 0.1) !important;
+    border-radius: 8px;
+    color: #ffffff !important;
+    font-size: 0.95rem;
+    outline: none;
+    transition: all 0.3s;
+    width: 100%;
+    box-sizing: border-box;
+}
+
+.form-control:focus, .form-input:focus, ::deep .form-control:focus, ::deep .form-input:focus {
+    outline: none;
+    border-color: #10b981 !important;
+    background: rgba(255, 255, 255, 0.06) !important;
+    box-shadow: 0 0 15px rgba(16, 185, 129, 0.2) !important;
+}
+
+.error-banner {
+    margin-top: 1rem;
+    padding: 0.75rem 1rem;
+    background: rgba(255, 68, 68, 0.1);
+    border: 1px solid rgba(255, 68, 68, 0.3);
+    border-radius: 8px;
+    color: #ff4444;
+    font-size: 0.85rem;
+}
+
+.modal-footer {
+    display: flex;
+    justify-content: flex-end;
+    gap: 1rem;
+}
+
+/* --- Revisions list --- */
+.spinner-container {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 2rem;
+    justify-content: center;
+    color: var(--text-muted);
+}
+
+.revisions-list {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+    max-height: 250px;
+    overflow-y: auto;
+    padding-right: 0.25rem;
+}
+
+.revision-item {
+    padding: 0.75rem 1rem;
+    background: var(--bg-base);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+}
+
+.revision-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+}
+
+.revision-tag {
+    font-size: 0.75rem;
+    font-weight: 700;
+}
+
+.revision-tag.published {
+    color: var(--nexus-neon);
+}
+
+.revision-tag.draft {
+    color: #f59e0b;
+}
+
+.revision-date {
+    font-size: 0.75rem;
+    color: var(--text-muted);
+}
+
+.revision-meta {
+    font-size: 0.7rem;
+    color: var(--text-muted);
+}
+
+.empty-revisions {
+    text-align: center;
+    color: var(--text-muted);
+    padding: 2rem;
+}
+
+/* --- Loading skeleton animations --- */
+.skeleton-card {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    position: relative;
+    overflow: hidden;
+}
+
+.skeleton-card::after {
+    content: "";
+    position: absolute;
+    inset: 0;
+    transform: translateX(-100%);
+    background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.05), transparent);
+    animation: skeleton-glow 1.5s infinite;
+}
+
+@keyframes skeleton-glow {
+    100% { transform: translateX(100%); }
+}
+
+.skeleton-line {
+    background: rgba(255, 255, 255, 0.05);
+    border-radius: 4px;
+}
+
+.skeleton-line.label {
+    width: 60%;
+    height: 12px;
+    margin-bottom: 0.75rem;
+}
+
+.skeleton-line.value {
+    width: 40%;
+    height: 24px;
+}
+
+.skeleton-card-header {
+    height: 4px;
+    background: rgba(255, 255, 255, 0.05);
+}
+
+.skeleton-line.title {
+    width: 70%;
+    height: 16px;
+    margin: 1.5rem 1.5rem 0.5rem;
+}
+
+.skeleton-line.metadata {
+    width: 40%;
+    height: 12px;
+    margin: 0 1.5rem 1.5rem;
+}
+
+.skeleton-card-actions {
+    height: 38px;
+    background: rgba(255, 255, 255, 0.03);
+    margin-top: auto;
+}
+
+/* --- Mobile View Adjustments --- */
+@media (max-width: 767px) {
+    .dashboard-header {
+        padding: 1.5rem 1rem 1rem;
+    }
+
+    .dashboard-title {
+        font-size: 1.75rem;
+    }
+
+    .dashboard-content {
+        padding: 1.5rem 1rem;
+        gap: 2rem;
+    }
+
+    .book-card-actions {
+        flex-direction: column;
+    }
+
+    .book-card-actions .btn-nexus {
+        width: 100%;
+        justify-content: center;
+    }
+}
+
+.validation-message {
+    color: #ff4444;
+    font-size: 0.8rem;
+    margin-top: 0.25rem;
+}
+
+/* Split Layout for Creator Modal */
+.creator-layout {
+    display: grid;
+    grid-template-columns: 140px 1fr;
+    gap: 2rem;
+    align-items: start;
+    margin-top: 0.5rem;
+}
+
+.creator-cover {
+    width: 140px;
+    height: 200px;
+    border-radius: 12px;
+    overflow: hidden;
+    background: linear-gradient(135deg, #1f2937 0%, #111827 100%);
+    border: 1px solid rgba(255, 255, 255, 0.08);
+    box-shadow: 0 15px 35px rgba(0, 0, 0, 0.4);
+    position: relative;
+    user-select: none;
+    box-sizing: border-box;
+}
+
+.cover-mockup-design {
+    width: 100%;
+    height: 100%;
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    padding: 1.5rem 1rem;
+    box-sizing: border-box;
+    position: relative;
+}
+
+.cover-accent-line {
+    position: absolute;
+    top: 0;
+    left: 10px;
+    width: 2px;
+    height: 100%;
+    background: rgba(16, 185, 129, 0.2); /* green accent line */
+    box-shadow: 0 0 8px rgba(16, 185, 129, 0.15);
+}
+
+.cover-main-content {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+    z-index: 2;
+    margin-top: 1rem;
+    text-align: center;
+}
+
+.cover-title-text {
+    font-size: 0.8rem;
+    font-weight: 700;
+    color: #ffffff;
+    line-height: 1.4;
+    display: -webkit-box;
+    -webkit-line-clamp: 4;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    word-break: break-word;
+}
+
+.cover-author-text {
+    font-size: 0.6rem;
+    color: #9ca3af;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+.cover-logo-container {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.25rem;
+    z-index: 2;
+    color: #10b981;
+    opacity: 0.9;
+}
+
+.cover-logo-container svg {
+    width: 12px;
+    height: 12px;
+    fill: currentColor;
+}
+
+.cover-brand {
+    font-size: 0.65rem;
+    font-weight: 700;
+    letter-spacing: 1px;
+    text-transform: uppercase;
+}
+
+.creator-form-inputs {
+    display: flex;
+    flex-direction: column;
+    gap: 1.25rem;
+}
+
+.actions {
+    display: flex;
+    justify-content: center;
+    gap: 1rem;
+    margin-top: 1.5rem;
+}
+
+

src/NexusReader.UI.Shared/Pages/CreatorEdit.razor

@@ -0,0 +1,186 @@
+@page "/creator/edit/{BookId}"
+@page "/creator/edit/{BookId}/{ChapterId}"
+@layout MainHubLayout
+@attribute [Authorize]
+@using NexusReader.UI.Shared.Components
+
+@if (_loadingChapters)
+{
+    <div class="hub-loading" style="height: calc(100vh - 4rem); display: flex; flex-direction: column; justify-content: center; align-items: center; background-color: var(--bg-base);">
+        <div class="nexus-loader"></div>
+        <p style="margin-top: 1rem; color: var(--text-muted); font-family: var(--nexus-font-sans);">Ładowanie struktury książki...</p>
+    </div>
+}
+else
+{
+    <div class="creator-edit-fullscreen-wrapper">
+        
+        <div class="chapters-sidebar">
+            <div class="sidebar-meta-header">
+                <h2>Rozdziały</h2>
+            </div>
+            <div class="chapters-list-wrapper">
+                @foreach (var ch in _chapters)
+                {
+                    var isActive = ch.Id == _activeChapterId;
+                    <a class="chapter-item @(isActive ? "active" : "")" href="/creator/edit/@BookId/@ch.Id">
+                        @if (isActive)
+                        {
+                            <div class="active-indicator"></div>
+                            <i class="fa-solid fa-book-open chapter-icon"></i>
+                        }
+                        else
+                        {
+                            <i class="fa-solid fa-file-lines chapter-icon"></i>
+                        }
+                        <span class="chapter-title-text">@ch.Title</span>
+                    </a>
+                }
+            </div>
+        </div>
+
+        <div class="editor-workspace-area">
+            
+            <div class="editor-header-row">
+                <div class="title-zone">
+                    <h1 class="chapter-title">@_activeChapterTitle</h1>
+                </div>
+                <div class="telemetry-zone">
+                    <span class="chapter-id-badge">ID: @_activeChapterId</span>
+                </div>
+            </div>
+
+            <div class="editor-canvas-card">
+                @if (_loadingChapter)
+                {
+                    <div class="hub-loading" style="height: 100%; display: flex; flex-direction: column; justify-content: center; align-items: center;">
+                        <div class="nexus-loader"></div>
+                        <p style="margin-top: 1rem; color: var(--text-muted); font-family: var(--nexus-font-sans);">Wczytywanie treści rozdziału...</p>
+                    </div>
+                }
+                else if (_isChapterLoaded)
+                {
+                    <div class="milkdown-premium-container" spellcheck="false">
+                        <MarkdownEditor @key="_activeChapterId"
+                                        ChapterId="_activeChapterId"
+                                        InitialMarkdown="@_initialMarkdown"
+                                        ShowFetchButton="false" />
+                    </div>
+                }
+                else
+                {
+                    <div style="height: 100%; display: flex; flex-direction: column; justify-content: center; align-items: center; color: var(--text-muted); font-family: var(--nexus-font-sans);">
+                        <p>Wybierz lub utwórz rozdział, aby rozpocząć edycję.</p>
+                    </div>
+                }
+            </div>
+        </div>
+    </div>
+}
+
+@code {
+    [Inject] private HttpClient Http { get; set; } = default!;
+    [Inject] private NavigationManager NavigationManager { get; set; } = default!;
+
+    [Parameter] public string BookId { get; set; } = string.Empty;
+    [Parameter] public string ChapterId { get; set; } = string.Empty;
+
+    private List<ChapterListItem> _chapters = new();
+    private Guid _parsedBookId = Guid.Empty;
+    private Guid _activeChapterId = Guid.Empty;
+    private string _activeChapterTitle = string.Empty;
+    private string _initialMarkdown = string.Empty;
+    private bool _loadingChapters = true;
+    private bool _loadingChapter = false;
+    private bool _isChapterLoaded = false;
+
+    private class ChapterListItem
+    {
+        public Guid Id { get; set; }
+        public string Title { get; set; } = string.Empty;
+        public int SortOrder { get; set; }
+    }
+
+    private class ChapterDetail
+    {
+        public Guid Id { get; set; }
+        public string Title { get; set; } = string.Empty;
+        public string MarkdownContent { get; set; } = string.Empty;
+    }
+
+    protected override async Task OnParametersSetAsync()
+    {
+        await base.OnParametersSetAsync();
+
+        if (!Guid.TryParse(BookId, out var parsedBookId))
+        {
+            NavigationManager.NavigateTo("/creator");
+            return;
+        }
+
+        _parsedBookId = parsedBookId;
+
+        // Fetch chapters list if empty or if book ID has changed
+        if (_chapters.Count == 0)
+        {
+            _loadingChapters = true;
+            try
+            {
+                var chapters = await Http.GetFromJsonAsync<List<ChapterListItem>>($"/api/creator/books/{_parsedBookId}/chapters");
+                _chapters = chapters ?? new();
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"[CreatorEdit] Error fetching chapters list: {ex.Message}");
+            }
+            finally
+            {
+                _loadingChapters = false;
+            }
+        }
+
+        // If ChapterId is empty/null, select the first chapter from list and navigate
+        if (string.IsNullOrEmpty(ChapterId))
+        {
+            if (_chapters.Any())
+            {
+                NavigationManager.NavigateTo($"/creator/edit/{BookId}/{_chapters.First().Id}");
+            }
+            return;
+        }
+
+        if (Guid.TryParse(ChapterId, out var parsedChapterId))
+        {
+            // If active chapter changed, fetch its details
+            if (parsedChapterId != _activeChapterId)
+            {
+                _activeChapterId = parsedChapterId;
+                var ch = _chapters.FirstOrDefault(c => c.Id == _activeChapterId);
+                _activeChapterTitle = ch?.Title ?? "Rozdział";
+
+                _loadingChapter = true;
+                _isChapterLoaded = false;
+                StateHasChanged();
+
+                try
+                {
+                    var detail = await Http.GetFromJsonAsync<ChapterDetail>($"/api/chapters/{_activeChapterId}");
+                    if (detail != null)
+                    {
+                        _initialMarkdown = detail.MarkdownContent;
+                        _isChapterLoaded = true;
+                    }
+                }
+                catch (Exception ex)
+                {
+                    Console.WriteLine($"[CreatorEdit] Error fetching chapter content: {ex.Message}");
+                }
+                finally
+                {
+                    _loadingChapter = false;
+                }
+            }
+        }
+    }
+}
+

src/NexusReader.UI.Shared/Pages/CreatorEdit.razor.css

@@ -0,0 +1,365 @@
+/* ==========================================================================
+   NEXUSREADER CREATOR EDIT MODE - HIGH-FIDELITY SAAS PREMIUM DESIGN OVERRIDE
+   ========================================================================== */
+
+/* 1. ARCHITECTURAL BOUNDARY CONTROL */
+.creator-edit-fullscreen-wrapper {
+    width: 100% !important;
+    max-width: 100% !important;
+    height: calc(100vh - 4rem) !important;
+    margin: 0 !important;
+    padding: 0 !important;
+    display: flex !important;
+    overflow: hidden !important;
+    background-color: #121214;
+    box-sizing: border-box;
+}
+
+/* Dynamic theme bridge mapping for Warm Paper mode */
+.theme-light .creator-edit-fullscreen-wrapper {
+    background-color: #f4f1ea;
+}
+
+/* 2. UNIFIED SIDEBAR DESIGN (Eliminating layout color fragmentation) */
+.chapters-sidebar {
+    width: 300px !important;
+    flex-shrink: 0;
+    background-color: #16161a !important;
+    border-right: 1px solid rgba(255, 255, 255, 0.04) !important;
+    display: flex;
+    flex-direction: column;
+    padding: 2.5rem 1.5rem !important;
+    box-sizing: border-box;
+}
+
+.theme-light .chapters-sidebar {
+    background-color: #eae6db !important; /* Rich warm tone that remains fully cohesive with warm paper base */
+    border-right: 1px solid #dcd7cc !important;
+}
+
+.sidebar-meta-header h2 {
+    font-size: 0.8rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 2px;
+    color: #a1a1aa;
+    margin: 0 0 1.75rem 0;
+}
+
+.theme-light .sidebar-meta-header h2 {
+    color: #78716c;
+}
+
+.chapters-list-wrapper {
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+}
+
+/* Premium Navigation Links */
+.chapter-item {
+    position: relative;
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    padding: 12px 16px !important;
+    border-radius: 10px;
+    color: #a1a1aa;
+    font-size: 0.95rem;
+    cursor: pointer;
+    transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+.theme-light .chapter-item {
+    color: #78716c;
+}
+
+.chapter-item i.chapter-icon {
+    font-size: 0.95rem;
+    color: #71717a;
+    transition: color 0.25s ease;
+}
+
+/* Active Indicator Node Alignment */
+.chapter-item.active {
+    background-color: rgba(0, 255, 153, 0.05) !important;
+    color: #00ff99 !important;
+    font-weight: 600;
+}
+
+.theme-light .chapter-item.active {
+    background-color: rgba(16, 185, 129, 0.06) !important;
+    color: #10b981 !important;
+}
+
+.chapter-item.active i.chapter-icon {
+    color: inherit !important;
+}
+
+.chapter-item:hover:not(.active) {
+    background-color: rgba(255, 255, 255, 0.02);
+    color: #ffffff;
+}
+
+.theme-light .chapter-item:hover:not(.active) {
+    background-color: rgba(0, 0, 0, 0.02);
+    color: #2d2a26;
+}
+
+/* 3. WORKSPACE METRICS (Zen presentation spacing) */
+.editor-workspace-area {
+    flex-grow: 1;
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    padding: 3rem 4rem 2.5rem 4rem !important; /* Generous padding context for premium scale */
+    box-sizing: border-box;
+    overflow: hidden;
+}
+
+.editor-header-row {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 2rem;
+    flex-shrink: 0;
+    width: 100%;
+}
+
+.editor-workspace-area h1.chapter-title {
+    font-size: 2.4rem;
+    font-weight: 700;
+    color: #ffffff;
+    margin: 0;
+    letter-spacing: -0.75px;
+}
+
+.theme-light .editor-workspace-area h1.chapter-title {
+    color: #2d2a26;
+}
+
+.chapter-id-badge {
+    font-family: 'Azeret Mono', monospace;
+    font-size: 0.72rem;
+    color: #71717a;
+    background: #1a1a1e;
+    padding: 6px 14px;
+    border-radius: 8px;
+    border: 1px solid rgba(255, 255, 255, 0.05);
+    letter-spacing: 0.2px;
+}
+
+.theme-light .chapter-id-badge {
+    background: #ffffff;
+    color: #78716c;
+    border: 1px solid #dcd7cc;
+}
+
+/* 4. ELEVATED EDITOR CANVAS CARD (Introducing layered shadow mechanics) */
+.editor-canvas-card {
+    background-color: #1a1a1e !important;
+    border: 1px solid rgba(255, 255, 255, 0.04) !important;
+    border-radius: 20px;
+    padding: 3rem !important;
+    display: flex;
+    flex-direction: column;
+    flex-grow: 1;
+    overflow: hidden;
+    box-sizing: border-box;
+    /* Soft diffuse structural shadows mimicking actual surface elevation */
+    box-shadow: 0 20px 50px rgba(0, 0, 0, 0.4), 0 4px 12px rgba(0, 0, 0, 0.2);
+}
+
+.theme-light .editor-canvas-card {
+    background-color: #ffffff !important;
+    border: 1px solid #dcd7cc !important;
+    box-shadow: 0 20px 50px rgba(45, 42, 38, 0.04), 0 4px 12px rgba(45, 42, 38, 0.02);
+}
+
+.milkdown-premium-container {
+    flex-grow: 1;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    width: 100%;
+}
+
+/* DEEP MOUNTING COMPONENT INTEROP */
+.milkdown-premium-container ::deep .milkdown {
+    background: transparent !important;
+    box-shadow: none !important;
+    border: none !important;
+    display: flex;
+    flex-direction: column;
+    flex-grow: 1;
+    overflow: hidden;
+    width: 100%;
+}
+
+.milkdown-premium-container ::deep .ProseMirror {
+    color: #e4e1d9 !important;
+    background-color: transparent !important;
+    font-size: 1.15rem !important;
+    line-height: 1.8 !important;
+    flex-grow: 1;
+    overflow-y: auto !important;
+    padding-right: 24px !important;
+    outline: none !important;
+    box-sizing: border-box;
+    width: 100%;
+}
+
+.theme-light .milkdown-premium-container ::deep .ProseMirror {
+    color: #2d2a26 !important;
+}
+
+/* Precise matching text selection token */
+.milkdown-premium-container ::deep .ProseMirror ::selection {
+    background-color: rgba(0, 255, 153, 0.2) !important;
+}
+
+.theme-light .milkdown-premium-container ::deep .ProseMirror ::selection {
+    background-color: rgba(16, 185, 129, 0.18) !important;
+}
+
+/* Core webkit custom scrollbar mapping */
+.milkdown-premium-container ::deep .ProseMirror::-webkit-scrollbar {
+    width: 6px;
+}
+.milkdown-premium-container ::deep .ProseMirror::-webkit-scrollbar-track {
+    background: transparent;
+}
+.milkdown-premium-container ::deep .ProseMirror::-webkit-scrollbar-thumb {
+    background: rgba(255, 255, 255, 0.08);
+    border-radius: 4px;
+}
+
+.theme-light .milkdown-premium-container ::deep .ProseMirror::-webkit-scrollbar-thumb {
+    background: #dcd7cc;
+}
+
+/* 5. SEAMLESS INTEGRATED ACTIONS FOOTER BAR (OVERWRITING FOR MARKDOWNEDITOR COMPONENT INTEGRATION) */
+.milkdown-premium-container ::deep .markdown-editor-container {
+    display: flex;
+    flex-direction: column;
+    flex-grow: 1;
+    overflow: hidden;
+    height: 100%;
+}
+
+.milkdown-premium-container ::deep .milkdown-editor-wrapper {
+    background: transparent !important;
+    border: none !important;
+    box-shadow: none !important;
+    padding: 0 !important;
+    flex-grow: 1;
+    overflow: hidden !important;
+    display: flex;
+    flex-direction: column;
+}
+
+.milkdown-premium-container ::deep .milkdown {
+    flex-grow: 1;
+    overflow: hidden !important;
+}
+
+.milkdown-premium-container ::deep .editor-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-top: 2rem !important;
+    padding: 1.5rem 0 0 0 !important;
+    border: none !important;
+    border-top: 1px solid rgba(255, 255, 255, 0.04) !important;
+    background: transparent !important;
+    border-radius: 0 !important;
+    flex-shrink: 0;
+    width: 100%;
+}
+
+.theme-light .milkdown-premium-container ::deep .editor-footer {
+    border-top: 1px solid #dcd7cc !important;
+}
+
+/* Telemetry cloud synchronization line mapping */
+.milkdown-premium-container ::deep .status-indicator {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    font-family: 'Azeret Mono', monospace;
+    font-size: 0.82rem;
+    color: #71717a;
+    letter-spacing: 0.1px;
+}
+
+.theme-light .milkdown-premium-container ::deep .status-indicator {
+    color: #78716c;
+}
+
+.milkdown-premium-container ::deep .status-dot {
+    width: 7px;
+    height: 7px;
+    border-radius: 50%;
+    display: inline-block;
+}
+
+.milkdown-premium-container ::deep .status-dot.saved {
+    background-color: #00ff99 !important;
+    box-shadow: 0 0 10px rgba(0, 255, 153, 0.8) !important;
+    color: #00ff99 !important;
+}
+
+.theme-light .milkdown-premium-container ::deep .status-dot.saved {
+    background-color: #10b981 !important;
+    box-shadow: 0 0 10px rgba(16, 185, 129, 0.6) !important;
+    color: #10b981 !important;
+}
+
+.milkdown-premium-container ::deep .status-dot.saving {
+    background-color: #F59E0B !important;
+    box-shadow: 0 0 10px rgba(245, 158, 11, 0.8) !important;
+    color: #F59E0B !important;
+}
+
+.milkdown-premium-container ::deep .status-dot.offline {
+    background-color: #EF4444 !important;
+    box-shadow: 0 0 10px rgba(239, 68, 68, 0.8) !important;
+    color: #EF4444 !important;
+}
+
+/* Premium Tactile Operational Button Trigger */
+.milkdown-premium-container ::deep .nexus-btn {
+    background-color: #00ff99 !important;
+    color: #121214 !important;
+    font-weight: 700;
+    font-size: 0.9rem;
+    letter-spacing: -0.1px;
+    padding: 11px 24px !important;
+    border: none !important;
+    border-radius: 10px;
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    gap: 10px;
+    transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+    box-shadow: 0 4px 20px rgba(0, 255, 153, 0.15);
+    height: auto !important;
+    min-height: unset !important;
+}
+
+.theme-light .milkdown-premium-container ::deep .nexus-btn {
+    background-color: #10b981 !important;
+    color: #ffffff !important;
+    box-shadow: 0 4px 20px rgba(16, 185, 129, 0.15);
+}
+
+.milkdown-premium-container ::deep .nexus-btn:hover {
+    transform: translateY(-1px);
+    box-shadow: 0 8px 24px rgba(0, 255, 153, 0.3);
+}
+
+.theme-light .milkdown-premium-container ::deep .nexus-btn:hover {
+    box-shadow: 0 8px 24px rgba(16, 185, 129, 0.3);
+}
+
+

src/NexusReader.UI.Shared/Pages/Dashboard.razor

@@ -7,6 +7,8 @@
 @inject IIdentityService IdentityService
 @inject NavigationManager NavigationManager
 @inject ISyncService SyncService
+@inject IJSRuntime JS
+@using Microsoft.JSInterop
 @attribute [Authorize]
 @implements IDisposable
 
@@ -54,31 +56,65 @@
                 <section class="integration-card glass-panel">
                     <div class="panel-header">
                         <h4>Integracja Wiedzy</h4>
-                        <NexusIcon Name="arrow-right" Size="16" />
+                        <button class="view-toggle-btn" @onclick="ToggleGraphMode" type="button" aria-label="Toggle View">
+                            <NexusIcon Name="@(_showSimplifiedList ? "map" : "list")" Size="14" />
+                            <span>@(_showSimplifiedList ? "Pokaż Wykres" : "Pokaż Listę")</span>
+                        </button>
                     </div>
+
+                    @if (_showSimplifiedList)
+                    {
+                        <div class="concepts-linear-stack">
+                            @if (_profile?.MappedConcepts != null && _profile.MappedConcepts.Any())
+                            {
+                                <div class="concept-linear-list">
+                                    @foreach (var concept in _profile.MappedConcepts)
+                                    {
+                                        <div class="concept-linear-item">
+                                            <span class="concept-badge @concept.Type.ToLower()">@concept.Type</span>
+                                            <span class="concept-text" title="@concept.Content">@concept.Content</span>
+                                        </div>
+                                    }
+                                </div>
+                            }
+                            else
+                            {
+                                <div class="concepts-empty-list">
+                                    <NexusIcon Name="info" Size="20" />
+                                    <p>Brak pojęć. Rozpocznij czytanie, aby AI wyodrębniło kluczowe koncepty.</p>
+                                </div>
+                            }
+                        </div>
+                    }
+                    else
+                    {
                         <div class="graph-placeholder">
                             <div class="graph-node central" title="Ośrodek Wiedzy Nexus Reader"></div>
                             
                             @if (_profile?.MappedConcepts != null && _profile.MappedConcepts.Any())
                             {
+                                <div @key='"satellite-concepts-container"' style="display: contents;">
                                     @for (int i = 0; i < _profile.MappedConcepts.Count; i++)
                                     {
                                         var concept = _profile.MappedConcepts[i];
                                         var angle = i * (360.0 / _profile.MappedConcepts.Count);
                                         var dist = 65;
-                                <div class="graph-node satellite" 
+                                        <div @key="concept.Id" class="graph-node satellite" 
                                              style="--angle: @(angle)deg; --dist: @(dist)px;"
                                              title="[@concept.Type] @concept.Content"
                                              @onmouseover="() => SetHoveredConcept(concept)"
                                              @onmouseout="ClearHoveredConcept">
                                         </div>
                                     }
+                                </div>
                             }
                             else
                             {
-                            <div class="graph-node satellite" style="--angle: 0deg; --dist: 60px;"></div>
-                            <div class="graph-node satellite" style="--angle: 120deg; --dist: 50px;"></div>
-                            <div class="graph-node satellite" style="--angle: 240deg; --dist: 70px;"></div>
+                                <div @key='"satellite-placeholders-container"' style="display: contents;">
+                                    <div @key='"satellite-placeholder-0"' class="graph-node satellite" style="--angle: 0deg; --dist: 60px;"></div>
+                                    <div @key='"satellite-placeholder-1"' class="graph-node satellite" style="--angle: 120deg; --dist: 50px;"></div>
+                                    <div @key='"satellite-placeholder-2"' class="graph-node satellite" style="--angle: 240deg; --dist: 70px;"></div>
+                                </div>
                             }
                             
                             <div class="active-node-label">
@@ -100,6 +136,7 @@
                                 <p class="concept-content">Najedź na węzeł, aby zbadać pojęcie wydobyte przez Nexus AI.</p>
                             </div>
                         }
+                    }
                 </section>
 
                 <!-- Quiz Summary -->
@@ -111,10 +148,10 @@
                     <div class="quiz-preview">
                         @if (_profile?.RecentQuizzes != null && _profile.RecentQuizzes.Any())
                         {
-                            <div class="quiz-history-list">
+                            <div @key='"quiz-history-list"' class="quiz-history-list">
                                 @foreach (var quiz in _profile.RecentQuizzes)
                                 {
-                                    <div class="quiz-history-item">
+                                    <div @key="quiz.Id" class="quiz-history-item">
                                         <div class="quiz-item-header">
                                             <span class="quiz-topic">@quiz.Topic</span>
                                             <span class="quiz-score badge @(quiz.Percentage >= 80 ? "badge-success" : quiz.Percentage >= 50 ? "badge-warning" : "badge-danger")">
@@ -130,7 +167,7 @@
                         }
                         else
                         {
-                            <div class="empty-quiz-state">
+                            <div @key='"empty-quiz-state"' class="empty-quiz-state">
                                 <p class="question">Brak rozwiązanych quizów</p>
                                 <p class="sub-text">Rozwiązuj quizy w trakcie czytania książek, aby śledzić swoje postępy.</p>
                             </div>
@@ -140,6 +177,9 @@
             </div>
         </div>
 
+        <!-- Contextual AI Recommendations -->
+        <ContextualRecommendationsWidget />
+
         <!-- Detailed Content Block Showcase -->
         <section class="architecture-guide-panel glass-panel">
             <div class="panel-header">
@@ -166,6 +206,32 @@
     private UserProfileDto? _profile;
     private MappedConceptDto? _hoveredConcept;
     private string _hoveredConceptLabel = string.Empty;
+    private bool _showSimplifiedList = false;
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (firstRender)
+        {
+            try
+            {
+                var isMobile = await JS.InvokeAsync<bool>("eval", "window.innerWidth < 768");
+                if (isMobile)
+                {
+                    _showSimplifiedList = true;
+                    StateHasChanged();
+                }
+            }
+            catch
+            {
+                // Fallback for tests or prerendering
+            }
+        }
+    }
+
+    private void ToggleGraphMode()
+    {
+        _showSimplifiedList = !_showSimplifiedList;
+    }
 
     protected override async Task OnInitializedAsync()
     {

src/NexusReader.UI.Shared/Pages/Dashboard.razor.css

@@ -17,16 +17,16 @@
     display: flex;
     justify-content: center;
     overflow: hidden;
-    background: #0d0d0d;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border-bottom: 1px solid var(--border);
 }
 
 .header-grid-bg {
     position: absolute;
     inset: 0;
     background-image: 
-        linear-gradient(rgba(255,255,255,0.03) 1px, transparent 1px),
-        linear-gradient(90deg, rgba(255,255,255,0.03) 1px, transparent 1px);
+        linear-gradient(var(--border) 1px, transparent 1px),
+        linear-gradient(90deg, var(--border) 1px, transparent 1px);
     background-size: 60px 60px;
     background-position: center;
     mask-image: radial-gradient(circle at center, black, transparent 80%);
@@ -52,10 +52,10 @@
     height: 100%;
     border-radius: 50%;
     object-fit: cover;
-    border: 3px solid #1a1a1a;
+    border: 3px solid var(--border);
     position: relative;
     z-index: 2;
-    background: #222;
+    background: var(--bg-surface);
 }
 
 .avatar-glow {
@@ -78,7 +78,7 @@
     font-family: var(--nexus-font-sans);
     font-size: 1.25rem;
     font-weight: 500;
-    color: #ffffff;
+    color: var(--text-main);
     letter-spacing: 1px;
     text-transform: lowercase;
 }
@@ -103,17 +103,17 @@
 
 .status-pill {
     padding: 0.6rem 1.25rem;
-    background: rgba(16, 185, 129, 0.05);
-    border: 1px solid rgba(16, 185, 129, 0.3);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
     border-radius: 100px;
     display: flex;
     gap: 0.5rem;
     font-size: 0.9rem;
-    box-shadow: 0 0 15px rgba(16, 185, 129, 0.1);
+    box-shadow: 0 0 15px rgba(16, 185, 129, 0.05);
 }
 
-.pill-label { color: #A0A0A0; }
-.pill-value { color: #ffffff; font-weight: 600; }
+.pill-label { color: var(--text-muted); }
+.pill-value { color: var(--text-main); font-weight: 600; }
 
 /* --- Dashboard Content --- */
 .dashboard-content {
@@ -127,7 +127,7 @@
     font-family: var(--nexus-font-serif);
     font-size: 2rem;
     margin-bottom: 2rem;
-    color: #ffffff;
+    color: var(--text-main);
 }
 
 .main-grid {
@@ -137,18 +137,18 @@
 }
 
 .glass-panel {
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     border-radius: 12px;
     padding: 1.5rem;
     transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
 }
 
 .glass-panel:hover {
-    background: #1e1e24;
-    border-color: rgba(16, 185, 129, 0.2);
+    background: var(--bg-surface);
+    border-color: var(--accent);
     transform: translateY(-4px);
-    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.3);
+    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.1);
 }
 
 /* Reading Card */
@@ -161,7 +161,7 @@
 .reading-card h3 {
     font-size: 1.1rem;
     font-weight: 600;
-    color: #E0E0E0;
+    color: var(--text-main);
     margin: 0;
 }
 
@@ -178,7 +178,7 @@
 .reading-thumb img {
     width: 100%;
     border-radius: 12px;
-    box-shadow: 0 10px 30px rgba(0,0,0,0.5);
+    box-shadow: 0 10px 30px rgba(0,0,0,0.15);
 }
 
 .reading-info {
@@ -196,12 +196,12 @@
 
 .chapter-label {
     font-size: 0.85rem;
-    color: #A0A0A0;
+    color: var(--text-muted);
 }
 
 .progress-container {
     height: 8px;
-    background: rgba(255, 255, 255, 0.05);
+    background: var(--border);
     border-radius: 4px;
     position: relative;
 }
@@ -228,13 +228,13 @@
 
 .progress-detail {
     font-size: 0.8rem;
-    color: #666;
+    color: var(--text-muted);
 }
 
 .reading-desc {
     font-size: 0.85rem;
     line-height: 1.6;
-    color: #888;
+    color: var(--text-muted);
     margin: 0;
 }
 
@@ -261,7 +261,7 @@
     margin: 0;
     font-size: 1rem;
     font-weight: 600;
-    color: #E0E0E0;
+    color: var(--text-main);
 }
 
 /* Graph Placeholder */
@@ -325,7 +325,7 @@
 
 .question {
     font-size: 0.95rem;
-    color: #E0E0E0;
+    color: var(--text-main);
 }
 
 .quiz-options {
@@ -336,13 +336,14 @@
 
 .quiz-option {
     padding: 0.75rem 1rem;
-    background: rgba(255, 255, 255, 0.02);
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
     border-radius: 10px;
     font-size: 0.9rem;
     display: flex;
     gap: 0.75rem;
     cursor: pointer;
+    color: var(--text-main);
 }
 
 .quiz-option.active {
@@ -372,9 +373,9 @@
 }
 
 .btn-nexus.secondary {
-    background: rgba(255, 255, 255, 0.05);
-    color: #fff;
-    border: 1px solid rgba(255, 255, 255, 0.1);
+    background: var(--bg-base);
+    color: var(--text-main);
+    border: 1px solid var(--border);
 }
 
 .btn-nexus:hover {
@@ -417,16 +418,16 @@
 }
 
 .quiz-history-item {
-    background: rgba(255, 255, 255, 0.02);
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     border-radius: 12px;
     padding: 1rem;
     transition: all 0.2s ease;
 }
 
 .quiz-history-item:hover {
-    background: rgba(255, 255, 255, 0.04);
-    border-color: rgba(255, 255, 255, 0.1);
+    background: var(--bg-base);
+    border-color: var(--border);
 }
 
 .quiz-item-header {
@@ -440,13 +441,13 @@
 .quiz-topic {
     font-size: 0.95rem;
     font-weight: 500;
-    color: #ffffff;
+    color: var(--text-main);
 }
 
 .quiz-item-meta {
     display: flex;
     font-size: 0.75rem;
-    color: #666666;
+    color: var(--text-muted);
 }
 
 .badge {
@@ -481,7 +482,7 @@
 
 .empty-quiz-state .sub-text {
     font-size: 0.8rem;
-    color: #666666;
+    color: var(--text-muted);
     margin-top: 0.5rem;
 }
 
@@ -489,8 +490,8 @@
 .concept-detail-toast {
     margin-top: 1rem;
     padding: 0.75rem 1rem;
-    background: rgba(255, 255, 255, 0.02);
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-base);
+    border: 1px solid var(--border);
     border-radius: 12px;
     min-height: 80px;
     display: flex;
@@ -514,7 +515,7 @@
 .concept-content {
     font-size: 0.85rem;
     line-height: 1.4;
-    color: #E0E0E0;
+    color: var(--text-main);
     margin: 0;
     display: -webkit-box;
     -webkit-line-clamp: 2;
@@ -523,28 +524,29 @@
 }
 
 /* Mobile Dashboard Overrides */
-@media (max-width: 768px) {
+@media (max-width: 767px) {
     .dashboard-content {
-        padding: 1.25rem 0.75rem;
+        padding: 0.5rem 0.5rem calc(1.5rem + 64px) !important;
     }
 
     .profile-header {
-        padding: 1.5rem 1rem;
-        border-radius: 16px;
+        padding: 10px 12px;
+        background: var(--bg-surface);
+        border: 1px solid var(--border);
+        border-radius: 12px;
+        margin-bottom: 10px;
     }
 
     .profile-visual {
-        flex-direction: row;
-        flex-wrap: wrap;
-        justify-content: flex-start;
+        display: grid;
+        grid-template-columns: auto 1fr;
         align-items: center;
-        text-align: left;
-        gap: 1.25rem;
+        gap: 0.5rem;
     }
 
     .avatar-wrapper {
-        width: 70px;
-        height: 70px;
+        width: 40px;
+        height: 40px;
         margin: 0;
     }
 
@@ -552,45 +554,91 @@
         flex: 1;
     }
 
-    .user-name {
-        font-size: 1.5rem;
-        margin-bottom: 0.25rem;
+    .username {
+        font-size: 1.05rem;
+        font-weight: 600;
+        text-align: left;
+        margin: 0;
+        letter-spacing: 0px;
     }
 
     .user-role {
-        font-size: 0.85rem;
+        font-size: 0.8rem;
     }
 
     .status-pills {
+        grid-column: span 2;
+        display: flex;
+        flex-direction: row;
+        justify-content: space-between;
         width: 100%;
-        margin-top: 0.5rem;
-        justify-content: flex-start;
-        flex-wrap: wrap;
-        gap: 0.5rem;
+        gap: 0.25rem;
+        margin-top: 0.15rem;
     }
 
     .status-pill {
-        padding: 0.35rem 0.75rem;
-        font-size: 0.75rem;
+        flex: 1;
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        padding: 0.25rem 0.4rem;
+        font-size: 0.65rem;
+        gap: 0.2rem;
+        white-space: nowrap;
+        border-radius: 6px;
+    }
+
+    .section-title {
+        font-size: 1.25rem;
+        font-weight: 700;
+        letter-spacing: -0.5px;
+        margin-top: 4px;
+        margin-bottom: 8px;
+        color: var(--text-main);
     }
 
     .main-grid {
         grid-template-columns: 1fr !important;
-        gap: 1.25rem !important;
+        gap: 0.75rem !important;
     }
 
     .secondary-grid {
+        display: grid !important;
         grid-template-columns: 1fr !important;
-        gap: 1.25rem !important;
+        gap: 0.75rem !important;
     }
 
     /* Force all widgets to take 100% width and fit inside parent container nicely */
     .glass-panel {
         width: 100% !important;
-        padding: 1.25rem !important;
+        padding: 12px !important;
         box-sizing: border-box;
     }
 
+    /* Compress Knowledge Graph and Concept stack heights to maximize visible fold space */
+    .graph-placeholder {
+        height: 120px;
+    }
+
+    .concepts-linear-stack {
+        height: 120px !important;
+        max-height: 120px !important;
+        overflow-y: auto !important;
+        padding-right: 4px;
+    }
+
+    .concept-linear-item {
+        padding: 6px 8px !important;
+        font-size: 0.75rem !important;
+        gap: 0.5rem !important;
+        min-height: auto !important; /* Prevent touch target min-height expansion */
+    }
+
+    .concept-badge {
+        padding: 2px 6px !important;
+        font-size: 0.65rem !important;
+    }
+
     /* Expand touch-targets to 48px min height for interactive elements */
     .btn-nexus, .quiz-option, .satellite, .logout-btn, .nav-item, .quiz-item {
         min-height: 48px;
@@ -603,8 +651,8 @@
 /* --- Architecture Guide Block --- */
 .architecture-guide-panel {
     margin-top: 2.5rem;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     border-radius: 12px;
     padding: 2rem;
 }
@@ -618,7 +666,7 @@
 .architecture-content h3 {
     font-size: 1.5rem;
     font-weight: 700;
-    color: #ffffff;
+    color: var(--text-main);
     margin-bottom: 1.25rem;
     letter-spacing: -0.01em;
 }
@@ -626,16 +674,286 @@
 .architecture-content p {
     font-size: 0.95rem;
     line-height: 1.6;
-    color: #e4e4e7;
+    color: var(--text-main);
     margin-bottom: 1.25rem;
 }
 
 .architecture-content code {
-    background: rgba(255, 255, 255, 0.05);
+    background: var(--bg-base);
     color: #10b981;
     padding: 0.2rem 0.4rem;
     border-radius: 4px;
     font-size: 0.85rem;
 }
 
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .username::before,
+.theme-light .username::after {
+    color: var(--accent);
+}
+
+.theme-light .avatar-glow {
+    background: var(--accent);
+    filter: blur(15px);
+    opacity: 0.2;
+}
+
+.theme-light .progress-container {
+    background: #e4e1d9;
+}
+
+.theme-light .progress-bar {
+    background: var(--accent);
+    box-shadow: 0 0 8px rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .progress-bubble {
+    background: var(--accent);
+    color: #ffffff;
+}
+
+.theme-light .graph-node {
+    background: rgba(0, 0, 0, 0.06);
+    border: 1px solid rgba(0, 0, 0, 0.08);
+}
+
+.theme-light .graph-node.central {
+    background: var(--accent);
+    box-shadow: 0 0 12px rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .graph-node.satellite {
+    background: rgba(16, 185, 129, 0.15);
+    border: 1px solid var(--accent);
+}
+
+.theme-light .graph-node.satellite:hover {
+    background: var(--accent);
+    box-shadow: 0 0 10px var(--accent);
+}
+
+.theme-light .active-node-label {
+    background: rgba(16, 185, 129, 0.06);
+    border: 1px solid var(--accent);
+    color: var(--accent);
+}
+
+.theme-light .quiz-option.active {
+    background: rgba(16, 185, 129, 0.06);
+    border-color: var(--accent);
+    color: var(--accent);
+}
+
+.theme-light .btn-nexus.primary {
+    background: var(--accent);
+    color: #0d0d0d;
+}
+
+.theme-light .btn-nexus.primary:hover {
+    background: #059669;
+    color: #ffffff;
+}
+
+.theme-light .empty-icon {
+    color: var(--accent);
+    filter: none;
+}
+
+.theme-light .badge-success {
+    background: rgba(16, 185, 129, 0.1);
+    color: var(--accent);
+    border: 1px solid rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .concept-type {
+    color: var(--accent);
+}
+
+/* --- Concepts Linear Stack for Mobile/Utility Switch --- */
+.concepts-linear-stack {
+    height: 180px;
+    display: flex;
+    flex-direction: column;
+    overflow-y: auto;
+    gap: 0.5rem;
+    padding-right: 0.5rem;
+}
+
+.concept-linear-list {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+}
+
+.concept-linear-item {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 0.6rem 0.75rem;
+    background: rgba(255, 255, 255, 0.02);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    font-size: 0.85rem;
+    color: var(--text-main);
+    transition: all 0.2s ease;
+}
+
+.concept-linear-item:hover {
+    background: rgba(255, 255, 255, 0.04);
+    border-color: rgba(0, 255, 153, 0.2);
+    transform: translateX(2px);
+}
+
+.concept-badge {
+    padding: 2px 8px;
+    border-radius: 4px;
+    font-size: 0.7rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    white-space: nowrap;
+}
+
+.concept-badge.rule {
+    background: rgba(255, 70, 70, 0.1);
+    color: #ff8b8b;
+    border: 1px solid rgba(255, 70, 70, 0.2);
+}
+
+.concept-badge.definition {
+    background: rgba(255, 176, 58, 0.1);
+    color: #ffd18c;
+    border: 1px solid rgba(255, 176, 58, 0.2);
+}
+
+.concept-badge.table {
+    background: rgba(217, 70, 239, 0.1);
+    color: #f5d0fe;
+    border: 1px solid rgba(217, 70, 239, 0.2);
+}
+
+.concept-badge.section {
+    background: rgba(59, 130, 246, 0.1);
+    color: #93c5fd;
+    border: 1px solid rgba(59, 130, 246, 0.2);
+}
+
+.concept-badge.bridge {
+    background: rgba(6, 182, 212, 0.1);
+    color: #67e8f9;
+    border: 1px solid rgba(6, 182, 212, 0.2);
+}
+
+.concept-badge.concept {
+    background: rgba(0, 210, 196, 0.05);
+    color: #e0e0e0;
+    border: 1px solid rgba(0, 210, 196, 0.2);
+}
+
+.concept-text {
+    flex: 1;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    font-weight: 500;
+}
+
+.concepts-empty-list {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    height: 100%;
+    color: var(--text-muted);
+    font-size: 0.85rem;
+    text-align: center;
+    gap: 0.5rem;
+}
+
+.concepts-empty-list p {
+    margin: 0;
+}
+
+.view-toggle-btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35rem;
+    background: rgba(255, 255, 255, 0.03);
+    border: 1px solid var(--border);
+    color: var(--text-muted);
+    padding: 0.35rem 0.75rem;
+    border-radius: 6px;
+    font-size: 0.75rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: all 0.2s ease;
+}
+
+.view-toggle-btn:hover {
+    background: rgba(0, 255, 153, 0.08);
+    border-color: var(--accent);
+    color: var(--accent);
+}
+
+/* --- Light Theme Overrides for Concepts Stack --- */
+.theme-light .concept-linear-item {
+    background: rgba(0, 0, 0, 0.02);
+    color: var(--text-main);
+}
+
+.theme-light .concept-linear-item:hover {
+    background: rgba(0, 0, 0, 0.04);
+    border-color: rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .concept-badge.rule {
+    background: rgba(220, 38, 38, 0.05);
+    color: #991b1b;
+    border-color: rgba(220, 38, 38, 0.15);
+}
+
+.theme-light .concept-badge.definition {
+    background: rgba(217, 119, 6, 0.05);
+    color: #92400e;
+    border-color: rgba(217, 119, 6, 0.15);
+}
+
+.theme-light .concept-badge.table {
+    background: rgba(192, 132, 252, 0.05);
+    color: #6b21a8;
+    border-color: rgba(192, 132, 252, 0.15);
+}
+
+.theme-light .concept-badge.section {
+    background: rgba(37, 99, 235, 0.05);
+    color: #1e3a8a;
+    border-color: rgba(37, 99, 235, 0.15);
+}
+
+.theme-light .concept-badge.bridge {
+    background: rgba(8, 145, 178, 0.05);
+    color: #155e75;
+    border-color: rgba(8, 145, 178, 0.15);
+}
+
+.theme-light .concept-badge.concept {
+    background: rgba(13, 148, 136, 0.03);
+    color: #115e59;
+    border-color: rgba(13, 148, 136, 0.1);
+}
+
+.theme-light .view-toggle-btn {
+    background: rgba(0, 0, 0, 0.02);
+}
+
+.theme-light .view-toggle-btn:hover {
+    background: rgba(16, 185, 129, 0.08);
+    border-color: var(--accent);
+    color: var(--accent);
+}
+
+
 

src/NexusReader.UI.Shared/Pages/Intelligence.razor

@@ -1,35 +1,36 @@
 @page "/intelligence"
 @attribute [Authorize]
+@implements IDisposable
 @using NexusReader.Application.DTOs.AI
 @using NexusReader.Application.Abstractions.Services
 @using NexusReader.Application.DTOs.User
+@using NexusReader.UI.Shared.Components.Molecules
 @using NexusReader.UI.Shared.Components.Atoms
 @using NexusReader.UI.Shared.Models
+@using Microsoft.Extensions.Logging
 @using System.Net.Http.Json
 @inject HttpClient Http
 @inject IKnowledgeService KnowledgeService
 @inject AuthenticationStateProvider AuthStateProvider
+@inject ILibraryStateService LibraryStateService
+@inject ILogger<Intelligence> Logger
 
 <div class="intelligence-page">
-    <header class="intelligence-header">
-        <div class="header-title-section">
-            <h1 class="neon-glow-text">Global Intelligence</h1>
-            <p class="subtitle">Interrogate, explore, and synthesize grounded knowledge from your library using Polyglot KM-RAG</p>
-        </div>
-    </header>
-
-    <div class="intelligence-layout glass-panel">
+    <div class="intelligence-layout">
         <div class="chat-thread-container">
             @if (_chatMessages.Count == 0)
             {
                 <div class="welcome-state">
                     <div class="welcome-icon">
-                        <svg width="64" height="64" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">
-                            <path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"></path>
+                        <svg width="80" height="80" viewBox="0 0 24 24" fill="none" stroke="#8b8273" stroke-width="1.25" stroke-linecap="round" stroke-linejoin="round">
+                            <path d="M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z" stroke-dasharray="2 2" stroke="rgba(139, 130, 115, 0.3)" />
+                            <path d="M12 6v12M8 8h8M6 12h12M8 16h8" stroke="rgba(139, 130, 115, 0.4)" />
+                            <path d="M9.5 4.5c-1.5 0-3 1.5-3 3.5s1.5 3 3 3h5c1.5 0 3-1 3-3s-1.5-3.5-3-3.5" />
+                            <path d="M9.5 19.5c-1.5 0-3-1.5-3-3.5s1.5-3 3-3h5c1.5 0 3 1 3 3s-1.5 3.5-3 3.5" />
+                            <circle cx="12" cy="12" r="2" fill="#8b8273" />
                         </svg>
                     </div>
-                    <h3>Start Interrogating Your Library</h3>
-                    <p>Ask complex questions across your entire ebook collection. The KM-RAG engine dynamically builds semantic maps, resolves dependencies, and formulates high-fidelity, grounded answers with interactive popover citations.</p>
+                    <div class="welcome-prompt">Zadaj pytanie globalne do całej biblioteki...</div>
                 </div>
             }
             else
@@ -37,37 +38,7 @@
                 <div class="chat-bubbles-scroll">
                     @foreach (var message in _chatMessages)
                     {
-                        <div class="message-row @(message.Sender == "User" ? "user-row" : "ai-row")" key="@message.Id">
-                            <div class="message-avatar">
-                                @if (message.Sender == "User")
-                                {
-                                    <i class="bi bi-person-fill"></i>
-                                }
-                                else
-                                {
-                                    <i class="bi bi-robot"></i>
-                                }
-                            </div>
-                            <div class="message-bubble @(message.Sender == "User" ? "user-bubble" : "ai-bubble")">
-                                <div class="message-header">
-                                    <span class="sender-name">@message.Sender</span>
-                                    <span class="message-time">@message.Timestamp.ToString("HH:mm")</span>
-                                </div>
-                                <div class="message-content">
-                                    @foreach (var segment in message.Segments)
-                                    {
-                                        @if (segment.IsCitation)
-                                        {
-                                            <NexusCitationMarker SourceId="@segment.CitationId" Citations="@message.Citations" />
-                                        }
-                                        else
-                                        {
-                                            @RenderMarkdown(segment.Text)
-                                        }
-                                    }
-                                </div>
-                            </div>
-                        </div>
+                        <AiResponseRenderer @key="message.Id" Message="@message" OwnedBooks="@_books" />
                     }
 
                     @if (_isLoading)
@@ -100,9 +71,9 @@
             <div class="input-panel-wrapper">
                 <div class="scope-bar">
                     <div class="scope-selector">
-                        <label for="book-select"><i class="bi bi-compass"></i> Scope:</label>
+                        <label for="book-select">Scope:</label>
                         <select id="book-select" class="nexus-select" @bind="_selectedBookId">
-                            <option value="">All Books (Global Search)</option>
+                            <option value="">[ All Resources (Including Global Catalog) ]</option>
                             @if (_books != null)
                             {
                                 @foreach (var book in _books)
@@ -121,7 +92,7 @@
                            @bind:event="oninput"
                            @onkeyup="HandleKeyUp"
                            disabled="@_isLoading" />
-                    <button class="btn-nexus btn-nexus-primary search-btn" 
+                    <button class="search-btn" 
                             disabled="@(string.IsNullOrWhiteSpace(_question) || _isLoading)" 
                             @onclick="AskQuestionAsync">
                         @if (_isLoading)
@@ -146,20 +117,52 @@
     private List<LastReadBookDto>? _books;
     private List<ChatMessage> _chatMessages = new();
 
-
-
     protected override async Task OnInitializedAsync()
+    {
+        LibraryStateService.OnBooksChanged += HandleBooksChanged;
+        await LoadBooksAsync();
+    }
+
+    private async Task LoadBooksAsync()
     {
         try
         {
             _books = await Http.GetFromJsonAsync<List<LastReadBookDto>>("api/library/books");
+            LibraryStateService.OwnedBooks = _books;
         }
         catch (Exception ex)
         {
-            Console.WriteLine($"[Intelligence] Failed to load books for scope selector: {ex.Message}");
+            Logger.LogError(ex, "[Intelligence] Failed to load books.");
         }
     }
 
+    private void HandleBooksChanged()
+    {
+        _ = InvokeAsync(async () =>
+        {
+            _books = LibraryStateService.OwnedBooks;
+            
+            // Check if any existing message in the chat thread was paywalled,
+            // and update its owned state dynamically.
+            if (_books != null)
+            {
+                foreach (var message in _chatMessages)
+                {
+                    if (message.IsPaywalled && !string.IsNullOrEmpty(message.SourceBookTitle))
+                    {
+                        var isNowOwned = _books.Any(b => b.Title.Equals(message.SourceBookTitle, StringComparison.OrdinalIgnoreCase));
+                        if (isNowOwned)
+                        {
+                            message.IsPaywalled = false;
+                        }
+                    }
+                }
+            }
+            
+            StateHasChanged();
+        });
+    }
+
     private async Task HandleKeyUp(KeyboardEventArgs e)
     {
         if (e.Key == "Enter" && !string.IsNullOrWhiteSpace(_question) && !_isLoading)
@@ -176,7 +179,7 @@
         _question = string.Empty; // Clear input field immediately
         _isLoading = true;
 
-        // Add user query message
+        // Add user query message with custom background in renderer
         _chatMessages.Add(new ChatMessage
         {
             Sender = "User",
@@ -196,18 +199,16 @@
 
             var authState = await AuthStateProvider.GetAuthenticationStateAsync();
             var tenantId = authState.User.FindFirst("TenantId")?.Value ?? "global";
+            var userId = authState.User.FindFirst(System.Security.Claims.ClaimTypes.NameIdentifier)?.Value ?? string.Empty;
 
-            var result = await KnowledgeService.AskQuestionAsync(userQuestion, tenantId, ebookId);
+            if (ebookId == null)
+            {
+                var result = await KnowledgeService.GetGlobalIntelligenceAsync(userQuestion, userId, tenantId);
                 if (result.IsSuccess)
                 {
                     var response = result.Value;
-                _chatMessages.Add(new ChatMessage
-                {
-                    Sender = "AI",
-                    Text = response.Answer,
-                    Segments = ParseSegments(response.Answer),
-                    Citations = response.Citations
-                });
+                    var chatMsg = CreateGlobalAiChatMessage(response, _books);
+                    _chatMessages.Add(chatMsg);
                 }
                 else
                 {
@@ -220,6 +221,60 @@
                     });
                 }
             }
+            else
+            {
+                var result = await KnowledgeService.AskQuestionAsync(userQuestion, tenantId, ebookId);
+                if (result.IsSuccess)
+                {
+                    var response = result.Value;
+                    
+                    // --- Paywall Simulation Logic ---
+                    // If the user does not own "Architektura .NET 10 i Ekosystem Blazor"
+                    // and the question refers to Blazor/architecture/C#/etc,
+                    // we simulate that the RAG search pulled a citation from that unowned book.
+                    var hasBlazorBook = _books != null && _books.Any(b => b.Title.Contains("Architektura .NET 10", StringComparison.OrdinalIgnoreCase));
+                    var isSimulatingPaywall = !hasBlazorBook && 
+                        (userQuestion.Contains("blazor", StringComparison.OrdinalIgnoreCase) || 
+                         userQuestion.Contains("net", StringComparison.OrdinalIgnoreCase) ||
+                         userQuestion.Contains("architektura", StringComparison.OrdinalIgnoreCase) ||
+                         userQuestion.Contains("c#", StringComparison.OrdinalIgnoreCase));
+
+                    if (isSimulatingPaywall)
+                    {
+                        var mockCitationId = Guid.NewGuid().ToString();
+                        var mockCitation = new CitationDto
+                        {
+                            CitationId = mockCitationId,
+                            SourceBook = "Architektura .NET 10 i Ekosystem Blazor",
+                            Author = "Nexus Architect",
+                            Snippet = "Konfiguracja kontenera dependency injection w standardzie .NET 10 Blazor przy użyciu Native AOT wymaga wyeliminowania dynamicznej refleksji.",
+                            PageNumber = 42
+                        };
+                        
+                        if (response.Citations == null)
+                        {
+                            response.Citations = new List<CitationDto>();
+                        }
+                        response.Citations.Add(mockCitation);
+                        
+                        response.Answer = "Aby poprawnie skonfigurować architekturę .NET 10 Blazor pod Native AOT, należy unikać dynamicznego ładowania typów. Konieczne jest używanie generatorów kodu źródłowego (Source Generators) do rejestracji zależności w kontenerze DI. W ten sposób kompilator AOT może przeanalizować graf zależności podczas kompilacji. [Source ID: " + mockCitationId + "]\n\nPełny przykładowy kod konfiguracji Program.cs wygląda następująco:\n```csharp\nvar builder = WebApplication.CreateBuilder(args);\nbuilder.Services.AddSingleton<IService, AotService>();\n```";
+                    }
+                    
+                    var chatMsg = CreateAiChatMessage(response, _books);
+                    _chatMessages.Add(chatMsg);
+                }
+                else
+                {
+                    var errMsg = $"Error: {result.Errors.FirstOrDefault()?.Message ?? "An error occurred."}";
+                    _chatMessages.Add(new ChatMessage
+                    {
+                        Sender = "AI",
+                        Text = errMsg,
+                        Segments = new List<ResponseSegment> { new ResponseSegment { Text = errMsg, IsCitation = false } }
+                    });
+                }
+            }
+        }
         catch (Exception ex)
         {
             var errMsg = $"Network/API Error: {ex.Message}";
@@ -237,12 +292,115 @@
         }
     }
 
+    private ChatMessage CreateAiChatMessage(GroundedResponseDto response, List<LastReadBookDto>? ownedBooks)
+    {
+        var msg = new ChatMessage
+        {
+            Sender = "AI",
+            Text = response.Answer,
+            Segments = ParseSegments(response.Answer),
+            Citations = response.Citations
+        };
+
+        // Check if paywalled: citations contain a book not in ownedBooks
+        var unownedCitation = response.Citations.FirstOrDefault(c => 
+            !string.IsNullOrEmpty(c.SourceBook) && 
+            (ownedBooks == null || !ownedBooks.Any(ob => ob.Title.Equals(c.SourceBook, StringComparison.OrdinalIgnoreCase))));
+
+        if (unownedCitation != null)
+        {
+            msg.IsPaywalled = true;
+            msg.SourceBookTitle = unownedCitation.SourceBook;
+            
+            // Split sentences *once* during creation for Native AOT rendering performance
+            var (clear, _) = SplitSentences(response.Answer);
+            msg.ClearText = clear;
+            msg.BlurredTeaserText = "\n\n// [Blokada Paywall] Pełna treść oraz kody źródłowe C# zostały zablokowane.\npublic class ArchitekturaProcessor {\n    public async Task ProcessAsync() {\n        // Zaimplementuj wzorzec CQRS...\n        throw new PaywallException(\"Kup publikację w katalogu\");\n    }\n}";
+        }
+        else
+        {
+            msg.IsPaywalled = false;
+            msg.ClearText = response.Answer;
+            msg.BlurredTeaserText = string.Empty;
+        }
+
+        return msg;
+    }
+
+    private ChatMessage CreateGlobalAiChatMessage(NexusReader.Application.Queries.Intelligence.IntelligenceResponse response, List<LastReadBookDto>? ownedBooks)
+    {
+        var msg = new ChatMessage
+        {
+            Sender = "AI",
+            Text = response.ResponseText,
+            Segments = ParseSegments(response.ResponseText),
+            Citations = response.Citations ?? new List<CitationDto>()
+        };
+
+        if (response.HasPaywall)
+        {
+            msg.IsPaywalled = true;
+            msg.SourceBookTitle = response.LockedBookTitle ?? string.Empty;
+            
+            // Split sentences *once* during creation for Native AOT rendering performance
+            var (clear, _) = SplitSentences(response.ResponseText);
+            msg.ClearText = clear;
+            msg.BlurredTeaserText = "\n\n// [Blokada Paywall] Pełna treść oraz kody źródłowe C# zostały zablokowane.\npublic class ArchitekturaProcessor {\n    public async Task ProcessAsync() {\n        // Zaimplementuj wzorzec CQRS...\n        throw new PaywallException(\"Kup publikację w katalogu\");\n    }\n}";
+        }
+        else
+        {
+            msg.IsPaywalled = false;
+            msg.ClearText = response.ResponseText;
+            msg.BlurredTeaserText = string.Empty;
+        }
+
+        return msg;
+    }
+
+    private (string ClearText, string BlurredText) SplitSentences(string text)
+    {
+        if (string.IsNullOrEmpty(text)) return (string.Empty, string.Empty);
+        
+        int sentenceCount = 0;
+        int firstSplit = -1;
+        int secondSplit = -1;
+        
+        for (int i = 0; i < text.Length; i++)
+        {
+            char c = text[i];
+            if (c == '.' || c == '?' || c == '!')
+            {
+                if (i + 1 == text.Length || char.IsWhiteSpace(text[i + 1]))
+                {
+                    sentenceCount++;
+                    if (sentenceCount == 1)
+                    {
+                        firstSplit = i + 1;
+                    }
+                    else if (sentenceCount == 2)
+                    {
+                        secondSplit = i + 1;
+                        break;
+                    }
+                }
+            }
+        }
+        
+        int splitIndex = secondSplit != -1 ? secondSplit : firstSplit;
+        
+        if (splitIndex != -1 && splitIndex < text.Length)
+        {
+            return (text.Substring(0, splitIndex), text.Substring(splitIndex));
+        }
+        
+        return (text, string.Empty);
+    }
+
     private List<ResponseSegment> ParseSegments(string text)
     {
         var segments = new List<ResponseSegment>();
         if (string.IsNullOrEmpty(text)) return segments;
 
-        // Matches [Source ID: some-id] OR raw GUIDs in brackets [e225e58f-7539-cd51-e0ab-82741ec7e65c]
         var regex = new System.Text.RegularExpressions.Regex(
             @"\[Source ID:\s*([^\]]+)\]|\[([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})\]", 
             System.Text.RegularExpressions.RegexOptions.IgnoreCase);
@@ -285,28 +443,8 @@
         return segments;
     }
 
-    private MarkupString RenderMarkdown(string text)
+    public void Dispose()
     {
-        if (string.IsNullOrEmpty(text)) return new MarkupString(string.Empty);
-
-        // 1. HTML Encode to prevent XSS
-        var html = System.Net.WebUtility.HtmlEncode(text);
-
-        // 2. Bold: **text** -> <strong>text</strong>
-        html = System.Text.RegularExpressions.Regex.Replace(html, @"\*\*(.*?)\*\*", "<strong>$1</strong>");
-
-        // 3. Italic: *text* -> <em>text</em>
-        html = System.Text.RegularExpressions.Regex.Replace(html, @"\*(.*?)\*", "<em>$1</em>");
-
-        // 4. Code blocks: ```language ... ``` -> <pre class="nexus-code-block"><code>...</code></pre>
-        html = System.Text.RegularExpressions.Regex.Replace(html, @"```(?:[a-zA-Z0-9+#]+)?\s*([\s\S]*?)\s*```", "<pre class=\"nexus-code-block\"><code>$1</code></pre>");
-
-        // 5. Inline Code: `code` -> <code class="nexus-inline-code">code</code>
-        html = System.Text.RegularExpressions.Regex.Replace(html, @"`(.*?)`", "<code class=\"nexus-inline-code\">$1</code>");
-
-        // 6. Newlines: \n -> <br />
-        html = html.Replace("\n", "<br />");
-
-        return new MarkupString(html);
+        LibraryStateService.OnBooksChanged -= HandleBooksChanged;
     }
 }

src/NexusReader.UI.Shared/Pages/Intelligence.razor.css

@@ -1,33 +1,18 @@
 .intelligence-page {
-    padding: 2rem;
-    max-width: 1100px;
-    margin: 0 auto;
-    height: calc(100vh - 100px);
+    margin: -2.5rem;
+    height: 100vh;
+    background: var(--bg-base);
     display: flex;
     flex-direction: column;
-    animation: fadeIn 0.5s ease-out;
+    overflow: hidden;
+    animation: fadeIn 0.4s ease-out;
 }
 
-.intelligence-header {
-    margin-bottom: 1.5rem;
-    flex-shrink: 0;
-}
-
-.neon-glow-text {
-    font-family: var(--nexus-font-sans);
-    font-size: 2.5rem;
-    font-weight: 800;
-    margin: 0 0 0.25rem 0;
-    background: linear-gradient(135deg, var(--nexus-neon) 0%, rgba(0, 255, 153, 0.7) 100%);
-    -webkit-background-clip: text;
-    -webkit-text-fill-color: transparent;
-    filter: drop-shadow(0 0 8px rgba(0, 255, 153, 0.2));
-}
-
-.subtitle {
-    font-size: 0.95rem;
-    color: rgba(255, 255, 255, 0.6);
-    margin: 0;
+@media (max-width: 768px) {
+    .intelligence-page {
+        margin: -1.25rem;
+        height: calc(100vh - 60px);
+    }
 }
 
 .intelligence-layout {
@@ -35,202 +20,90 @@
     display: flex;
     flex-direction: column;
     overflow: hidden;
-    padding: 0;
+    height: 100%;
 }
 
 .chat-thread-container {
     flex-grow: 1;
     overflow-y: auto;
-    padding: 2rem;
+    padding: 3rem 4rem 2rem 4rem;
     display: flex;
     flex-direction: column;
 }
 
+@media (max-width: 768px) {
+    .chat-thread-container {
+        padding: 1.5rem 1rem;
+    }
+}
+
 /* Custom Scrollbars */
 .chat-thread-container::-webkit-scrollbar {
     width: 6px;
 }
 .chat-thread-container::-webkit-scrollbar-track {
-    background: rgba(255, 255, 255, 0.01);
+    background: transparent;
 }
 .chat-thread-container::-webkit-scrollbar-thumb {
-    background: rgba(0, 255, 153, 0.2);
+    background: var(--accent-glow);
     border-radius: 4px;
 }
 .chat-thread-container::-webkit-scrollbar-thumb:hover {
-    background: rgba(0, 255, 153, 0.4);
+    background: var(--accent);
 }
 
 .chat-bubbles-scroll {
     display: flex;
     flex-direction: column;
-    gap: 1.5rem;
     width: 100%;
 }
 
-.message-row {
-    display: flex;
-    gap: 1rem;
-    width: 100%;
-    max-width: 85%;
-    animation: bubble-fade-in 0.3s cubic-bezier(0.16, 1, 0.3, 1) forwards;
-}
-
-.user-row {
-    align-self: flex-end;
-    flex-direction: row-reverse;
-}
-
-.ai-row {
-    align-self: flex-start;
-}
-
-.message-avatar {
-    width: 38px;
-    height: 38px;
-    border-radius: 50%;
+/* State 1: Initial Empty Screen */
+.welcome-state {
+    text-align: center;
+    padding: 4rem 2rem;
     display: flex;
+    flex-direction: column;
     align-items: center;
     justify-content: center;
-    font-size: 1.1rem;
-    flex-shrink: 0;
+    margin-top: auto;
+    margin-bottom: auto;
+    animation: fade-in-up 0.6s cubic-bezier(0.16, 1, 0.3, 1) forwards;
 }
 
-.user-row .message-avatar {
-    background: linear-gradient(135deg, rgba(255, 255, 255, 0.15) 0%, rgba(255, 255, 255, 0.05) 100%);
-    color: #ffffff;
-    border: 1px solid rgba(255, 255, 255, 0.2);
-    box-shadow: 0 0 10px rgba(255, 255, 255, 0.1);
+.welcome-icon {
+    margin-bottom: 2rem;
+    filter: drop-shadow(0 0 15px rgba(139, 130, 115, 0.15));
 }
 
-.ai-row .message-avatar {
-    background: linear-gradient(135deg, #005f38 0%, #004024 100%);
-    color: #e6fffa;
-    border: 1px solid rgba(0, 255, 153, 0.4);
-    box-shadow: 0 0 10px rgba(0, 255, 153, 0.25);
-}
-
-.message-bubble {
-    padding: 1.25rem 1.5rem;
-    border-radius: var(--radius-lg);
-    position: relative;
-    line-height: 1.6;
-    font-size: 0.975rem;
-}
-
-.user-bubble {
-    background: rgba(255, 255, 255, 0.05);
-    border: 1px solid rgba(255, 255, 255, 0.1);
-    color: #ffffff;
-    border-top-right-radius: 4px;
-    box-shadow: 0 4px 15px rgba(0, 0, 0, 0.2);
-}
-
-.ai-bubble {
-    background: rgba(10, 20, 30, 0.55);
-    border: 1px solid rgba(0, 255, 153, 0.2);
-    color: #e2e8f0;
-    border-top-left-radius: 4px;
-    box-shadow: 0 4px 15px rgba(0, 255, 153, 0.05);
-    flex-grow: 1;
-}
-
-.message-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 0.5rem;
-    font-size: 0.75rem;
-    opacity: 0.6;
-}
-
-.sender-name {
-    font-weight: 700;
-    text-transform: uppercase;
-    letter-spacing: 0.5px;
-}
-
-.message-time {
-    font-family: monospace;
-}
-
-.message-content {
-    word-break: break-word;
-}
-
-/* Paragraph Spacing & Markdown */
-.message-content p {
-    margin: 0 0 1rem 0;
-}
-.message-content p:last-child {
-    margin-bottom: 0;
-}
-
-.nexus-code-block {
-    background: rgba(0, 0, 0, 0.4) !important;
-    border: 1px solid rgba(255, 255, 255, 0.08) !important;
-    border-radius: var(--radius-sm);
-    padding: 1rem;
-    margin: 1rem 0;
-    overflow-x: auto;
-    font-family: 'Fira Code', monospace;
-    font-size: 0.85rem;
-    color: #a7f3d0;
-}
-
-.nexus-inline-code {
-    background: rgba(255, 255, 255, 0.06);
-    border: 1px solid rgba(255, 255, 255, 0.1);
-    border-radius: 4px;
-    padding: 0.15rem 0.35rem;
-    font-family: monospace;
-    font-size: 0.9em;
-    color: #f472b6; /* Light pink for inline code */
-}
-
-/* Pending State Bubble */
-.pending-bubble {
-    border-color: rgba(0, 255, 153, 0.4);
-    box-shadow: 0 0 15px rgba(0, 255, 153, 0.1);
-}
-
-.typing-indicator {
-    display: flex;
-    gap: 4px;
-    align-items: center;
-    margin-bottom: 0.5rem;
-}
-
-.typing-indicator span {
-    width: 8px;
-    height: 8px;
-    background: var(--nexus-neon);
-    border-radius: 50%;
-    display: inline-block;
-    animation: typing-bounce 1.4s infinite ease-in-out both;
-}
-
-.typing-indicator span:nth-child(1) { animation-delay: -0.32s; }
-.typing-indicator span:nth-child(2) { animation-delay: -0.16s; }
-
-.loading-label {
-    font-size: 0.85rem;
-    color: rgba(255, 255, 255, 0.5);
-    font-style: italic;
+.welcome-prompt {
+    font-family: var(--nexus-font-sans, inherit);
+    color: var(--text-main);
+    font-size: 1.35rem;
+    font-weight: 500;
+    letter-spacing: -0.2px;
 }
 
 /* Input Controls */
 .chat-input-controls {
-    padding: 1.5rem 2rem 2rem 2rem;
-    background: rgba(0, 0, 0, 0.2);
-    border-top: 1px solid rgba(255, 255, 255, 0.05);
+    padding: 1.5rem 4rem 3rem 4rem;
+    background: linear-gradient(to top, var(--bg-base) 70%, transparent);
     flex-shrink: 0;
 }
 
+@media (max-width: 768px) {
+    .chat-input-controls {
+        padding: 1rem 1rem 1.5rem 1rem;
+    }
+}
+
 .input-panel-wrapper {
     display: flex;
     flex-direction: column;
     gap: 0.75rem;
+    max-width: 900px;
+    margin: 0 auto;
+    width: 100%;
 }
 
 .scope-bar {
@@ -241,115 +114,143 @@
 .scope-selector {
     display: flex;
     align-items: center;
-    gap: 0.5rem;
+    gap: 0.6rem;
     font-size: 0.85rem;
-    color: rgba(255, 255, 255, 0.5);
+    font-weight: 500;
+    color: var(--text-muted);
 }
 
 .nexus-select {
-    background: rgba(255, 255, 255, 0.02);
-    border: 1px solid rgba(255, 255, 255, 0.08);
-    color: #ffffff;
-    padding: 0.35rem 2rem 0.35rem 0.75rem;
-    border-radius: var(--radius-sm);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    color: var(--text-main);
+    padding: 0.4rem 2rem 0.4rem 0.75rem;
+    border-radius: 8px;
     outline: none;
     cursor: pointer;
-    font-size: 0.85rem;
-    transition: all 0.3s ease;
+    font-size: 0.825rem;
+    transition: all 0.25s ease;
     appearance: none;
-    background-image: url("data:image/svg+xml;charset=UTF-8,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='white' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3e%3cpolyline points='6 9 12 15 18 9'%3e%3c/polyline%3e%3c/svg%3e");
+    background-image: url("data:image/svg+xml;charset=UTF-8,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%238b8273' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3e%3cpolyline points='6 9 12 15 18 9'%3e%3c/polyline%3e%3c/svg%3e");
     background-repeat: no-repeat;
     background-position: right 0.75rem center;
     background-size: 0.85em;
 }
 
 .nexus-select:focus {
-    border-color: var(--nexus-neon);
-    box-shadow: 0 0 8px rgba(0, 255, 153, 0.2);
+    border-color: var(--accent);
+    box-shadow: 0 0 8px var(--accent-glow);
 }
 
 .input-field-group {
     display: flex;
-    background: rgba(255, 255, 255, 0.02);
-    border: 1px solid rgba(255, 255, 255, 0.08);
-    border-radius: var(--radius-md);
-    padding: 0.35rem;
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    padding: 0.4rem;
     transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.05);
 }
 
 .input-field-group:focus-within {
-    border-color: var(--nexus-neon);
-    background: rgba(0, 255, 153, 0.01);
-    box-shadow: 0 0 15px rgba(0, 255, 153, 0.15);
+    border-color: var(--accent);
+    background: var(--bg-surface);
+    box-shadow: 0 10px 35px var(--accent-glow);
 }
 
 .nexus-input {
     flex-grow: 1;
     background: transparent;
     border: none;
-    color: #ffffff;
-    font-size: 1rem;
+    color: var(--text-main);
+    font-size: 0.975rem;
     outline: none;
     padding: 0.5rem 1rem;
 }
 
 .nexus-input::placeholder {
-    color: rgba(255, 255, 255, 0.35);
+    color: var(--text-muted);
 }
 
 .search-btn {
-    width: 46px;
-    height: 46px;
-    padding: 0 !important;
+    width: 44px;
+    height: 44px;
+    padding: 0;
     display: flex;
     align-items: center;
     justify-content: center;
+    border-radius: 8px;
+    background: var(--accent);
+    border: none;
+    color: var(--bg-surface);
+    cursor: pointer;
+    transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
 }
 
-.welcome-state {
-    text-align: center;
-    color: rgba(255, 255, 255, 0.5);
-    padding: 4rem 2rem;
+.search-btn:hover:not(:disabled) {
+    background: var(--accent);
+    opacity: 0.9;
+    transform: scale(1.02);
+}
+
+.search-btn:disabled {
+    background: var(--bg-base);
+    color: var(--text-muted);
+    opacity: 0.4;
+    border: 1px solid var(--border);
+    cursor: not-allowed;
+}
+
+/* Typing / Loading Indicators */
+.message-bubble.pending-bubble {
+    border-color: var(--accent-glow);
+    background: var(--accent-glow);
+    max-width: 450px;
+}
+
+.typing-indicator {
     display: flex;
-    flex-direction: column;
+    gap: 4px;
     align-items: center;
-    justify-content: center;
-    height: 100%;
+    margin-bottom: 0.6rem;
 }
 
-.welcome-icon {
-    color: rgba(0, 255, 153, 0.4);
-    margin-bottom: 1.5rem;
-    filter: drop-shadow(0 0 10px rgba(0, 255, 153, 0.2));
-    animation: pulse 2.5s infinite alternate;
+.typing-indicator span {
+    width: 7px;
+    height: 7px;
+    background: var(--accent);
+    border-radius: 50%;
+    display: inline-block;
+    animation: typing-bounce 1.4s infinite ease-in-out both;
 }
 
-.welcome-state h3 {
-    color: #ffffff;
-    font-size: 1.5rem;
-    margin: 0 0 0.75rem 0;
-}
+.typing-indicator span:nth-child(1) { animation-delay: -0.32s; }
+.typing-indicator span:nth-child(2) { animation-delay: -0.16s; }
 
-.welcome-state p {
-    max-width: 550px;
-    margin: 0;
-    font-size: 0.95rem;
-    line-height: 1.6;
+.loading-label {
+    font-size: 0.825rem;
+    color: var(--text-muted);
+    font-style: italic;
 }
 
 .btn-spinner {
-    width: 20px;
-    height: 20px;
-    border: 2px solid rgba(0, 0, 0, 0.1);
+    width: 18px;
+    height: 18px;
+    border: 2px solid var(--border);
     border-radius: 50%;
-    border-top-color: #000000;
+    border-top-color: var(--accent);
     animation: spin 0.8s linear infinite;
 }
 
-/* Keyframe Animations */
-@keyframes bubble-fade-in {
-    0% { opacity: 0; transform: translateY(10px) scale(0.98); }
-    100% { opacity: 1; transform: translateY(0) scale(1); }
+/* Animations */
+@keyframes fadeIn {
+    from { opacity: 0; }
+    to { opacity: 1; }
+}
+
+@keyframes fade-in-up {
+    0% { opacity: 0; transform: translateY(15px); }
+    100% { opacity: 1; transform: translateY(0); }
 }
 
 @keyframes typing-bounce {
@@ -357,12 +258,70 @@
     50% { transform: translateY(-4px); }
 }
 
-@keyframes pulse {
-    0% { transform: scale(0.96); opacity: 0.8; }
-    100% { transform: scale(1.04); opacity: 1; }
-}
-
 @keyframes spin {
     0% { transform: rotate(0deg); }
     100% { transform: rotate(360deg); }
 }
+
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .welcome-prompt {
+    color: var(--text-main);
+}
+
+.theme-light .welcome-icon svg {
+    stroke: var(--text-muted);
+}
+
+.theme-light .welcome-icon svg circle {
+    fill: var(--text-muted);
+}
+
+.theme-light .welcome-icon svg path[stroke^="rgba(139"] {
+    stroke: rgba(120, 113, 108, 0.4);
+}
+
+.theme-light .welcome-icon svg path[stroke^="rgba(139"][stroke-dasharray] {
+    stroke: rgba(120, 113, 108, 0.3);
+}
+
+.theme-light .input-field-group {
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    box-shadow: 0 10px 30px rgba(139, 130, 115, 0.08);
+}
+
+.theme-light .input-field-group:focus-within {
+    border-color: var(--accent);
+    box-shadow: 0 10px 35px rgba(16, 185, 129, 0.15);
+}
+
+.theme-light .nexus-input {
+    color: var(--text-main);
+}
+
+.theme-light .nexus-input::placeholder {
+    color: var(--text-muted);
+}
+
+.theme-light .nexus-select {
+    background-color: var(--bg-surface);
+    border-color: var(--border);
+    color: var(--text-main);
+}
+
+.theme-light .nexus-select:focus {
+    border-color: var(--accent);
+    box-shadow: 0 0 8px var(--accent-glow);
+}
+
+.theme-light .chat-thread-container::-webkit-scrollbar-thumb {
+    background: rgba(0, 0, 0, 0.1);
+}
+
+.theme-light .chat-thread-container::-webkit-scrollbar-thumb:hover {
+    background: rgba(0, 0, 0, 0.2);
+}
+

src/NexusReader.UI.Shared/Pages/MyBooks.razor

@@ -1,11 +1,15 @@
 @page "/my-books"
 @attribute [Authorize]
+@implements IDisposable
 @using NexusReader.UI.Shared.Components.Organisms
 @using NexusReader.Application.DTOs.User
 @using NexusReader.UI.Shared.Services
+@using Microsoft.Extensions.Logging
 @using System.Net.Http.Json
 @inject HttpClient Http
 @inject IReaderNavigationService ReaderNavigation
+@inject ILibraryStateService LibraryStateService
+@inject ILogger<MyBooks> Logger
 
 <div class="my-books-page">
     <header class="my-books-header">
@@ -108,6 +112,11 @@
     private bool _isLoading = true;
     private List<LastReadBookDto>? _books;
 
+    protected override void OnInitialized()
+    {
+        LibraryStateService.OnBooksChanged += HandleBooksChanged;
+    }
+
     protected override async Task OnAfterRenderAsync(bool firstRender)
     {
         if (firstRender)
@@ -116,6 +125,11 @@
         }
     }
 
+    private void HandleBooksChanged()
+    {
+        _ = InvokeAsync(LoadBooksAsync);
+    }
+
     private async Task LoadBooksAsync()
     {
         _isLoading = true;
@@ -128,7 +142,7 @@
         }
         catch (Exception ex)
         {
-            Console.WriteLine($"[MyBooks] Failed to load books: {ex.Message}");
+            Logger.LogError(ex, "[MyBooks] Failed to load books.");
             if (OperatingSystem.IsBrowser())
             {
                 _isLoading = false;
@@ -149,4 +163,9 @@
     {
         ReaderNavigation.NavigateToBook(bookId);
     }
+
+    public void Dispose()
+    {
+        LibraryStateService.OnBooksChanged -= HandleBooksChanged;
+    }
 }

src/NexusReader.UI.Shared/Pages/MyBooks.razor.css

@@ -19,13 +19,13 @@
     font-size: 2.5rem;
     font-weight: 700;
     margin: 0 0 0.5rem 0;
-    color: #ffffff;
+    color: var(--text-main);
     letter-spacing: -0.5px;
 }
 
 .header-title-section .subtitle {
     font-size: 1rem;
-    color: #a1a1aa;
+    color: var(--text-muted);
     margin: 0;
 }
 
@@ -67,27 +67,27 @@
     height: 100%;
     overflow: hidden;
     border-radius: 12px;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
     position: relative;
 }
 
 .book-card:hover {
     transform: translateY(-4px);
-    box-shadow: 0 12px 30px rgba(0, 0, 0, 0.3);
-    border-color: rgba(16, 185, 129, 0.2);
+    box-shadow: 0 12px 30px rgba(0, 0, 0, 0.1);
+    border-color: var(--accent);
 }
 
 .book-cover-container {
     position: relative;
     height: 360px;
-    background: rgba(0, 0, 0, 0.2);
+    background: rgba(0, 0, 0, 0.05);
     overflow: hidden;
     display: flex;
     align-items: center;
     justify-content: center;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    border-bottom: 1px solid var(--border);
 }
 
 .book-cover {
@@ -145,7 +145,7 @@
     font-size: 1.2rem;
     font-weight: 600;
     margin: 0 0 0.4rem 0;
-    color: #ffffff;
+    color: var(--text-main);
     overflow: hidden;
     text-overflow: ellipsis;
     white-space: nowrap;
@@ -154,7 +154,7 @@
 
 .book-author {
     font-size: 0.9rem;
-    color: #a1a1aa;
+    color: var(--text-muted);
     margin: 0 0 1.25rem 0;
 }
 
@@ -179,7 +179,7 @@
 
 .progress-bar {
     height: 6px;
-    background: rgba(255, 255, 255, 0.05);
+    background: var(--border);
     border-radius: 3px;
     overflow: hidden;
 }
@@ -192,7 +192,7 @@
 
 .progress-text {
     font-size: 0.8rem;
-    color: #a1a1aa;
+    color: var(--text-muted);
     white-space: nowrap;
     overflow: hidden;
     text-overflow: ellipsis;
@@ -232,14 +232,14 @@
     justify-content: center;
     padding: 5rem 2rem;
     text-align: center;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     border-radius: 12px;
 }
 
 .empty-icon-pulse {
     margin-bottom: 2rem;
-    color: #a1a1aa;
+    color: var(--text-muted);
     animation: pulse 3s infinite alternate;
 }
 
@@ -247,11 +247,11 @@
     font-family: var(--nexus-font-serif);
     font-size: 1.8rem;
     margin: 0 0 0.5rem 0;
-    color: #ffffff;
+    color: var(--text-main);
 }
 
 .empty-state-container p {
-    color: #a1a1aa;
+    color: var(--text-muted);
     max-width: 400px;
     margin: 0 0 2rem 0;
 }
@@ -278,14 +278,14 @@
     border-radius: 12px;
     overflow: hidden;
     height: 480px;
-    background: #1a1a1e;
-    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
     opacity: 0.6;
 }
 
 .skeleton-cover {
     height: 360px;
-    background: linear-gradient(90deg, rgba(255,255,255,0.02) 25%, rgba(255,255,255,0.06) 50%, rgba(255,255,255,0.02) 75%);
+    background: linear-gradient(90deg, var(--bg-base) 25%, var(--border) 50%, var(--bg-base) 75%);
     background-size: 200% 100%;
     animation: loading 1.5s infinite;
 }
@@ -298,7 +298,7 @@
 }
 
 .skeleton-line {
-    background: linear-gradient(90deg, rgba(255,255,255,0.02) 25%, rgba(255,255,255,0.06) 50%, rgba(255,255,255,0.02) 75%);
+    background: linear-gradient(90deg, var(--bg-base) 25%, var(--border) 50%, var(--bg-base) 75%);
     background-size: 200% 100%;
     animation: loading 1.5s infinite;
     border-radius: 4px;
@@ -336,9 +336,9 @@
     gap: 1.25rem;
     padding: 1.25rem 2.25rem;
     border-radius: 40px;
-    background: rgba(13, 13, 15, 0.85);
+    background: var(--bg-surface);
     backdrop-filter: blur(16px);
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    border: 1px solid var(--border);
     animation: scaleIn 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
 }
 
@@ -354,7 +354,7 @@
 
 .loader-text {
     font-weight: 500;
-    color: #ffffff;
+    color: var(--text-main);
     font-size: 0.95rem;
 }
 
@@ -383,3 +383,65 @@
     from { transform: translate(-50%, -50%) scale(0.9); opacity: 0; }
     to { transform: translate(-50%, -50%) scale(1); opacity: 1; }
 }
+
+/* ============================================
+   LIGHT THEME OVERRIDES — Warm Paper / Soft Sepia
+   ============================================ */
+
+.theme-light .book-card:hover {
+    box-shadow: 0 12px 30px rgba(139, 130, 115, 0.15);
+}
+
+.theme-light .book-cover-container {
+    background: rgba(0, 0, 0, 0.03);
+}
+
+.theme-light .cover-overlay {
+    background: rgba(0, 0, 0, 0.5);
+}
+
+.theme-light .book-card:hover .read-action {
+    color: #292524;
+}
+
+.theme-light .progress-bar {
+    background: #e4e1d9;
+}
+
+@media (max-width: 767px) {
+    .my-books-page {
+        padding: 1.5rem 1rem calc(1.5rem + 72px + env(safe-area-inset-bottom, 0px)) !important;
+    }
+    
+    .my-books-header {
+        margin-bottom: 1.5rem;
+        flex-direction: column;
+        align-items: stretch;
+        gap: 1rem;
+    }
+    
+    .header-title-section h1 {
+        font-size: 1.75rem;
+        text-align: center;
+    }
+
+    .header-title-section .subtitle {
+        text-align: center;
+    }
+    
+    .add-book-trigger {
+        width: 100%;
+        text-align: center;
+        padding: 0.9rem 1.5rem;
+    }
+    
+    .books-grid, .loading-grid {
+        grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+        gap: 1.25rem;
+    }
+
+    .book-cover-container {
+        height: 200px !important;
+    }
+}
+

src/NexusReader.UI.Shared/Pages/Settings.razor.css

@@ -72,3 +72,40 @@
     from { opacity: 0; transform: translateY(15px); }
     to { opacity: 1; transform: translateY(0); }
 }
+
+/* ============================================================
+   LIGHT THEME OVERRIDES — "Warm Paper / Soft Sepia"
+   ============================================================ */
+
+.theme-light .settings-page > h1 {
+    background: none;
+    -webkit-text-fill-color: initial;
+    color: var(--text-main);
+}
+
+.theme-light .settings-page > p {
+    color: var(--text-muted);
+}
+
+.theme-light .settings-section h2 {
+    color: var(--text-main);
+}
+
+.theme-light .settings-section p {
+    color: var(--text-muted);
+}
+
+.theme-light .diag-btn {
+    background: rgba(16, 185, 129, 0.05);
+    color: var(--accent);
+    border: 1px solid rgba(16, 185, 129, 0.2);
+}
+
+.theme-light .diag-btn:hover {
+    background: var(--accent);
+    color: #ffffff;
+    border-color: var(--accent);
+    box-shadow: 0 0 10px rgba(16, 185, 129, 0.2);
+    transform: translateY(-2px);
+}
+

src/NexusReader.UI.Shared/Services/ILibraryStateService.cs

@@ -0,0 +1,12 @@
+using System;
+using System.Collections.Generic;
+using NexusReader.Application.DTOs.User;
+
+namespace NexusReader.UI.Shared.Services;
+
+public interface ILibraryStateService
+{
+    List<LastReadBookDto>? OwnedBooks { get; set; }
+    event Action? OnBooksChanged;
+    void NotifyBooksChanged();
+}

src/NexusReader.UI.Shared/Services/IRecommendationService.cs

@@ -0,0 +1,23 @@
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using NexusReader.Application.Queries.Recommendations;
+
+namespace NexusReader.UI.Shared.Services;
+
+/// <summary>
+/// Provides contextual book recommendations based on the user's active reading state.
+/// Abstracts the HTTP transport layer from Blazor UI components.
+/// </summary>
+public interface IRecommendationService
+{
+    /// <summary>
+    /// Fetches contextual recommendations for the authenticated user.
+    /// </summary>
+    /// <param name="cancellationToken">A token to cancel the operation.</param>
+    /// <returns>
+    /// A list of <see cref="RecommendationDto"/> on success, or an empty list when none are available.
+    /// Returns <c>null</c> if the request fails due to a transport or server error.
+    /// </returns>
+    Task<List<RecommendationDto>?> GetRecommendationsAsync(CancellationToken cancellationToken = default);
+}

src/NexusReader.UI.Shared/Services/IThemeService.cs

@@ -1,9 +1,14 @@
+using NexusReader.Domain.Enums;
+
 namespace NexusReader.UI.Shared.Services;
 
 public interface IThemeService
 {
+    ThemeMode Mode { get; }
     bool IsLightMode { get; }
-    event Func<Task>? OnThemeChanged;
+    event Action<ThemeMode>? OnThemeChanged;
+    
     Task InitializeAsync();
+    Task SetThemeAsync(ThemeMode mode);
     Task ToggleTheme();
 }

src/NexusReader.UI.Shared/Services/LibraryStateService.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using NexusReader.Application.DTOs.User;
+
+namespace NexusReader.UI.Shared.Services;
+
+public class LibraryStateService : ILibraryStateService
+{
+    private List<LastReadBookDto>? _ownedBooks;
+
+    public List<LastReadBookDto>? OwnedBooks
+    {
+        get => _ownedBooks;
+        set
+        {
+            _ownedBooks = value;
+            NotifyBooksChanged();
+        }
+    }
+
+    public event Action? OnBooksChanged;
+
+    public void NotifyBooksChanged()
+    {
+        OnBooksChanged?.Invoke();
+    }
+}

src/NexusReader.UI.Shared/Services/PaywallParser.cs

@@ -0,0 +1,72 @@
+using System;
+
+namespace NexusReader.UI.Shared.Services;
+
+/// <summary>
+/// AOT-safe string parsing utility to isolate paywall teaser details without regex overhead.
+/// </summary>
+public static class PaywallParser
+{
+    public static bool TryParsePaywallTrigger(
+        string rawText,
+        out string displayTeaserText,
+        out Guid lockedBookId,
+        out string lockedBookTitle,
+        out int localScore,
+        out int globalScore)
+    {
+        displayTeaserText = rawText;
+        lockedBookId = Guid.Empty;
+        lockedBookTitle = string.Empty;
+        localScore = 0;
+        globalScore = 0;
+
+        if (string.IsNullOrEmpty(rawText))
+            return false;
+
+        ReadOnlySpan<char> span = rawText.AsSpan();
+        int tokenStartIndex = span.IndexOf("[PAYWALL_TRIGGER:");
+        if (tokenStartIndex == -1)
+            return false;
+
+        displayTeaserText = span.Slice(0, tokenStartIndex).Trim().ToString();
+
+        ReadOnlySpan<char> tokenContent = span.Slice(tokenStartIndex + "[PAYWALL_TRIGGER:".Length);
+        int tokenEndIndex = tokenContent.IndexOf(']');
+        if (tokenEndIndex == -1)
+            return false;
+
+        tokenContent = tokenContent.Slice(0, tokenEndIndex);
+
+        int firstColonIdx = tokenContent.IndexOf(':');
+        if (firstColonIdx == -1)
+            return false;
+
+        ReadOnlySpan<char> guidSpan = tokenContent.Slice(0, firstColonIdx);
+        if (!Guid.TryParse(guidSpan, out lockedBookId))
+            return false;
+
+        ReadOnlySpan<char> remaining = tokenContent.Slice(firstColonIdx + 1);
+
+        int lastColonIdx = remaining.LastIndexOf(':');
+        if (lastColonIdx == -1)
+            return false;
+
+        ReadOnlySpan<char> globalScoreSpan = remaining.Slice(lastColonIdx + 1);
+        if (!int.TryParse(globalScoreSpan, out globalScore))
+            return false;
+
+        remaining = remaining.Slice(0, lastColonIdx);
+
+        int secondLastColonIdx = remaining.LastIndexOf(':');
+        if (secondLastColonIdx == -1)
+            return false;
+
+        ReadOnlySpan<char> localScoreSpan = remaining.Slice(secondLastColonIdx + 1);
+        if (!int.TryParse(localScoreSpan, out localScore))
+            return false;
+
+        lockedBookTitle = remaining.Slice(0, secondLastColonIdx).ToString();
+        return true;
+    }
+}

src/NexusReader.UI.Shared/Services/ThemeService.cs

@@ -1,42 +1,155 @@
 using Microsoft.JSInterop;
+using NexusReader.Domain.Enums;
+using NexusReader.Application.Abstractions.Services;
 
 namespace NexusReader.UI.Shared.Services;
 
 public sealed class ThemeService : IThemeService
 {
     private readonly IJSRuntime _jsRuntime;
-    public bool IsLightMode { get; private set; } = false;
-    public event Func<Task>? OnThemeChanged;
+    private readonly IUserPreferenceStore _userPreferenceStore;
+    private readonly SemaphoreSlim _semaphore = new(1, 1);
+    private bool _isInitialized;
+    private bool _systemPrefersLight;
 
-    public ThemeService(IJSRuntime jsRuntime)
+    public ThemeMode Mode { get; private set; } = ThemeMode.System;
+
+    public bool IsLightMode => Mode == ThemeMode.LightSepia || (Mode == ThemeMode.System && _systemPrefersLight);
+
+    public event Action<ThemeMode>? OnThemeChanged;
+
+    public ThemeService(IJSRuntime jsRuntime, IUserPreferenceStore userPreferenceStore)
     {
         _jsRuntime = jsRuntime;
+        _userPreferenceStore = userPreferenceStore;
     }
 
     public async Task InitializeAsync()
     {
+        if (_isInitialized) return;
+
+        await _semaphore.WaitAsync();
         try
         {
-            IsLightMode = await _jsRuntime.InvokeAsync<bool>("themeInterop.isLightMode");
-            if (OnThemeChanged != null) await OnThemeChanged();
+            if (_isInitialized) return;
+
+            ThemeMode localMode = ThemeMode.System;
+            try
+            {
+                var cachedThemeVal = await _jsRuntime.InvokeAsync<string?>("localStorage.getItem", "theme-mode");
+                if (Enum.TryParse<ThemeMode>(cachedThemeVal, out var parsedMode))
+                {
+                    localMode = parsedMode;
+                }
+                else if (cachedThemeVal == "light" || cachedThemeVal == "theme-light")
+                {
+                    localMode = ThemeMode.LightSepia;
+                }
+                else if (cachedThemeVal == "dark" || cachedThemeVal == "theme-dark")
+                {
+                    localMode = ThemeMode.Dark;
+                }
+                
+                _systemPrefersLight = await _jsRuntime.InvokeAsync<bool>("themeInterop.isSystemLight");
             }
             catch
             {
-            // Fail silently during prerendering or if JS is not available yet
+                // Silent catch for pre-rendering or unit tests
+            }
+
+            Mode = localMode;
+            _isInitialized = true;
+            
+            await ApplyThemeToDomAsync(Mode);
+
+            // Asynchronously sync with the cloud to check for updates from other devices
+            _ = Task.Run(async () =>
+            {
+                try
+                {
+                    var cloudResult = await _userPreferenceStore.GetThemePreferenceAsync();
+                    if (cloudResult.IsSuccess && cloudResult.Value != Mode)
+                    {
+                        await SetThemeInternalAsync(cloudResult.Value, saveToCloud: false);
+                    }
+                }
+                catch
+                {
+                    // Fail silently for background task/network errors
+                }
+            });
+        }
+        finally
+        {
+            _semaphore.Release();
+        }
+    }
+
+    public async Task SetThemeAsync(ThemeMode mode)
+    {
+        await SetThemeInternalAsync(mode, saveToCloud: true);
+    }
+
+    private async Task SetThemeInternalAsync(ThemeMode mode, bool saveToCloud)
+    {
+        await _semaphore.WaitAsync();
+        try
+        {
+            if (Mode == mode && _isInitialized) return;
+
+            Mode = mode;
+            _isInitialized = true;
+
+            await ApplyThemeToDomAsync(mode);
+
+            OnThemeChanged?.Invoke(mode);
+
+            if (saveToCloud)
+            {
+                _ = Task.Run(async () =>
+                {
+                    try
+                    {
+                        await _userPreferenceStore.SaveThemePreferenceAsync(mode);
+                    }
+                    catch
+                    {
+                        // Fail silently for background cloud sync errors
+                    }
+                });
+            }
+        }
+        finally
+        {
+            _semaphore.Release();
         }
     }
 
     public async Task ToggleTheme()
     {
-        IsLightMode = !IsLightMode;
+        var nextMode = IsLightMode ? ThemeMode.Dark : ThemeMode.LightSepia;
+        await SetThemeAsync(nextMode);
+    }
+
+    private async Task ApplyThemeToDomAsync(ThemeMode mode)
+    {
         try
         {
-            await _jsRuntime.InvokeVoidAsync("themeInterop.setLightMode", IsLightMode);
+            string themeClass = "theme-dark"; // Default
+            if (mode == ThemeMode.LightSepia)
+            {
+                themeClass = "theme-light";
+            }
+            else if (mode == ThemeMode.System)
+            {
+                themeClass = _systemPrefersLight ? "theme-light" : "theme-dark";
+            }
+
+            await _jsRuntime.InvokeVoidAsync("themeInterop.setCachedTheme", themeClass, ((int)mode).ToString());
         }
         catch
         {
-            // Fail silently
+            // Silent catch for pre-rendering
         }
-        if (OnThemeChanged != null) await OnThemeChanged();
     }
 }

src/NexusReader.UI.Shared/_Imports.razor

@@ -20,3 +20,5 @@
 @using NexusReader.Application.Abstractions.Services
 @using NexusReader.Application.DTOs.User
 @using NexusReader.Application.Queries.Reader
+@using NexusReader.Application.Queries.Recommendations
+@using NexusReader.Domain.Enums