App Shells for Power Apps
An app shell is the frame around a screen: where the navigation sits, where your content goes, and what happens on a phone. Every shell here pastes onto an existing screen as a few containers, reads the screen size through Parent.Width, and carries a theme switch. Every shell needs a paid plan.
Pick a variant
- Sidebar App ShellPaidClassic, Modern
Desktop-first admin tools and dashboards; bottom tab bar on phones
Settings: Switches under "What's in the frame" (Brand, Theme switch, Signed-in user, Bottom tab bar on phones, Content placeholder), App name, Logo icon, Navigation (up to 12 items) with label, icon, Section switch and optional Screen
- Collapsible Sidebar App ShellPaidClassic, Modern
Dashboards where a wide table or chart needs the room: the sidebar folds to a 64 px icon rail
Settings: The same as Sidebar App Shell
- Top Nav App ShellPaidClassic, Modern
Small internal tools with up to six sections, when a sidebar feels too heavy
Settings: The five switches of the Sidebar App Shell, App name, Logo icon, Tabs with label, icon and optional Screen (the first six show in the header)
- Mobile App ShellPaidClassic, Modern
Frontline apps used on a phone: inspections, timesheets, deliveries
Settings: Switches (Header, App tile in the header, Theme switch, Signed-in user avatar, Content placeholder), App name, Logo icon, Tabs (the bar shows the first five)
- Portal App ShellPaidClassic, Modern
Self-service portals such as an IT request desk or an HR portal, with a centred column that never gets too wide
Settings: The five switches of the Sidebar App Shell plus Page band, App name, Logo icon, Subtitle, Primary action (empty for none), Tabs (the first six show in the header)
- Split View App ShellPaidClassic, Modern
Helpdesk, CRM, approvals desk or inbox: list on the left, detail on the right
Settings: The five switches of the Sidebar App Shell, App name, Logo icon, List title, sample rows with Title, Subtitle and a status, Rail icons (up to 12)
| Component | Plan | YAML | What it is for | Settings you can change |
|---|---|---|---|---|
| Sidebar App Shell | Paid | Classic, Modern | Desktop-first admin tools and dashboards; bottom tab bar on phones | Switches under "What's in the frame" (Brand, Theme switch, Signed-in user, Bottom tab bar on phones, Content placeholder), App name, Logo icon, Navigation (up to 12 items) with label, icon, Section switch and optional Screen |
| Collapsible Sidebar App Shell | Paid | Classic, Modern | Dashboards where a wide table or chart needs the room: the sidebar folds to a 64 px icon rail | The same as Sidebar App Shell |
| Top Nav App Shell | Paid | Classic, Modern | Small internal tools with up to six sections, when a sidebar feels too heavy | The five switches of the Sidebar App Shell, App name, Logo icon, Tabs with label, icon and optional Screen (the first six show in the header) |
| Mobile App Shell | Paid | Classic, Modern | Frontline apps used on a phone: inspections, timesheets, deliveries | Switches (Header, App tile in the header, Theme switch, Signed-in user avatar, Content placeholder), App name, Logo icon, Tabs (the bar shows the first five) |
| Portal App Shell | Paid | Classic, Modern | Self-service portals such as an IT request desk or an HR portal, with a centred column that never gets too wide | The five switches of the Sidebar App Shell plus Page band, App name, Logo icon, Subtitle, Primary action (empty for none), Tabs (the first six show in the header) |
| Split View App Shell | Paid | Classic, Modern | Helpdesk, CRM, approvals desk or inbox: list on the left, detail on the right | The five switches of the Sidebar App Shell, App name, Logo icon, List title, sample rows with Title, Subtitle and a status, Rail icons (up to 12) |
Paid means any paid plan (which plan do I need?). Classic and Modern are the two Power Apps control sets you can pick from the Copy YAML button. Open the category in the library: App Shells.
To copy a variant into Power Apps Studio, follow Getting Started.
After you paste
Click the screen in the Tree view and paste. The frame fills the screen; every size is a formula on the screen, so it fits phones, tablets and desktops. Put your own controls inside the content container (conShellContent on the Sidebar App Shell; on Split View it is the detail container, conSplitShellDetail) and delete the placeholder labels. Paste the same shell on every screen, or build the app on one screen with containers that show and hide.
Each shell has its own global variables, named after the shell so two shells never fight. For the Sidebar App Shell they are gblShellNav (the number of the active item), gblShellPage (its label) and gblShellDark (the theme switch). The other shells put their own stem where Shell stands: RailShell for the collapsible one, which adds gblRailShellRail (true while the sidebar is folded), then TopShell, MobileShell, PortalShell and SplitShell. Names use your prefix settings.
Tapping a navigation item sets the number and the label. Both are blank until the first tap, and the number counts section rows too: with the default items of the Sidebar App Shell, Home is 2, not 1. So compare the label, and let the first page fall back with Coalesce. To show one page container at a time on a single screen:
// conHomePage, Visible
Coalesce(gblShellPage, "Home") = "Home"
// conRequestsPage, Visible
gblShellPage = "Requests"
To navigate to real screens instead, type the screen name into the Screen field of each item in Settings. The item then also runs Navigate(YourScreen). The screen must exist in the app before you paste, or Studio says the name is not recognized.
The theme switch flips the dark variable. Every surface color in the YAML is If(gblShellDark, dark, light), so the whole frame changes at once and your own controls can read the same variable. The variable is blank until someone taps the switch, so the app opens light, whatever theme the preview showed. Switch the part off in Settings for plain colors in the preview theme; the YAML then has no dark variable.
// Your own control, Fill
If(gblShellDark, RGBA(21, 30, 48, 1), RGBA(255, 255, 255, 1))
Good to know
- Below 768 px the sidebar, the rail or the tabs hide and a bottom tab bar with the first five items appears. The Mobile App Shell keeps the bottom bar at every size. Nothing to set in Power Apps for this, the formulas read
Parent.Width. They hide even when Bottom tab bar on phones is switched off, so leave it on unless the app only runs on wide screens. - The user footer reads
User().FullNameandUser().Email; the avatars show the initials ofUser().FullName. Nothing to connect. - The Split View App Shell keeps the selected row in
gblSplitShellRow, a whole record. Its list is a gallery over a small sample table with a search filter; replace the Table in Items with your list and keep the columns id, title, subtitle and status, or change the formulas that read them: the search filter, the row labels, the row highlight and the detail header. - The Portal App Shell's column is
Min(960, Parent.Width - 48). To change the width, replace 960 in the X and Width ofconPortalShellContent, of the two band labels, and in the X of the band button. That button,btnPortalShellBandAction, is pasted with a placeholder in OnSelect; put your own formula there. - App name does not show on the Mobile and Split View shells, which only have room for the logo tile: it is pasted as a hidden label.
- Every shell has Classic and Modern YAML with the same layout.
Related
Open the family in the library at App Shells. Related guides: Sidebars, Navigation Bars and Speed Dial.