Skip to main content

Documentation Index

Fetch the complete documentation index at: https://aidocs.zorid.app/llms.txt

Use this file to discover all available pages before exploring further.

Zorid fields are frontmatter values stored directly in Markdown files. Types are optional schemas that make a subset of those fields typed, visible, validated, and editor-enhanced.
Fields belong to the file. A Type controls which fields are active, grouped, typed, validated, and shown with richer editors.

​
Field syntax

v0 field syntax is YAML frontmatter: 
---
status: active
priority: high
due: 2026-06-01
scheduledAt: 2026-06-01T14:30:00+08:00
estimate: 2.5
count: 12
done: false
tags: [project, writing]
---

​
Primitive inference

Without a Type, Zorid still indexes fields and infers primitives from YAML:
YAML valueInferred field type
activestring
12int
4.5float
true / falseboolean
2026-06-01date
2026-06-01T14:30:00+08:00datetime
[a, b]list
empty / nullnull

​
Types (.ztype)

Default location: .zorid/types/*.ztype. 
schemaVersion: 1
id: task
name: Task

fields:
  status:
    type: select
    options: [todo, doing, done]
    default: todo
  priority:
    type: select
    options: [low, medium, high]
    default: medium
  due:
    type: date
  scheduledAt:
    type: datetime
  estimate:
    type: float
  count:
    type: int
  owners:
    type: multiselect
Supported v0 types: string, int, float, boolean, date, datetime, select, multiselect.

​
Linking a file to a Type

---
zorid:
  type: task
status: todo
priority: high
due: 2026-06-01
---
# Fix sync conflict UI
zorid.type references the Type ID, not a path. The Type registry resolves IDs from .zorid/types/*.ztype and reports conflicts.

​
Notion-like preservation

If a file removes its zorid.type:
  • Field values remain in frontmatter.
  • The Task field box disappears.
  • Fields become raw / ad-hoc metadata.
  • Data Views can still query them.
If the file later re-adds zorid.type: task:
  • The Task field box reappears.
  • Previous field values are reused.
  • Select / date / multiselect editors and validation resume.

​
UI shape

┌─ Task ─────────────────────────┐
│ Status:   [todo ▼]          │
│ Priority: [high ▼]          │
│ Due:      [2026-06-01]      │
└─────────────────────────────┘

Other fields
  source: GitHub
  confidence: 0.8

Source

Full Fields & Types spec on GitHub.