diff --git a/docs/using-origin-in-your-app.md b/docs/using-origin-in-your-app.md index 62225ab..95929bf 100644 --- a/docs/using-origin-in-your-app.md +++ b/docs/using-origin-in-your-app.md @@ -130,6 +130,62 @@ If you need app-specific tokens or mixins, create them in a local `src/tokens/` @use "pkg:@lightsparkdev/origin/tokens/text-styles" as *; // from Origin ``` +## Table Column Sizing + +`Table.Root` uses `table-layout: fixed` so column widths are predictable and text truncates cleanly. The sizing model is simple: + +- **Hug columns** — Set an explicit width via `style`. The column stays at that size. Use for checkboxes, status badges, action menus, and other fixed-width content. +- **Fill columns** — Don't set a width. The browser divides remaining space equally among columns without explicit widths. + +```tsx +