Format & Import Mapping
Specifications for Grida's authored formats and trackers for importing external formats into the Grida IR.
Format & Import Mapping
Tracking docs for the Grida IR schema and how external formats map into it.
Specifications and RFDs
| Page | Description |
|---|---|
| Grida IR | Canonical IR reference — node types, paint, layout |
| Grida XML | Open RFD for the authored, inspectable .grida.xml source |
| Grida XML properties | XML property names, applicability, and design placeholders |
| Grida XML modules | Open linking/component RFD with a proving implementation |
| Grida XML component parameters | Open typed prop/arg RFD with a proving implementation |
| Grida XML component slots | Open named slot projection RFD with a proving implementation |
| Grida XML durable addressing | Version 4 node/use identity and typed effective-value RFD |
| Grida XML animation | Decision deferring native syntax while SVG proves the kernel |
Import mappings
| Page | Description |
|---|---|
| CSS | CSS → Grida IR property mapping and TODO tracker |
| HTML | HTML element → Grida IR node mapping |
| SVG | SVG → usvg → Grida IR mapping and TODO tracker |
How to use these docs
The CSS, HTML, and SVG trackers use this status key: ✅ mapped | ⚠️ partial | 🔧 IR exists, not wired | ❌ IR missing | 🚫 out of scope. Their IR Gaps sections identify schema changes that would unblock further progress.
For the on-disk .grida file format, see the FlatBuffers
schema.
Related
- FlatBuffers schema:
format/grida.fbs— the canonical on-disk file format - Rust runtime model:
crates/grida/src/node/schema.rs - TypeScript model:
packages/grida-canvas-schema/grida.ts - HTML import pipeline:
crates/grida/src/import/html/ - SVG import pipeline:
crates/grida/src/import/svg/