How withstudiocms/studiocms works
StudioCMS is an SSR headless CMS for Astro, delivered as a monorepo of the core integration and capability packages. Its user-facing work centers on dashboard/content management and API access; supporting branches provide plugin hooks, authentication, rendering, storage, and blog output. The README establishes these package roles, while sampled code confirms plugin processing, route injection, and storage URL resolution. Several internal modules and the database implementation were not sampled, so their detailed runtime connections are intentionally not inferred.
Main entry points: pluginHandler.ts Plugin Handler · oauth2.ts OAuth Providers · engine.ts Template Language · frontend CMS Dashboard
Components 21
CMS Core
- CMS Dashboard
packages/studiocms/frontend - Route Injection
packages/studiocms/src/handlers/frontend/routes.ts
Content Experience
- Content Renderers
packages/@studiocms/markdown-remark/src/core/index.ts - Visual Editor
packages/@studiocms/wysiwyg/src/common/gjs-blocks.ts - Blog Output
packages/@studiocms/blog/src/routes/rss.xml.ts
Plugins & Auth
- Plugin Handler
packages/studiocms/src/handlers/pluginHandler.ts - Plugin Schemas
packages/studiocms/src/schemas/plugins/shared.ts - OAuth Providers
packages/@studiocms/oauth/src/internal/oauth2.ts - OAuth Requests
packages/@studiocms/oauth/src/internal/request.ts - User Sessions
packages/@withstudiocms/auth-kit/src/modules/session.ts
API & Infrastructure
- API Contracts
packages/@withstudiocms/api-spec/src/integrations/schemas.ts - Storage Endpoints
packages/@withstudiocms/api-spec/src/integrations/routes/storage.ts - Storage API Handler
packages/studiocms/frontend/pages/studiocms_api/_handlers/integration/storageManager.ts - Storage URL Resolver
packages/studiocms/src/storage-api.ts - HTML Storage Transform
packages/studiocms/src/virtuals/components/ultrahtml-transformers/storage-api.ts - Storage Backends
packages/@studiocms/s3-storage/src/s3-storage-manager.ts - CMS Database
packages/@withstudiocms/kysely/src/core/client.ts
Developer Utilities
- SDK Cache
packages/@withstudiocms/sdk/src/cache.ts - SDK Context
packages/@withstudiocms/sdk/src/context.ts - Template Language
packages/@withstudiocms/template-lang/src/engine.ts
Other components
- CMS User
Connections 13
- CMS User → CMS Dashboard: uses dashboard
README.md - Route Injection → CMS Dashboard: injects routes
packages/studiocms/src/handlers/frontend/routes.ts - Plugin Handler → Plugin Schemas: loads schemas
packages/studiocms/src/handlers/pluginHandler.ts - Plugin Handler → OAuth Providers: registers providers
- OAuth Providers → OAuth Requests: uses requests
packages/@studiocms/oauth/src/internal/client.ts - API Contracts → Storage Endpoints: defines contracts
packages/@withstudiocms/api-spec/src/integrations/routes/storage.ts - Storage API Handler → Storage Endpoints: handles endpoints
packages/studiocms/frontend/pages/studiocms_api/_handlers/integration/storageManager.ts - HTML Storage Transform → Storage URL Resolver: resolves identifiers
packages/studiocms/src/virtuals/components/ultrahtml-transformers/storage-api.ts - CMS User → Content Renderers: publishes content
- CMS User → Visual Editor: edits visually
- CMS User → Blog Output: reads blog feeds
- SDK Cache → SDK Context: uses context
packages/@withstudiocms/sdk/src/cache.ts - Template Language → Template Language: parses and renders
packages/@withstudiocms/template-lang/src/engine.ts