Milestones · U2

The Launcher, in folders

Every App is reached from the first screen, however many there are, on a screen that reads at a glance. The Launcher's grid holds 12 tiles (4 × 3) and the firmware lists 13 Apps: Settings sat alone on a fourth row, under the…

Status: done (2026-11-17), checked on the device; to be released as v0.30.0 (Q361).

Goal: every App is reached from the first screen, however many there are, on a screen that reads at a glance. The Launcher's grid holds 12 tiles (4 × 3) and the firmware lists 13 Apps: Settings sat alone on a fourth row, under the fold. Games already showed the way: one tile, six Games inside.

Decisions (design round 2026-11-17)

#Decision
Q344Folders, not a denser grid (5 × 3) or a reshuffle: both put the problem off to the next App. It costs every App one more Enter.
Q345Changed by Q362. Five groups: Radio (Mesh, LoRa Scanner, GNSS), Network (IRC, SSH, Gemini, Wi-Fi Tools), Files (Notes, Storage), System (Settings, System, Shell), and Games. Wi-Fi Tools is about networks, not the radio; GNSS goes with the radios rather than alone.
Q346Changed by Q362. Only folders at the top level, no loose App kept one key away, Mesh included: what goes where is never a question, and five tiles fit the first screen.
Q347Changed by Q362. Games stays the App it is (its menu, its tunes, its best scores, its paused Games), a tile beside the four folders. Splitting it into six Apps buys nothing.
Q348An open folder looks like the Launcher: the same grid (2 × 2 since Q366), or the same list (Settings → Display → Launcher), with the folder's name as the Status Bar's title.
Q349Back goes up one level: from an App to its folder, the App still chosen; from a folder to the top level. Home goes to the top level, as before.
Q350A folder has a dot when any of its Apps has one (unread messages, a track, a capture, a session).
Q351Fixed in the firmware: each App's folder is part of its registration in main.cpp. No arranging them from the Settings.
Q352Recorded here; the guide's Basics page and the Launcher's screenshots follow, with one of an open folder.
Q353Four new icons, in the set's style (32 × 32, one bit, assets/icons): Radio an antenna with waves, Network three linked nodes, Files a folder, System a chip. Borrowing an App's icon would make a folder look like that App. As built, System is a toolbox: the System App's icon already is a chip. Files became Local, a house (Q364).
Q354The System App keeps its name: System → System is accurate, and cheaper than renaming the App, its Shell command, its guide page and S1's words.
Q355Changed by Q363. The order: Radio, Network, Files, System, Games; inside each, the App used most first, as listed in Q345.
Q356The choices are remembered (the folder at the top level, the App in each folder) while the device is on, not across a restart.
Q357No special case for a folder of one App: a folder always opens as a folder. None has only one today.
Q358Folders have no command. The Apps keep theirs (Mesh, Notes, …) in the Shell and the consoles, and open directly; the Debug Console reaches folders with key.
Q359The website groups the Apps the same way: the Apps page and the guide's index, under the same five headings in the same order.
Q360Back at the top level does nothing, as before.
Q361Released as v0.30.0, after a check on the device.

Decisions (second round, 2026-11-17)

Built as above, five tiles on a grid of 4 × 3 left most of the screen empty.

#Decision
Q362Games joins Files, and the folder is Local (id local): what reaches neither the radio nor the network. Four folders: Radio, Network, Local, System.
Q363Local holds Notes, Storage, Games, Games last: it opens on a row of its own.
Q364Local's icon is a house: here, on the device.
Q365The top level is 2 × 2: a tile is a 48-pixel icon with its name beside it, the chosen one filled with notched corners. The name under the grid goes: each tile has its own.
Q366A folder opens the same way, 2 × 2: none has more than four Apps. Names are in the bold font and go on two lines at a space when too wide (LoRa / Scanner, Wi-Fi / Tools). A fifth App would scroll.
Q367Every icon is a 16 × 16 picture, drawn at 2 (32 pixels, the Games' row) or 3 (48, the Launcher). All but Mesh were drawn on that grid already; Mesh is redrawn. A quarter of the flash.
Q368The list view doesn't change: one line each, > on a folder.

As built

  • AppInfo::folder and FolderInfo (lib/core/src/app_manager.h): an App names its folder when it is registered; AppManager::entries() gives the tiles of the level shown, the folders first and then the Apps outside any, each in the order registered. A folder with no visible App isn't shown.
  • The App manager keeps the folder open. back() (Back not taken by the App, and the Shell's quit) returns to the App's folder and says which App it left; home() (Home, and powering off) returns to the top level. foregroundTitle() is the folder's name inside one, for the Status Bar, the help panel and the consoles' app.
  • The Launcher (src/apps/launcher_app.cpp) draws the entries of the level, four tiles a screen (2 × 2: a 48-pixel icon and its name, Q365) or a list; Select enters a folder or opens an App, Back leaves a folder. It remembers a choice for each level. In the list, a folder ends with >, as the Settings' groups do. The help panel's Enter says "open".
  • Icons are 16 × 16 (assets/icons/*.png, Q367), made into 32-byte arrays in src/ui/icons.cpp by scripts/make_icons.py, and drawn at a scale by widgets::icon(). Four new ones for the folders (folder-*.png), and Mesh redrawn.
  • The registration in main.cpp is in the folders' order (Q355); the Apps that need others are made first, then registered.
  • The website: the Apps page under the four folders, the guide's index under the same headings with "Start here" first (Bluetooth with Radio, VPN with Network, Updates with System), the Basics page's Launcher section, and three screenshots: the Launcher, the Radio folder and the help panel.

Checks

CheckResult
Host tests803 pass (796 before): 7 for the folders (the top level, a folder's Apps and title, its dot, Back to the folder with the App chosen, Back from an App outside any folder, Home from an App and from a folder, leaving a folder)
On the device, grid (first round, 4 × 3)Five tiles. Radio opens on Mesh, LoRa Scanner, GNSS, titled Radio; Back from the LoRa Scanner lands on it in Radio; Back again on Radio at the top; Home from Settings lands on the top level with System still chosen
On the device, 2 × 2Radio, Network, Local, System, each a large icon with its name; Network's four Apps fill its screen, Wi-Fi / Tools and LoRa / Scanner on two lines; Local holds Notes, Storage, Games; the Games' own row of icons unchanged at 32 pixels
On the device, listRadio, Network, Files and System end with >; System opens on Settings, System, Shell
The help panel"Keys: Launcher", Enter: open

This page is generated from docs/milestones/U2.md in the repository. To change it, change that file and run site/tools/gen_dev_docs.py.