# Theme-specific examples

All **named-theme** vocabulary—concrete block `type` strings, nested layouts, and theme-specific setting keys—lives **only** in files under this folder. [SKILL.md](../../../SKILL.md) stays theme-agnostic and routes to the target-discovery and example-selection procedure.

## Choosing the best example to reference

Do this **after** [Discover allowed block types](../json-editing.md#step-2--discover-allowed-block-types) on the workspace theme so you know which `type` strings actually exist.

1. **Identify the theme** — Read `config/settings_schema.json` and check the `theme_info` object for `theme_name`. This is the most reliable way to identify the theme without asking the user.
2. **Open the best-matching file** only when the overlap is strong (same naming style and types). Use it for layout ideas and sample JSON **after** confirming every `type` still appears in the target theme’s schemas.
3. If **no** bundled example fits, **do not** use one—copy structure from existing `templates/*.json` in that theme instead.
4. If multiple could fit or the theme is unknown, **ask the user** which theme or example family to follow.

## Index

| File | Documents |
| --- | --- |
| [slab/guide.md](slab/guide.md) | Slab / Brickspace-style blocks: essential **block reference**, page-building checklist, curated layout/content/cards reference, structure trees, and self-contained JSON example folders (including one full **section** example with a preview). Full inventory: inspect the target theme's `blocks/` directory. |

### Slab example folders

- [`slab/flex-row-multiple-items/`](slab/flex-row-multiple-items/example.json)
- [`slab/nested-containers/`](slab/nested-containers/example.json)
- [`slab/three-column-grid-image-button/`](slab/three-column-grid-image-button/example.json)
- [`slab/three-column-flex-nested-image-grid-footer-row/`](slab/three-column-flex-nested-image-grid-footer-row/example.json), with [`preview.png`](slab/three-column-flex-nested-image-grid-footer-row/preview.png)