Settings shellPro
The frame for settings: Back to app, a search that finds any setting, Personal and Workspace pages, and a centred column of switches, menus and checked fields, destructive actions confirmed in place, and a save bar that collects every change.
oxyn add settingsSettings / Alerts
Alerts
What reaches you, where, and when it waits until morning.
Digest
One summary of what agents did
Your local time
Tell me about
An agent needs a yes before it acts
Someone names you in a chat
Quiet hours
22:00 to 07:00; email still arrives
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- The frame every settings page sits in, with nine pages to show what it holds.
When not to use
- Mail folders with counts and labels beside a message list: use Inbox sidebar instead.
- The app frame: use App shell instead.
- An assistant docked beside a page: use AI side panel instead.
Installation
Settings shell is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add settingsUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Sample
Sample data in the Inset frame.
Settings / Alerts
Alerts
What reaches you, where, and when it waits until morning.
Digest
One summary of what agents did
Your local time
Tell me about
An agent needs a yes before it acts
Someone names you in a chat
Quiet hours
22:00 to 07:00; email still arrives
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Flat
The same screen in the Flat frame.
Settings / Alerts
Alerts
What reaches you, where, and when it waits until morning.
Digest
One summary of what agents did
Your local time
Tell me about
An agent needs a yes before it acts
Someone names you in a chat
Quiet hours
22:00 to 07:00; email still arrives
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Loading
Skeletons where the data will land.
Settings / Alerts
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Empty
Nothing yet: each region says what will appear.
Settings / Alerts
Alerts
What reaches you, where, and when it waits until morning.
A new workspace: nothing is set yet. Fill in what you need; the defaults cover the rest.
Digest
One summary of what agents did
Your local time
Tell me about
An agent needs a yes before it acts
Someone names you in a chat
Quiet hours
22:00 to 07:00; email still arrives
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
SettingsScreen
| Prop | Type | Default | Description |
|---|---|---|---|
layout | String | "inset" | `inset` or `flat`. |
state | String | "sample" | `sample`, `loading` or `empty`. |
height | u32 | 640 | Height px. |
page | String | "notifications" | The page to open (`notifications` when unknown). |
on_back | EventHandler<()> | — | Back to app pressed. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Sidebar, page, then the work area |
| ←or→ on a hairline | Resize the sidebar or work area |
| Escape | Close an open menu; clear search |
| Enter in Search settings | Open the first page with a match |
| Escape in Search settings | Clear the search |
| Space on a switch | Turn it on or off |
| Escape in a confirm | Cancel the destructive action |
Accessibility
- The sidebar is a labelled nav; the open chat has aria-current and unread chats say so.
- Menus open from a trigger that reports aria-expanded; their items are menuitemradio and Escape shuts them.
- Hairlines are separators with a value and arrow keys; skeletons are hidden from screen readers.
Responsive behaviour
- Under 860 px of width the work area becomes a sheet opened from the top bar.
- Under 640 px the sidebar slides in from the menu button and the composer drops its labels.
Edge cases (spec)
Root fills its container (definite width, overflow clip, container queries). Under 860 px the work area becomes a sheet opened from the top bar; under 640 px the sidebar slides in from a menu button and composer menus drop their labels.
Notes for AI
- Import
SettingsScreenfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
SettingsElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.