Skip to content
Back to features
Data modeling

Collections

Define collection fields, relationships, and record labels in TypeScript.

Read the technical documentation
Collection schema authoring in workspace source

What it is

Collections are how you define operational data in @norbital-ai/pod. Each collection lives in src/collections/<name>/+model.ts. Relationships live in src/collections/+relationship.ts; the compiler discovers both roles.

Schema, relationships, and record labels are source code. They are reviewable in git and compiled by the Pod Vite plugin. System collections like user and team are merged automatically; you author domain collections on top.

What you author

  • Field types: primitives, enums, money, date ranges, and files
  • Relationships between collections
  • Record labels used in selectors and links
  • Companion hooks and pipelines beside each collection module

How collections connect the workspace

Collections are the foundation for the rest of the workspace. Apps read them, hooks react to them, automations process them, and policies guard them.

Next feature

Apps

Give each team forms, queues, dashboards, and tools for its work.