| 1 |
# Navigation and mobile |
| 2 |
|
| 3 |
[](index.mdHelp index](index.md](index.md) · [](appearance.mdAppearance](appearance.md](appearance.md) · [](features.mdFeatures](features.md](features.md) |
| 4 |
|
| 5 |
## Put launchers where you want them |
| 6 |
|
| 7 |
Navigation lists the same live launcher registry the shell uses. Each placeable item can appear on its **rail**, on the **desktop**, on **both**, or be **hidden**. MIO's `set_navigation_placement` takes a returned item `id` and `placement` (`rail`, `desktop`, `both`, `hidden`). It merges just that item into existing preferences, preserving all others. |
| 8 |
|
| 9 |
In Split, a core menu's rail is the sidebar; other items use the dock. In Unified everything uses the one dock. The API value remains `rail`, so saved placement survives layout changes. |
| 10 |
|
| 11 |
Locked or transient launchers cannot be moved by MIO. Some system tiles are deliberately not placeable; they do not appear in its catalog. Hiding a launcher does not deactivate its plugin or delete its contents. The Mio tile can be hidden independently of whether the companion is enabled. |
| 12 |
|
| 13 |
## Phone layout |
| 14 |
|
| 15 |
`set_mobile_layout` accepts `auto`, `desktop`, or `mobile`. Automatic follows the viewport. Desktop forces the desktop experience, including on a phone. Mobile forces the phone interface, including on a large screen for previewing. Changing modes may alter or hide the current desktop conversation surface; completed settings writes remain in effect. |
| 16 |
|
| 17 |
## Phone tab bar pins |
| 18 |
|
| 19 |
The phone tab bar reserves slots for Home and the app switcher. Up to three additional launchers can be pinned in order. `list_options` returns `phonePins`; `set_mobile_tabs` accepts a unique list of up to three of those ids. Empty means “use the server defaults,” not “remove every pin.” Unknown or unavailable ids are rejected by the MIO action. |
| 20 |
|
| 21 |
To change a single pin while retaining others, read current settings and construct the desired complete list. Never replace the user's other pins unless requested. The phone's pin list is distinct from desktop Navigation placement. |
| 22 |
|
| 23 |
## Examples |
| 24 |
|
| 25 |
- “Put Media on the desktop and keep it in the dock”: look up its id and set placement `both`. |
| 26 |
- “Hide the MIO dock icon”: choose the Mio item's placement `hidden`; this does not disable MIO. |
| 27 |
- “Keep Posts, Pages and Media in the phone tabs”: look up their current ids, then set the three-item list in the requested order. |
| 28 |
|
