How simplyluma/luma works
Luma is an operating system and shared application platform. Its principal user journey is to install the OS, then use bundled applications and desktop services through a common adaptive UI; the update agent manages later system updates. The README also identifies Android compatibility, external app integrations, and device-specific profiles as meaningful branches. The graph combines those documented capabilities with sampled implementation modules; some subsystem links are therefore documented rather than traced through unsampled code.
Main entry points: prairie-core Shared Applications · Storage.jsx Atlas Installer · extensions Desktop Shell · image Luma OS
Components 20
Shared Platform
- Application Kit
src/luma-platform/appkit/luma_appkit - Application Portals
src/luma-platform/portal/luma_portal/apps.py
Bundled Applications
- Shared Applications
src/prairie-core - Disks App
src/luma-disks/luma_disks/app.py - Charlie Mail
src/external/charlie/charlie_luma/model.py - Viola Browser
src/external/viola/chromium-linux/appkit-spike
OS Services
- Desktop Shell
extensions - Background Manager
src/luma-background/luma_background/manager.py - Energy Manager
src/luma-energy/luma_energy/manager.py - Luma Tester
src/luma-tester/luma_tester/core.py
Install and Updates
- Atlas Installer
src/luma-installer-atlas/src/hooks/Storage.jsx - Storage Planning
src/luma-installer-atlas/src/apis/storage_partitioning.js - Luma OS
image - Update Agent
src/luma-update/luma_update/engine.py
Integrations
- Android Compatibility
src/luma-android/luma_android/engine.py - Android Kernel Layer
src/luma-android/luma_android/kernel.py - Device Profiles
config - Continuity
src/luma-continuity/luma_continuity/application.py - Windows App Relay
src/luma-relay/luma_relay/engine.py
Other components
- User
Connections 19
- User → Atlas Installer: installs through
README.md - Atlas Installer → Storage Planning: requests partitioning
src/luma-installer-atlas/src/hooks/Storage.jsx - Atlas Installer → Luma OS: installs
- Luma OS → Update Agent: receives updates
- User → Shared Applications: uses
README.md - Shared Applications → Application Kit: uses shared platform
README.md - Shared Applications → Application Portals: uses portals
README.md - User → Disks App: manages disks
- User → Charlie Mail: uses mail
README.md - User → Viola Browser: uses browser
README.md - User → Desktop Shell: interacts with
README.md - Desktop Shell → Android Compatibility: offers compatibility
README.md - Android Compatibility → Android Kernel Layer: uses kernel support
src/luma-android/luma_android/engine.py - User → Background Manager: controls background apps
- User → Energy Manager: uses power services
- User → Luma Tester: qualifies images
- User → Device Profiles: uses supported profiles
README.md - User → Continuity: uses continuity
- User → Windows App Relay: runs Windows apps