Skip to content
Back

Folders / DetailPro

One folder open: breadcrumbs and a back link, the title row with More, sort, grid or list, Share and Upload files, then file cards with page previews, or an empty drop area.

oxyn add folders-detail

Autumn launch

Autumn launch

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

  • One folder open: what is in it, who it is shared with, and a way to add more.

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

Folders / Detail 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 folders-detail

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.

Autumn launch

Autumn launch

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.

Autumn launch

Autumn launch

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.

Autumn launch

Autumn launch

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 and how to start.

Files

Everything your chats made or used, and the folders you keep it in.

Folders0

No folders yet

Group the files for one project, then share the folder with people or agents.

    File templates0

    Templates you save show up here, ready to copy into any folder.

    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

    Uploading

    Two files on their way in with progress bars.

    Autumn launch

    Autumn launch

    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

    List

    Files as a list.

    Autumn launch

    Autumn launch

    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

    FoldersScreen

    PropTypeDefaultDescription
    layoutString"inset"`inset` or `flat`.
    stateString"sample"A state key.
    heightu32640Height px.
    detailboolDefault::default()Start inside the first folder.
    viewString"grid"`grid` or `list`.
    starredboolDefault::default()Oxyn: star a folder to keep it first (starts with one starred).

    Read from the Rust signature and doc comments.

    Keyboard interactions

    KeyAction
    TabSidebar, page, then each control in reading order
    ←or→ in a tab rowMove between tabs
    EscapeClose an open menu or popover; clear a search
    Enter in ShareInvite the name typed
    Escape in ShareClose the popover

    Accessibility

    • The persona sidebar is a labelled nav with aria-current on this page.
    • Tabs are a tablist with arrow keys; menus report aria-expanded and close on Escape.
    • Skeletons are hidden from screen readers; every action reports what it did in a polite live region.
    • Upload progress is a progressbar with a value; Share is a labelled dialog.

    Responsive behaviour

    • Authored on the 1440 × 900 canvas; the full view lays it out at the real width.
    • Under 640 px the sidebar slides in from the menu button and top-bar actions keep their icons with hidden labels.
    • The title row wraps under the name on a phone and sort steps aside.
    Edge cases (spec)

    Authored on the 1440 × 900 stage (rule R1) and scaled to its column; the full view (/screens/folders-detail/full) renders at the real viewport with the state bar under it (R2). Under 640 px the sidebar slides in from a menu button and top-bar actions keep their icons with hidden labels. Under 620 px the title row wraps under the name, sort steps aside and the cards keep two columns. Every label in a row, chip or card ellipsises in a flex child with min-width 0 (R5); scripts/ovl.py finds no text overlap at 1440, 768 and 390 in light and dark.

    Notes for AI

    • Import FoldersScreen from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
    • A GPUI version exists: FolderDetailEl 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