# Ormos CMS (@ormos/core) Documentation Index

This is the AI-optimized documentation for `ormos-cms` (`@ormos/core`), a modern, headless, code-first CMS built with `h3`, Drizzle ORM, React, TanStack Router, and Shadcn UI.

## Architecture & Concepts
- [getting-started/what-is-ormos.md](./getting-started/what-is-ormos.md) - Core philosophy.
- [getting-started/installation.md](./getting-started/installation.md) - Setup guide for backend and admin frontend.
- [getting-started/concepts.md](./getting-started/concepts.md) - Collections vs Globals, Fields, and Hooks.

## Configuration & Admin
- [configuration/overview.md](./configuration/overview.md) - The `RootConfig` and `defineConfig` interface.
- [configuration/collections.md](./configuration/collections.md) - Defining collections.
- [configuration/globals.md](./configuration/globals.md) - Defining singletons.
- [admin/overview.md](./admin/overview.md) - Admin panel SPA architecture and branding.
- [admin/auth-pages.md](./admin/auth-pages.md) - Authentication pages (`LoginPage`, `RegisterPage`, `DefaultLoginPage`, `DefaultRegisterPage`).
- [admin/custom-components.md](./admin/custom-components.md) - Admin UI Slots, Custom Views (`Login`, `Register`, `Dashboard`), and Built-in Charts.

## Database & ORM
- [database/overview.md](./database/overview.md) - Drizzle ORM integration and `db.client`.
- [database/migrations.md](./database/migrations.md) - Migration workflows.

## Security & Authentication
- [authentication/overview.md](./authentication/overview.md) - Better Auth integration, middleware, and setup flows.
- [access-control/overview.md](./access-control/overview.md) - Role-based access control (RBAC).

## Background Jobs & Query Presets
- [background-jobs.md](./background-jobs.md) - Jobs Queue architecture and error handling with pg-boss.
- [query-presets.md](./query-presets.md) - Fast tab filtering and saved query presets in admin tables.

## Fields (Data Modeling)
- [fields/overview.md](./fields/overview.md) - Discriminated Unions pattern.
- [fields/data-fields.md](./fields/data-fields.md) - Text, Number, Select, Relation fields.
- [fields/layout-fields.md](./fields/layout-fields.md) - Row, Tabs, Collapsible fields.
- [upload/overview.md](./upload/overview.md) - Upload collections, S3 storage lifecycle, Sharp image sizes, and Media Picker.

## API & Hooks
- [rest-api/overview.md](./rest-api/overview.md) - Query parsing (where, sort, limit).
- [hooks/overview.md](./hooks/overview.md) - Lifecycle hooks (beforeChange, afterRead, etc.).

## MDC Rules (Modular Documentation for Cursor/AI)
- [rules/database-rules.md](./rules/database-rules.md)
- [rules/ui-rules.md](./rules/ui-rules.md)
- [rules/fields-rules.md](./rules/fields-rules.md)
