Lumina transforms the traditional personal website into a living, breathing knowledge ecosystem. Imagine your professional portfolio not as a museum of past achievements, but as an interactive garden where ideas grow, connect, and bear fruit for visitors. This platform merges the depth of a technical blog, the clarity of a resume, and the engagement of a personal wiki into a single, cohesive experience powered by semantic connections and real-time interactivity.
Built for developers, researchers, writers, and thinkers who want their digital home to reflect the dynamic nature of their work, Lumina goes beyond displaying content—it contextualizes it. Articles reference projects, skills link to concrete examples, and your entire career narrative becomes navigable through multiple dimensions.
Traditional portfolios present information in silos: "Here are my articles," "Here are my projects," "Here is my resume." Lumina challenges this fragmentation by implementing a Knowledge Graph Engine that automatically discovers and visualizes relationships between all your content. A mention of "machine learning" in a 2025 article automatically links to your 2026 project implementing those concepts. Your resume skills section becomes a live index pointing to every piece of content that demonstrates that skill.
- Auto-Generated Knowledge Graph: Every piece of content is parsed for entities, technologies, and concepts. These become nodes in an interactive graph, allowing visitors to explore your expertise thematically rather than chronologically.
- Bi-Directional Content Linking: Any tag, skill, or project name becomes a portal. Click "Rust" to see every article, project note, and resume bullet mentioning it, all in one curated view.
- Temporal & Conceptual Filtering: View your work timeline, filter by technology stack, or explore by thematic clusters like "Systems Design" or "Open Source Contributions."
- Context-Aware Layouts: The presentation layer morphs based on content type and visitor interaction. Reading an article? Relevant project cards gently appear in the margin. Viewing a project? Citations to related writing emerge.
- Responsive Narrative Engine: The "About Me" section is not static text but a configurable narrative assembled from your latest and most relevant achievements, always current.
- Multilingual Content Layer: Present your work in multiple languages seamlessly. The interface detects visitor preference and serves appropriately, with manual override. All content relationships are preserved across language boundaries.
- Unified API Gateway: A single, secure endpoint manages connections to external data sources: GitHub repositories, arXiv publications, Medium articles, conference talks. Your Lumina portal becomes the unified source of truth.
- OpenAI & Claude API Synergy: Optional AI-assisted modules can generate summaries, suggest connections between disparate projects, or help draft updates in your voice. These use official APIs with explicit user-triggered actions—no autonomous content generation.
- Real-Time Data Streams: Integrate live GitHub commit status, recent blog comments, or even current focus areas (pulled from a connected calendar or task manager) to show what you're exploring right now.
graph TB
subgraph "Data Ingestion Layer"
A[Markdown Articles] --> P(Parser Engine)
B[Project Metadata] --> P
C[Resume YAML] --> P
D[External APIs<br/>GitHub/arXiv etc.] --> P
end
P --> KG{Knowledge Graph<br/>Database}
subgraph "Processing & Logic Layer"
KG --> RL(Relationship Linker)
RL --> NG(Narrative Generator)
KG --> SS(Semantic Search Index)
end
subgraph "Presentation Layer"
NG --> VP[View: Portfolio]
NG --> VA[View: Article Hub]
NG --> VR[View: Interactive Resume]
SS --> VS[View: Knowledge Explorer]
end
VP & VA & VR & VS --> UI[Adaptive UI Engine]
UI --> Visitor[Visitor Browser/Device]
- Node.js 20+ or Bun 1.1+
- A GitHub repository for your content (or use our template)
- (Optional) API keys for OpenAI or Anthropic for enhanced features
-
Acquire the Framework
-
Deploy with One Command
bunx create-lumina-portal@latest my-knowledge-portal # or npx create-lumina-portal@latest my-knowledge-portal -
Navigate and Install
cd my-knowledge-portal bun install # or npm install / yarn install / pnpm install
Create a lumina.config.yml file at the root. This is the DNA of your portal:
# lumina.config.yml
persona:
name: "Alex Developer"
coreIdentity: "Systems thinker bridging hardware abstraction and developer experience"
currentFocus: "Edge computing protocols and resilient network design"
contentSources:
localPaths:
articles: "/content/thoughts/**/*.md"
projects: "/content/builds/*.yml"
notes: "/content/lab/*.mdx"
external:
- type: github
username: "yourusername"
include: ["repos", "gists"]
- type: rss
url: "https://your.blog/feed.xml"
knowledgeGraph:
autoLinkEntities: true
suggestedRelationships: moderate
privacyFilter: public-only # Options: public-only, include-private, curated
presentation:
defaultLanguage: en
supportedLanguages: [en, es, fr, ja]
theme: "dynamic-solar" # Built-in: dynamic-solar, deep-forest, quiet-mono
narrativeTone: "reflective-professional" # Options: concise-technical, reflective-professional, storytelling
integrations:
aiAssist:
openai:
enabled: false # Set to true and provide API key for features
model: "gpt-4-turbo"
claude:
enabled: false
model: "claude-3-opus-20240229"
liveData:
githubStatus: true
lastUpdatedBadge: true
security:
corsOrigins: ["https://yourdomain.com"]
rateLimiting: enabled# Development mode with hot-reload and graph visualization
bun run dev
# Build for production
bun run build
# Deploy to static hosting (outputs to /dist)
bun run deployExample Console Session:
$ bun run dev
🌱 Lumina Kernel initializing...
✓ Parsed 42 articles from /content/thoughts
✓ Ingested 8 projects from /content/builds
✓ Connected to GitHub API (12 repositories found)
🧠 Building knowledge graph... 156 entities identified
🔗 Establishing semantic links... 423 relationships created
🎨 Generating adaptive narrative for 'Alex Developer'...
✅ Ready! Portal active at http://localhost:4321
- Interactive Resume: /resume
- Knowledge Explorer: /explore
- Article Hub: /thoughts
📊 Graph Dashboard: http://localhost:4321/_graph| Platform | Status | Notes |
|---|---|---|
| 🪟 Windows 10/11 | ✅ Fully Supported | Best with WSL2 for build tools |
| 🍎 macOS 12+ | ✅ Native Support | ARM & Intel optimized |
| 🐧 Linux (kernel 5.4+) | ✅ Excellent Support | Preferred deployment environment |
| 📱 Mobile Browsers | ✅ Responsive UI | Touch-optimized knowledge graph navigation |
| 🐳 Docker Containers | ✅ Official Image | lumina/portal:latest |
| 🔶 Netlify / Vercel | ✅ One-Click Deploy | Zero-configuration deployment available |
| 🛡️ GitHub Pages | ✅ Static Export | Full functionality except real-time updates |
- Semantic Content Parsing: Extract meaning, not just keywords
- Responsive, Zero-JS Fallback UI: Accessible even without JavaScript
- Static Site Generation: Blazing fast performance, secure by design
- Multi-Format Content Support: Markdown, MDX, YAML, JSON, controlled plaintext
- Interactive Knowledge Visualization: D3.js powered graph exploration
- Client-Side Semantic Search: Find concepts, not just word matches
- Theme Engine with CSS Variables: Complete visual control
- Accessibility-First Components: WCAG 2.1 AA compliant out of the box
- AI-Assisted Content Curation: Suggest connections you might have missed
- Cross-Content Narrative Generation: Tell different stories from the same data
- Real-Time Collaboration Notes: Shared annotations for invited visitors
- Predictive Link Generation: Anticipate what visitors want to see next
Lumina is built with a privacy-first architecture:
- No tracking of visitors by default
- All AI processing optional and explicitly configured
- External API keys never leave your infrastructure
- Content sanitization built into all render pipelines
- CSP headers pre-configured for maximum security
This software is released under the MIT License. See the LICENSE file for complete terms. You retain full ownership of all content you create with Lumina. The framework makes no claim over your writing, code samples, or personal data.
When using OpenAI or Claude API integrations:
- All AI operations require explicit user configuration
- API keys are stored locally and never transmitted to our servers
- AI-generated suggestions are clearly marked as such
- You maintain editorial control over all published content
While Lumina includes patterns for displaying availability, any mention of "support" refers to community-maintained documentation and peer assistance in public forums. There is no guaranteed response time or service-level agreement unless explicitly arranged through a separate commercial agreement.
Lumina leverages modern web standards including ES2022 modules, CSS Grid, and the Web Components API. Visitors using browsers older than 2022 may experience degraded but functional experiences. The build process requires Node.js 20+ or equivalent runtime.
- Explore the Example Portal included in the download—it's a fully functional instance showcasing all features.
- Begin with Content Migration: Start by converting your existing resume to the structured YAML format.
- Gradually Enable Features: Turn on the knowledge graph, then external integrations, then optional AI features.
- Join the Community: Share your unique implementation and learn from others' approaches to digital identity.
In a digital landscape crowded with static profiles and disconnected content, Lumina offers a different paradigm: your online presence as a coherent, navigable, evolving representation of your intellectual journey. It's not merely a tool for displaying what you've done, but a framework for understanding how your ideas connect and evolve.
The platform grows with you. Every new article, project, or insight strengthens the connections, deepens the context, and enriches the narrative. Start with what you have today, and let it evolve into a true digital companion to your professional journey.
Ready to build your interconnected knowledge portal?
Lumina v2.1 • Designed for the interconnected mind • 2026