Skip to content
pmLet’s talk
All projects

Lumen Frontier

A widget OS and a 3D universe for learning.

Lumen Frontier is the experimental front-end of the Lumen learning project: an attempt to make studying feel like a place instead of a form. One landing page splits into two very different interfaces. LumenOS is a desktop-style dashboard where every study tool is a widget you drag, resize, and arrange on an open canvas, with the whole layout saved locally so it comes back exactly how you left it. Lumenverse is a first-person 3D space, hand-built in Three.js, where each academic subject is a glowing planet you fly toward as a tethered astronaut, mouse-look and WASD included.

Lumen Frontier: project preview
Role
Product design and engineering
Year
2025
Platform
Software project
Status
live

The problem

Most study apps are a login wrapped around a feature list, and they all feel the same. Lumen Frontier treats the interface itself as the product: knowledge you can lay out like a workspace, or fly through like a solar system, so the act of studying feels less like filling out a form and more like moving through a space you own.

What I built

The work includes @lumen-frontier/frontend, LumenOS, Lumenverse.

The choices behind it.

Solo · design + engineering

Implementation choice

One landing page, two full front-ends: a draggable widget "OS" (LumenOS) and a first-person 3D knowledge explorer (Lumenverse), each with its own layout and interaction model.

Implementation choice

Registry-driven widget system with 13 working widgets (notes, tasks, pomodoro, goals, journal, music, ambience, stats, flashcards, and more), each lazy-loaded into its own chunk via React.lazy + Suspense.

Implementation choice

Custom useDrag and useResize hooks give every widget header-drag and corner-resize with per-widget min/max constraints, and the full canvas persists to localStorage with a migration shim that upgrades older saved layouts.

Implementation choice

A 985-line hand-written Three.js scene: astronaut POV (gloves, visor, HUD lines), a tethered spaceship, 18 subject planets with layered atmospheric glow, pointer-lock mouse-look, WASD flight, fullscreen immersive mode, and a rocket fly-to animation.

Implementation choice

Performance-tuned WebGL: capped device pixel ratio, simplified sphere geometry, shadows disabled, a trimmed 1,000-star field, and Vite manual chunks that split three from the react vendor bundle.

Implementation choice

Astro islands architecture with nanostores as the cross-island state bus, an 'Old Money' Tailwind theme (brass, burgundy, cognac, forest, ivory), glassmorphism panels via Tailwind backdrop-blur, and GitHub Actions CI that builds the frontend and lints, types, and tests the backend.

interactive widgets
13
explorable subject planets
18
Build detail
985-line hand-written Three.js scene
lines of frontend TS/TSX/Astro
~9,200

Under the surface.

@lumen-frontier/frontend

app

The deployed Astro 4 site with React 18 islands, serving three routes (landing, dashboard, and the 3D lumenverse) with TypeScript, Tailwind, and nanostores as the state bus between islands.

LumenOS

app

A desktop-style study dashboard where every tool is a widget you drag by its header, resize from the corner, add from a categorized marketplace, and arrange on a canvas that saves back to localStorage.

Lumenverse

app

A 985-line Three.js first-person scene where each subject is a glowing planet you fly to as a tethered astronaut, with helmet visor, gloves, a HUD, pointer-lock mouse-look, WASD flight, and a rocket fly-to animation.

widget-system

library

The registry-driven engine behind LumenOS: it lazy-loads 13 widgets with React.lazy and Suspense and runs direct manipulation through custom useDrag and useResize hooks with per-widget size limits.

backend

service

A FastAPI scaffold for future auth and cross-device sync, wired for SQLAlchemy and Supabase, currently a stub that is excluded from the Vercel build.

api

service

A Vercel serverless handler at api/index.py that wraps the FastAPI app with Mangum for ASGI compatibility, ready as the entry point once the backend goes live.

Build details Stack, scope, and implementation

Built with

  • Astro 4
  • React 18
  • TypeScript 5
  • Three.js r180
  • Tailwind CSS 3
  • nanostores
  • Vite
  • FastAPI (scaffold)
  • npm workspaces
  • Vercel

Areas

  • EdTech
  • 3D / WebGL
  • Widget dashboard
  • Astro islands
  • Three.js
  • Frontend

More about the project

Under the hood it is an Astro islands app: static HTML by default, React only where things need to be interactive, and nanostores as the shared brain between islands. The widget system is registry-driven and code-split, so each of the thirteen widgets loads as its own chunk on demand. A FastAPI backend is scaffolded for future auth and cross-device sync, but today the app runs entirely in the browser and persists to localStorage.

Try the product.

Interactive demo · Open full screen