Skip to content
Back

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 settings

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

The code is part of Oxyn Pro

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.

Get Pro

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.

Terminal
oxyn add settings

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Loading

Skeletons where the data will land.

Settings / Alerts

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

SettingsScreen

PropTypeDefaultDescription
layoutString"inset"`inset` or `flat`.
stateString"sample"`sample`, `loading` or `empty`.
heightu32640Height px.
pageString"notifications"The page to open (`notifications` when unknown).
on_backEventHandler<()>—Back to app pressed.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabSidebar, page, then the work area
←or→ on a hairlineResize the sidebar or work area
EscapeClose an open menu; clear search
Enter in Search settingsOpen the first page with a match
Escape in Search settingsClear the search
Space on a switchTurn it on or off
Escape in a confirmCancel 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 SettingsScreen from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: SettingsEl in oxyn_gpui.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI