Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

docs(agents): document the table primitives (SortMenu, ColumnsMenu, DataTableFooter, hooks)

Juan Denis5aa4ddc6b2cc
diff --git a/AGENTS.md b/AGENTS.md
index d8a079dc..5535c1af 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -131,7 +131,13 @@ add Tailwind utility classes, CSS-in-JS, or new inline styles.
- Forms — `styles/components/_forms.scss` (`.form-group`, `.form-field`,
`.form-row`, `.error-message`); prefer the `FormField` component.
- Tables — `.sk-dtable` in `styles/components/_design-system.scss`; prefer the
- `components/ds/DataTable.jsx` primitive.
+ `components/ds/DataTable.jsx` primitive. Supporting pieces: `ds/SortMenu.jsx`
+ + `ds/ColumnsMenu.jsx` (toolbar popovers), `ds/DataTableFooter.jsx` (standard
+ "Shown X of Y · Load more / page-size" bar), `hooks/useTableSort.js` +
+ `hooks/useColumnVisibility.js` (state, localStorage-persistable via
+ `storageKey`). Columns opt into sorting with `sortable: true` (+ `sortValue`);
+ header click sorts, shift+click stacks sort levels. `ResourceListPage` wires
+ the menus + footer itself — consumer pages only declare column defs.
- Pills/badges — `.sk-pill`, `.sk-state`, `.sk-tag`.
- Tokens — `styles/_variables.scss`, `styles/_theme-variables.scss`.
- **Shared utilities** (reuse before rewrite):