Document gridPro
Local documents as a sidebar list and a card grid: My documents or Favorites, search, Last visited or Title, grid or list, stars in place.
oxyn add doc-gridWelcome
A quick tour: blocks, headings, tables and the shortcuts that move between them.
2m agoWriting: text, headings and paragraphs
Headings give your writing structure; paragraphs keep the rhythm.
15m agoBlocks: lists, quotes and callouts
Three ways to set a point apart from the text around it.
1h agoTables and columns
Insert a table, resize the columns and sort by any of them.
2h agoCode and equations
Inline code, fenced blocks with highlighting, and TeX equations.
1d agoImages, files and covers
Drop an image, align it, and give the page a cover.
2d agoOrganize and find your notes
Folders, favourites and the search that reads every page.
3d agoExample: reading list
Books read in 2026, with ratings and notes.
4d agoThe 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
- Local documents as a sidebar list (A to Z) and a card grid.
- Tabs switch My documents and Favorites; the search narrows by title or text; the sort flips Last visited and Title (doc_view); the grid / list toggle re-lays the same keyed cards.
- Stars toggle in place with a press squash; an empty Favorites tab says how to fill it.
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
Document grid 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 doc-gridUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Grid
Cards with the document list beside them.
Welcome
A quick tour: blocks, headings, tables and the shortcuts that move between them.
2m agoWriting: text, headings and paragraphs
Headings give your writing structure; paragraphs keep the rhythm.
15m agoBlocks: lists, quotes and callouts
Three ways to set a point apart from the text around it.
1h agoTables and columns
Insert a table, resize the columns and sort by any of them.
2h agoCode and equations
Inline code, fenced blocks with highlighting, and TeX equations.
1d agoImages, files and covers
Drop an image, align it, and give the page a cover.
2d agoOrganize and find your notes
Folders, favourites and the search that reads every page.
3d agoExample: reading list
Books read in 2026, with ratings and notes.
4d agoCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
List
List rows, no sidebar.
Welcome
A quick tour: blocks, headings, tables and the shortcuts that move between them.
2m agoWriting: text, headings and paragraphs
Headings give your writing structure; paragraphs keep the rhythm.
15m agoBlocks: lists, quotes and callouts
Three ways to set a point apart from the text around it.
1h agoTables and columns
Insert a table, resize the columns and sort by any of them.
2h agoCode and equations
Inline code, fenced blocks with highlighting, and TeX equations.
1d agoImages, files and covers
Drop an image, align it, and give the page a cover.
2d agoOrganize and find your notes
Folders, favourites and the search that reads every page.
3d agoExample: reading list
Books read in 2026, with ratings and notes.
4d agoCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
DocGrid
| Prop | Type | Default | Description |
|---|---|---|---|
docsrequired | Vec<Doc> | — | Documents. |
sidebar | bool | true | Show the sidebar list. |
list | bool | Default::default() | Start in list view. |
on_open | EventHandler<String> | — | A document was opened. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Through tabs, sort, layout and cards |
| Enter | Open a focused card |
Accessibility
- Tabs are role=tab with aria-selected; layout buttons are aria-pressed.
- Stars are toggle buttons that say what they will do.
From the spec
- Tabs are role=tab; layout buttons and stars are aria-pressed with labels that say what they do.
Motion & interaction
Timing
- Cards rise 240 ms; hover lifts 1 px; star squash on press.
- Reduced motion: no rise or lift.
Responsive behaviour
- Three columns; the sidebar hides and two columns remain under 560 px of its own width.
Edge cases (spec)
- Container query: under 560 px of its own width the sidebar hides and two columns remain.
Notes for AI
- Import
DocGridfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
DocGridElinoxyn_gpui. - Props to set first:
docs. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.