> ## 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.

# Storage model

> How a Zorid vault lays out Markdown notes, .zbase view files, .ztype type definitions, plugin config, and the rebuildable SQLite index on disk.

## Canonical user data

```text theme={null}
*.md                          # Markdown notes (canonical)
*.zbase                       # View definitions (canonical, YAML)
.zorid/types/*.ztype          # Type definitions (canonical, YAML)
.zorid/config.json            # Settings
.zorid/workspace.json         # Workspace state
```

## Derived / disposable

```text theme={null}
.zorid/index/index.sqlite     # Derived index, rebuildable
.zorid/cache/**               # Disposable
```

## Future / separate durable data

```text theme={null}
.zorid/history/**             # Backup / timeline
.zorid/sync/**                # Operation logs (next stage)
.zorid/plugins/<plugin-id>/** # Plugin-private data
```

## Why not canonical SQLite for views?

A live SQLite file is awkward to sync through object storage (S3 / Google Drive) because conflicts happen at the whole-file level. Zorid view definitions are readable, sync-friendly, **conflict-detected text files** instead.

## Embedding views

Markdown uses normal embed syntax with the vault-relative `.zbase` path:

```md theme={null}
Project dashboard

![[.zorid/views/project-tracker.zbase]]
```

`.zorid/views/` is only the default creation location. Users may store `.zbase` files anywhere in the vault:

```md theme={null}
![[Dashboards/project-tracker.zbase]]
```

## Storage diagram

```mermaid theme={null}
flowchart TB
  VaultRoot[Vault Root]
  Markdown[Markdown Notes *.md]
  Zorid[.zorid/]

  VaultRoot --> Markdown
  VaultRoot --> Zorid

  Zorid --> ZViews[views/*.zbase]
  Zorid --> Types[types/*.ztype]
  Zorid --> Index[index/index.sqlite]
  Zorid --> Config[config.json]
  Zorid --> Workspace[workspace.json]
  Zorid --> Cache[cache/**]
  Zorid --> History[history/**]
  Zorid --> Sync[sync/**]

  Markdown --> Embeds[View Embeds]
  Embeds --> ZViews
```

<Card title="Source" icon="github" href="https://github.com/zorid-app/Zorid/blob/main/docs/architecture/storage-model.md">
  Full storage model on GitHub.
</Card>