Build for Luma.
Luma apps are built with LumaUI, Luma’s toolkit on GTK 4, and packaged as Flatpaks on the Luma Platform runtime. One app adapts to desktop, tablet and phone.
Point your agent here.
Plain Markdown, written for coding agents. Give it the link that matches the job, or llms.txt for everything.
Build a new app
Scaffold, LumaUI, luma-app.toml, checks and packaging.
https://simplyluma.com/developer/agents/build-an-app.mdDesign and front end
LumaUI’s rules, color, type, icons, layouts and interface writing.
https://simplyluma.com/developer/agents/design-with-lumaui.mdPublish to Depot
App IDs, the Flatpak manifest, store metadata and review.
https://simplyluma.com/developer/agents/publish-to-depot.md
Tools.
How to get each one, with the commands.
- Comes with LumaAvailable
luma command
Start a project, lint it against the app contract, and run its conformance checks.
- Luma remote, x86-64Available
Luma Platform and SDK
The Flatpak runtime Luma’s apps ship on, and the SDK to build against it.
- In the docsAvailable
LumaUI reference
Every component, what it’s for, and its Python and C names.
- Developer programComing
Depot publishing
Submit releases to Depot and follow their review. Opens with the developer program.
Documentation.
Getting started
Install, first window, project layout.
LumaUI
Windows, components, commands, adaptive layouts.
Design guidelines
Layout, type, color, motion, writing.
The stack
GTK 4, Flatpak, portals and runtimes.
luma-app.toml
Your app’s manifest, field by field, and what luma lint checks.
Permissions and privacy
Portals and what people see before installing.
Publishing to Depot
App IDs, listings, releases and updates.
Review Guidelines
What every release is checked for.
Publish on Depot.
The developer program is free. Applications aren’t open yet, so you can’t submit an app or suggest one for now. Depot lists apps in three tiers.
- Luma
- Built with LumaUI and reviewed for design, accessibility, privacy and quality.
- Verified
- From a developer whose identity Luma has checked. Hosted and signed by Luma.
- Listed
- A known app Luma lists but doesn’t host or review for quality.