How nextlyhq/nextly works
Nextly is a self-hosted content platform embedded in a Next.js application. Developers define content models in TypeScript or through the admin’s visual schema tools; editors then manage entries, compose pages, translate content, and control publication. The admin and typed APIs use core services backed by a selectable database adapter, while the application renders published content. The README documents major capabilities such as versioning, scheduling, roles, webhooks, jobs, plugins, and storage options. Some subsystems are represented at their source-directory level because their implementation files were not sampled.
Main entry points: features Admin interface · services Collection services · plugin-page-builder/src Visual page builder · adapter-drizzle/src SQL adapters
Components 21
Model and author
- Admin interface
packages/admin/src/components/features - Content schemas
packages/nextly/src/collections - Visual page builder
packages/plugin-page-builder/src
Content runtime
- REST and Direct APIs
packages/nextly/src - Next.js frontend
apps/playground/src/app/(frontend) - Block rendering
packages/blocks-react/src
Core platform
- Collection services
packages/nextly/src/domains/collections/services - Single documents
packages/nextly/src/domains/singles/services - Field groups
packages/nextly/src/domains/field-groups/services - Locale resolution
packages/nextly/src/domains/i18n - Version history
packages/nextly/src/domains/versions - Scheduled releases
packages/nextly/src/domains/releases - Roles and permissions
packages/nextly/src/domains/auth - User management
packages/nextly/src/domains/users/services
Adapters and extensions
- Application database
- SQL adapters
packages/adapter-drizzle/src - Media storage
packages/nextly/src/storage - Plugin SDK
packages/plugin-sdk/src - Webhook delivery
packages/nextly/src/domains/webhooks/services - Background jobs
packages/nextly/src/domains/jobs
Other components
- Content team
Connections 24
- Content team → Admin interface: edits content
README.md - Admin interface → Content schemas: defines models
README.md - Admin interface → Collection services: manages entries
README.md - Admin interface → Visual page builder: composes pages
README.md - Visual page builder → Block rendering: renders blocks
README.md - Next.js frontend → Collection services: reads content
- Collection services → Locale resolution: resolves locales
packages/nextly/src/domains/collections/services/collection-query-service.ts - Collection services → Field groups: populates fields
- Admin interface → Single documents: edits singletons
README.md - Collection services → Version history: captures versions
- Admin interface → Scheduled releases: schedules publishing
README.md - Collection services → Roles and permissions: checks permissions
- Admin interface → User management: manages users
- Admin interface → REST and Direct APIs: uses typed APIs
README.md - REST and Direct APIs → Collection services: dispatches requests
packages/nextly/src/services/collections/collection-relationship-service.ts - Collection services → SQL adapters: queries through
- Single documents → SQL adapters: queries through
- SQL adapters → Application database: reads and writes
README.md - Collection services → Media storage: handles media
- Admin interface → Plugin SDK: loads extensions
README.md - Plugin SDK → Visual page builder: extends platform
README.md - Webhook delivery → Application database: stores deliveries
- Admin interface → Webhook delivery: views deliveries
- Admin interface → Background jobs: monitors jobs
README.md