Skip to content
Back

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-grid
Home

Welcome

A quick tour: blocks, headings, tables and the shortcuts that move between them.

2m ago

Writing: text, headings and paragraphs

Headings give your writing structure; paragraphs keep the rhythm.

15m ago

Blocks: lists, quotes and callouts

Three ways to set a point apart from the text around it.

1h ago

Tables and columns

Insert a table, resize the columns and sort by any of them.

2h ago

Code and equations

Inline code, fenced blocks with highlighting, and TeX equations.

1d ago

Images, files and covers

Drop an image, align it, and give the page a cover.

2d ago

Organize and find your notes

Folders, favourites and the search that reads every page.

3d ago

Example: reading list

Books read in 2026, with ratings and notes.

4d ago
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

  • 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.

Terminal
oxyn add doc-grid

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

Grid

Cards with the document list beside them.

Home

Welcome

A quick tour: blocks, headings, tables and the shortcuts that move between them.

2m ago

Writing: text, headings and paragraphs

Headings give your writing structure; paragraphs keep the rhythm.

15m ago

Blocks: lists, quotes and callouts

Three ways to set a point apart from the text around it.

1h ago

Tables and columns

Insert a table, resize the columns and sort by any of them.

2h ago

Code and equations

Inline code, fenced blocks with highlighting, and TeX equations.

1d ago

Images, files and covers

Drop an image, align it, and give the page a cover.

2d ago

Organize and find your notes

Folders, favourites and the search that reads every page.

3d ago

Example: reading list

Books read in 2026, with ratings and notes.

4d ago
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

List rows, no sidebar.

Home

Welcome

A quick tour: blocks, headings, tables and the shortcuts that move between them.

2m ago

Writing: text, headings and paragraphs

Headings give your writing structure; paragraphs keep the rhythm.

15m ago

Blocks: lists, quotes and callouts

Three ways to set a point apart from the text around it.

1h ago

Tables and columns

Insert a table, resize the columns and sort by any of them.

2h ago

Code and equations

Inline code, fenced blocks with highlighting, and TeX equations.

1d ago

Images, files and covers

Drop an image, align it, and give the page a cover.

2d ago

Organize and find your notes

Folders, favourites and the search that reads every page.

3d ago

Example: reading list

Books read in 2026, with ratings and notes.

4d ago
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

DocGrid

PropTypeDefaultDescription
docsrequiredVec<Doc>—Documents.
sidebarbooltrueShow the sidebar list.
listboolDefault::default()Start in list view.
on_openEventHandler<String>—A document was opened.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabThrough tabs, sort, layout and cards
EnterOpen 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 DocGrid from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: DocGridEl in oxyn_gpui.
  • Props to set first: docs.
  • 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