Concepts
How Monark works and why it is built that way. Read these to understand a behavior before you change it or explain it; the steps themselves are in Build on Monark and Operate.
- Platform overview: what Monark is, what ships in every deploy, and how the pieces fit. Start here.
- Architecture: modules, boundaries, events, generated code, boot order, the web shell and integrations.
- Users and authentication: accounts, sign-in, two-factor, trusted devices and sessions.
- Permissions: roles, permissions and record scopes, and how they combine.
- Data models and queries: how custom models store records and how a query becomes SQL.
- How automations run: triggers, the run queue, retries, and how data moves between steps.
- Notifications: kinds, channels, preferences and how a notification is delivered.
- Files: uploads, buckets, validation and download links.
- Block editor: how long-form content is stored and rendered.
- How achievements are awarded: conditions, thresholds and the award worker.
- Identity and integration: how API keys, service accounts, webhooks and secrets fit together.
- Secrets: how integration credentials are stored, encrypted and kept write-only.
- How the AI assistant works: a turn, where tools come from, and why every write waits for you.