@@ -0,0 +1,66 @@
+# Editor gallery
+
+<!-- Generated by tests/Schema.Editor.UITests/Gallery. Edit GalleryCatalog.cs, not this file. -->
+
+The Schema editor as it draws today, working on a small sample schema for a game, staged and photographed headlessly by the UI test harness. The pictures are regenerated on every successful build of `main`, so they show the current editor.
+
+## Starting a schema
+
+The editor opens on whatever was open last, or on nothing. The File menu creates, opens and saves `.schema.json` files and keeps the recent ones to hand.
+
+![Starting a schema](starting-a-schema.png)
+
+## Editing a class
+
+The trees on the left hold the schema's classes, enums, data sources and code generators. Choosing a class opens its members as a grid: each one named, typed and described, and reordered or removed from its row.
+
+![Editing a class](editing-a-class.png)
+
+## Member metadata
+
+Behind each member is what its type cannot say: the unit it is measured in, the range it may take, its default, how it is interpolated, and how it travels over a network.
+
+![Member metadata](member-metadata.png)
+
+## Choosing a type
+
+A member's type is picked from the built-in types and everything the schema declares, searchable by name.
+
+![Choosing a type](choosing-a-type.png)
+
+## Choosing a unit
+
+Units come from ktsu.Semantics.Quantities rather than a list kept here, each offered by name and symbol.
+
+![Choosing a unit](choosing-a-unit.png)
+
+## Editing an enum
+
+An enum is a named set of values any class can use as a member's type.
+
+![Editing an enum](editing-an-enum.png)
+
+## Code generators
+
+A code generator writes the schema out as source in a target language, into a directory relative to the schema file.
+
+![Code generators](code-generators.png)
+
+## Class graph
+
+Every class and enum as a node, with an edge for each member that refers to another, laid out by a force simulation.
+
+![Class graph](class-graph.png)
+
+## Diagnostics
+
+The schema is validated as it is edited. The tab carries the counts, and each issue names the element it is about; clicking one selects that element.
+
+![Diagnostics](diagnostics.png)
+
+## Themes
+
+The editor takes its colours from ktsu.ThemeProvider, and remembers the theme chosen in the browser.
+
+![Themes](themes.png)
+