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-overviewFiles
Everything your chats made or used, and the folders you keep it in.
Folders4
File templates4
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 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.
oxyn add folders-overviewUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
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 preview is free. Pro opens the code of every Pro component, screen and template.
API reference
FoldersScreen
| Prop | Type | Default | Description |
|---|---|---|---|
layout | String | "inset" | `inset` or `flat`. |
state | String | "sample" | A state key. |
height | u32 | 640 | Height px. |
detail | bool | Default::default() | Start inside the first folder. |
view | String | "grid" | `grid` or `list`. |
starred | bool | Default::default() | Oxyn: star a folder to keep it first (starts with one starred). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Sidebar, page, then each control in reading order |
| ←or→ in a tab row | Move between tabs |
| Escape | Close an open menu or popover; clear a search |
| Enter in Create folder | Create it (Escape cancels) |
| Escape in a search | Clear 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
FoldersScreenfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
FoldersElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.