Skip to content
Back

Folders / OverviewPro

Files and the folders you keep them in: tabs, search, sort, grid or list and Create folder over the folder tiles, then file templates filtered by type.

oxyn add folders-overview

Files

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

Folders4

File templates4

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 files your chats made or used and the folders you keep them in: find, sort and open a folder, make a new one, and copy a template into a file.

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 / Overview 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-overview

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.

Files

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

Folders4

File templates4

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.

Files

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

Folders4

File templates4

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.

Files

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

Folders4

File templates0

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

    Creating

    The Create folder field open in the grid, focused.

    Files

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

    Folders4

    File templates4

    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

    Folders as a list with when each changed.

    Files

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

    Folders4

    File templates4

    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

    Starred

    Oxyn: a starred folder stays first.

    Files

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

    Folders4

    File templates4

    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 Create folderCreate it (Escape cancels)
    Escape in a searchClear it

    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.
    • Folder tiles are buttons that name the folder and who can see it; the star is a toggle button.

    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.
    • Folder tiles go 4 → 2 → 1 columns; templates keep two columns on a phone.
    Edge cases (spec)

    Authored on the 1440 × 900 stage (rule R1) and scaled to its column; the full view (/screens/folders-overview/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. Tiles go 4 → 2 columns under 900 px of page width and 1 under 620 px; the tool rows wrap with the tabs on their own line; templates keep two columns on a phone. 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: FoldersEl 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