What is a menu?
A menu is the navigation that appears in the sidebar (or top bar) of your generated app. It's how end users find the lists, forms, and pages you've built.
You can have more than one menu per app — for example, one for Staff and another for Admin — and pick which appears based on the user's role.
What goes on a menu?
Each row on a menu is a menu item. Items come in three flavours:
| Type | What it does |
|---|---|
| Link | Clicking opens a route, URL, table list, or specific form |
| Header | A small heading that groups items underneath (no click) |
| Divider | A horizontal line between groups |
Most items are links. Headers and dividers are visual structure.
Two-level deep
Items can be nested one level — a parent link reveals children when clicked. Don't go deeper. Two levels is enough for any reasonable sidebar; deeper trees become hard to navigate.
Permissions
Every link can declare a permission — when set, the item only appears for users who have that permission. The same menu can show a slim view to staff and a wide view to admins, automatically.
Where to next
- Add menu items — step-by-step.
- Headers, dividers, and nesting — making a menu scannable.
- Permissions on menu items.
- Common mistakes.