The gallery
isolen_gallery is the showcase app for the kit. It opens on a grid of every component running live, and every component has its own page with its options, a preview and the code that draws it, all drawn by the engine itself. It is a showcase, not part of the event, and it is never shipped with it.
Prebuilt zips for mac and Windows are on the download page.
What is in it
- 100 catalog entries, every one with a live page. The sidebar lists them under the kit they come from: inputs, pickers, charts, containers, menus, data, chat, and core for portals, anchors, focus scopes, modals, virtual lists, canvas and text. It is built on the kit nav tree. The search filters it as you type, and matches aliases too, so
rtlfinds Direction andknobfinds Arc. While the search has focus, Up and Down walk a highlight through the rows, skipping folded groups, Enter opens the highlighted page, and Escape clears the search. - The GIF page plays a GIF fetched from a url over https, by default a web GIF, or the local file beside the app, with a reload button and the load state.
--gif-url URLstarts it on another url. See GIF. - The chat pages show the real faces of meowda and xyloflake from
assets/avatarsbeside the executable, and own messages sit on the end side. - GIF, Lottie and the 3D model viewer have live pages. The model viewer page shows the Toy Car by Guido Odendahl and Eric Chadwick, CC0, from the Khronos glTF samples, which ships in
assets/modelsbeside the executable. - The carousel page shows a set of landscape pictures the page paints into images at start, one per slide. The
picturesprop turns them off for the plain numbered slides. - Each page's code blocks are cut from that page's own source at build time, so the code shown is the code that runs. A snippet whose marker is gone fails to compile.
The grid
The home view is every component as a live card, under a header for its group, in the same order as the sidebar. A card is the real demo, not a picture of it.
- Sizing. Each demo is laid out once per theme and direction at a ladder of widths in a private context, and a card takes the narrowest width the demo fits at with no text cut.
- Wide demos. A demo too wide for its card is laid out at its own width and its draw records are replayed shrunk onto the card.
- Flush rows. Each group packs its cards into rows that fill the width, every card in a row the same height. The row breaks are chosen to keep the group low, a spare column goes to the tallest card when that lowers the row, and a lone card is never stretched across the grid.
- Groups fold. Every group header, in the grid and in the sidebar, is a collapsible that folds and opens at the kit accordion's pace. The grid header always shows the group's count, the sidebar only while the group is shut. Folding a group in one place folds it in both. A search opens every group with a match, and the group of the open page stays open.
- Only what is in view runs. Cards are declared only when they meet the band around the view, so the grid costs about the same with 100 components as with ten.
- Still cards. Anchors, portals and focus scopes escape their box or take focus on purpose, so their cards show the blurb instead.
- Search filters the grid as you type. It sits in the sidebar, or in the header when the window is too narrow for one.
- Keys. The arrows move card to card and mirror under right to left. Enter or space opens a card. Tab walks into the controls of a demo and on to the next card. A click on a card opens its page.
- Back. A page has an all components button that returns to the grid.
A page
- Panes. A page is a preview pane and a props pane side by side on a split, with a 16 unit grip between them, and the code below them across the full width. Props sit on the end side, a third of the width at first, and the split ratio is shared across pages. Drag the grip, or double click it to fold the props away.
- Pane height. The preview sets the height of the row, at least 240 units, and a props list longer than that scrolls inside its pane.
- Live props. Props are declared before the preview, so an edit shows in the demo on the same frame. After any input one more frame runs, so a change the demo makes also shows in the props, and the app still goes idle.
- Narrow windows. When the page area is under 700 units wide the preview, props and code stack in one scroll. A window too narrow for the sidebar or the controls beside the page shows that pane alone, with a button back to the page.
- Fullscreen preview. The fullscreen icon button in the preview header shows the demo alone over the whole page, centred on the theme background. A windowed gallery also takes the whole screen for it and gives it back after. Escape, the exit fullscreen button, picking another page or going back to the grid all leave it.
- Rows wrap. Prop rows and the page header wrap instead of spilling.
- Code blocks have a small copy icon on the block, keep their own width and scroll sideways. A block taller than 520 units scrolls down instead of stretching the pane.
- Colours are edited with the kit colour swatch.
The controls panel
Show controls opens a panel with three sections:
| Section | What it holds |
|---|---|
| Theme | The hud, dark and light presets, and every theme colour and metric, applied live. |
| Display | The backend, switched live, vsync, a frame rate cap of off, 30, 60, 120 or 240, a page zoom switch for pinch zoom, the direction, left to right or right to left, and the ui scale from 0.5 to 3. |
| Engine | Frames in the last second, view and frame time, idle gaps, draw list counts, element and store use, the memory footprint and, on the CPU backend, bands redrawn. |
The status line shows the backend, the page id and the last thing a demo did.
Build and run
The gallery is the isolen_gallery target in isolenui, built from an isolenui checkout like any other app:
- mac:
./build.sh macos isolen_gallery - Windows:
build.bat release isolen_gallery
The binary lands in build/<preset>. It opens at 1440 by 900 in the dark theme and writes isolen_gallery.log.
Command line
The gallery takes the standard app flags, such as --fps N and --cpu, plus a few of its own.
| Flag | Effect |
|---|---|
--fps N | Caps the frame rate at N, on top of vsync. The display section shows a cap from the command line. |
--cpu | Forces the CPU backend. |
--rtl | Starts right to left. |
--page ID | Opens on one page by its catalog id, such as calendar or data_table, instead of the grid. An unknown id logs a warning. |
--grid-at ID | Opens the grid scrolled so that card is at the top. |
--search TEXT | Starts with the search filled in. |
--theme NAME | Starts in hud, dark or light. |
--size WxH | The window size, each side from 240 to 8192. |
--shut LIST | Starts with those groups folded, a comma separated list of group names such as inputs,chat. The names are inputs, pickers, charts, containers, menus, data, chat and core. |
--fullscreen | With --page, opens that page's preview in fullscreen. |
--gif-url URL | The url the GIF page fetches. |
--controls | Starts with the controls panel open. |
--open | Starts dialogs, sheets, drawers, popovers, the palette and toasts open on their pages. |
--stress | Loads the big data sets on the list, table, tree, chart, roller, textarea and chat pages. |
--walk | Visits every live page in turn, then goes idle. |
--capture DIR | Runs capture mode instead of the app, see below. |
--page to open the gallery there.Capture mode
isolen_gallery --capture DIR renders every demo offscreen and writes one PNG each, then exits. It runs on the CPU backend with the window hidden, and fails if it gets any other backend.
| Flag | Effect |
|---|---|
--scale N | Pixels per unit, from 1 to 4. The default is 2, and every shot is really rendered at that scale. |
--theme light | Only the light theme. --theme dark is only the dark one. Without it both are written. |
--page ID | Only that page, or one group picture by its file name such as hero_menus. |
- Files.
DIR/lightandDIR/darkeach getID.pngfor every page andhero_GROUP.pngfor seven group pictures, inputs, pickers, charts, containers, menus, data and chat, six components each. - Same pixels every run. Frames step at a fixed 1/60 of a second from a fixed epoch, and the date pickers see 18 March 2026 instead of today.
- Settling. A demo runs at least 24 frames and until it stops animating, up to 240. One that never settles is written anyway, with a warning in the log.
- No network. The GIF page draws its local file under capture, so a run never fetches anything.
- Overlays. Pages with a menu, popover, tooltip or dialog open it in code for the shot, by hovering or pressing the element that opens it. No real input is sent. Dialogs, sheets, drawers, message boxes, modals, the command palette and toasts get a larger room so the scrim or the edge they pin to is in the picture.
- Trimmed. Each shot is cut to what the demo drew plus a 12 unit margin. The larger rooms are kept whole.
- Log. Every file is logged with its size and frame count, then a total with the time taken and how many came out empty or failed. The exit code is 1 when any file failed.