A personal learning project and self-hosted command center for your media and real-life quests.
Your games, movies, series, and anime library, backlog planner, playtime tracker, social hub, and RPG-style quest board in one place.
Overview | Features | Quick Start | Documentation | Tech Stack | Development | License
One sovereign cockpit for your entertainment backlog, playtime history, social gaming, and real-life RPG progression.
LuminaPath unifies your fragmented digital hobbies and channels them into real-world momentum. Instead of juggling separate services for game backlogs, anime watchlists, movie diaries, habit trackers, and gaming calendars, LuminaPath brings everything together into a single privacy-first, self-hosted command center.
flowchart TD
subgraph Ingest ["External Sync & Discovery"]
Steam["🎮 Steam & PlayStation"]
Meta["🎬 IGDB & RAWG Metadata"]
Cal["📅 Google Calendar"]
end
subgraph Hub ["LuminaPath Command Center"]
Core["Media Backlog & Playtime Engine"]
Quests["⚔️ RPG Quests & Real-Life Skill Trees"]
Social["🤝 Friends & Co-Op Sessions"]
AI["🧠 Streaming AI Assistant (Claude / Ollama)"]
end
subgraph Clients ["Two Purpose-Built Interfaces"]
App["📱 Everyday Client (Ionic / Angular 21)"]
Admin["⚙️ Control Panel (Blazor Server)"]
end
Steam --> Core
Meta --> Core
Core <--> Cal
Quests <--> Cal
Core --- Quests --- Social --- AI
Hub --> App
Hub --> Admin
|
Seamlessly organize games, movies, series, and anime. Track release dates, custom cover art, personal ratings, and detailed backlog status across all your platforms in one unified view. |
Log manual play sessions or sync playtime and trophies directly from Steam and PlayStation Network. Gain true insights into your gaming habits with estimated vs. actual playtime analytics. |
|
Turn real-life goals and habits into an interactive RPG. Structure your ambitions into Main Quests, Side Quests, Factions, and branching Skill Trees with XP and milestone tracking. |
A streaming AI assistant (Claude, Ollama, or vLLM) embedded directly in your app. It has secure, user-scoped read access to your library and can draft quests with confirm-first safety. |
|
Add friends, coordinate co-op gaming sessions, and chat directly without relying on big-tech platforms or telemetry. Your social graph stays strictly on your server. |
Deploy in seconds with Docker. Choose between local disk storage, AWS S3 / MinIO, or private Google Drive, with built-in zero-downtime migration and integrity verification tools. |
LuminaPath pairs a high-performance ASP.NET Core & PostgreSQL backend with two purpose-built frontends:
- Everyday Mobile & Web App (
:4200): Engineered with Angular 21 & Ionic for a fluid, responsive experience across phones, tablets, and desktop browsers. Features touch gestures, release calendars, and instant search. - Admin & Diagnostic Portal (
:4200/Admin): Powered by Blazor Server & MudBlazor for server administrators. Provides real-time storage health audits, ghost/orphan blob reconciliation, user role management, and background job telemetry.
- Multi-Media Catalog: Comprehensive tracking for games, movies, series, and anime with genres, platforms, cover images, and release calendars.
- Backlog & Playtime Tracking: Personal status (Backlog, In Progress, Completed, Abandoned), ratings, playtime estimates, and automatic totals combining manual logs and third-party imports.
- Third-Party Imports & Metadata: Connect Steam, PlayStation Network, IGDB, and RAWG to import library titles and play records.
- Google Calendar Sync: Push upcoming media release dates and scheduled quests directly into a dedicated Google Calendar.
- RPG Productivity System: Real-life quest board with main and side quests, skill trees, levels, and faction alignment.
- Streaming AI Assistant: In-app AI companion with user-scoped database tools and Model Context Protocol (MCP) server support.
- Flexible Storage Backends: Use local disk storage out of the box, or seamlessly connect AWS S3, Cloudflare R2, MinIO, Azure Blob, or personal Google Drive with zero-downtime migration tooling.
- Self-Hosted & Container-Ready: Single-command startup with Docker Compose, including health checks, automated database migrations, and optional local LLM execution.
Run LuminaPath with Docker Compose (v2.30+).
Copy the example environment file:
cp .env.example .env(On Windows PowerShell: Copy-Item .env.example .env)
Open .env and fill in the three required credentials:
POSTGRES_PASSWORD=your-strong-database-password
LUMINAPATH_ADMIN_EMAIL=you@example.com
LUMINAPATH_ADMIN_PASSWORD=your-strong-admin-passwordTip
The admin password must be at least 10 characters long and contain uppercase, lowercase, a number, and a special character.
Start all services in detached mode:
docker compose up -d- Web / Mobile App: http://localhost:4200
- Admin & Management: http://localhost:4200/Admin
Sign in using the admin email and password configured in your .env. Automatic database migrations run on startup, initializing your database immediately.
docker compose pull
docker compose up -dTo pin your deployment to a specific version, set LUMINAPATH_VERSION=1.2.3 in .env.
To build and run from local source instead of pulled registry images:
docker compose -f compose.yml -f compose.dev.yml up -d --buildOr build individual containers directly:
# Backend API
docker build -f src/LuminaPath/Dockerfile -t luminapath-api:local .
# Angular/Ionic Frontend
docker build -f src/LuminaPath.MobileApp/Dockerfile -t luminapath-frontend:local .Enable optional add-ons using the --profile flag or by setting COMPOSE_PROFILES in .env:
- Database Management (pgAdmin):
Access pgAdmin at http://localhost:5050 (
docker compose --profile tools up -d
admin@example.com/admin). - Nginx Reverse Proxy with TLS:
docker compose --profile proxy up -d
- Local AI with vLLM (GPU):
docker compose -f compose.yml -f compose.vllm.yml --profile nvidia up -d # or --profile amd
Comprehensive project documentation lives in the docs/ folder:
| Guide | Description |
|---|---|
| Configuration Reference | Full environment variable reference, network proxies, security headers, and secrets. |
| Storage Providers & Migration | S3, MinIO, Google Drive, Azure Blob setup, and zero-downtime migration runbooks. |
| AI Assistant & MCP Guide | AI chat architecture, database tool calling, and MCP server configuration. |
| Third-Party Integrations | Setup for Google Calendar sync, Steam, PSN, and IGDB/RAWG metadata. |
| Database Migrations | EF Core migration workflows and production SQL script generation. |
| Architecture & C4 Diagrams | Container architecture, system context, API reference, and design decisions (ADRs). |
| Local Setup & Development | Running .NET and Angular natively on your workstation. |
| Updating the App | Dependency upgrade guides and version maintenance. |
To preview the documentation site locally:
pip install -r requirements-docs.txt
mkdocs serve| Layer | Technologies |
|---|---|
| Backend API | .NET 10, ASP.NET Core, EF Core, ASP.NET Identity, Serilog |
| Admin Portal | Blazor Server, MudBlazor |
| Client Frontend | Angular 21, Ionic Framework, TypeScript, TailwindCSS |
| Database & Cache | PostgreSQL 17, Redis 7 |
| Storage Backends | Local Filesystem, AWS S3 / MinIO, Google Drive API, Azure Blob |
| AI Integration | Anthropic Claude, OpenAI-compatible APIs, vLLM, Model Context Protocol (MCP) |
| Deployment | Docker, Docker Compose, GitHub Actions |
Prerequisites for local development outside Docker:
- .NET 10 SDK
- Node.js 22+ & npm
- Running PostgreSQL 17 and Redis instances (or use
docker compose -f compose.yml up -d db redis)
# Run backend API & Blazor Admin
dotnet run --project src/LuminaPath/LuminaPath.csproj
# Run Angular/Ionic frontend
cd src/LuminaPath.MobileApp
npm install
npm startFor test execution, code style guidelines, and Android APK builds, see CONTRIBUTING.md.
LuminaPath source code and documentation are licensed under the GNU Affero General Public License, version 3 only (AGPL-3.0-only). See LICENSE for full terms.
Dependencies and bundled third-party libraries retain their respective licenses; see THIRD_PARTY_NOTICES.md for details.