# withstudiocms/studiocms architecture

> Architecture diagram of the GitHub repository withstudiocms/studiocms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/withstudiocms/studiocms
- Repository: https://github.com/withstudiocms/studiocms

## Overview

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: [`packages/studiocms/src/handlers/pluginHandler.ts`](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/handlers/pluginHandler.ts) (Plugin Handler), [`packages/@studiocms/oauth/src/internal/oauth2.ts`](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/oauth/src/internal/oauth2.ts) (OAuth Providers), [`packages/@withstudiocms/template-lang/src/engine.ts`](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/template-lang/src/engine.ts) (Template Language), [`packages/studiocms/frontend`](https://github.com/withstudiocms/studiocms/tree/main/packages/studiocms/frontend) (CMS Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["CMS Core"]
  node_editor["CMS Dashboard"]
  node_routes["Route Injection<br/>[routes.ts]"]
end

subgraph group_content["Content Experience"]
  node_renderers["Content Renderers<br/>[index.ts]"]
  node_wysiwyg["Visual Editor<br/>[gjs-blocks.ts]"]
  node_blog["Blog Output<br/>[rss.xml.ts]"]
end

subgraph group_extensions["Plugins &amp; Auth"]
  node_plugin["Plugin Handler<br/>[pluginHandler.ts]"]
  node_pluginconfig["Plugin Schemas<br/>[shared.ts]"]
  node_oauth["OAuth Providers<br/>[oauth2.ts]"]
  node_oauthrequest["OAuth Requests<br/>[request.ts]"]
  node_authkit["User Sessions<br/>[session.ts]"]
end

subgraph group_platform["API &amp; Infrastructure"]
  node_api["API Contracts<br/>[schemas.ts]"]
  node_storageendpoint["Storage Endpoints<br/>[storage.ts]"]
  node_storagehandler["Storage API Handler<br/>[storageManager.ts]"]
  node_storageapi["Storage URL Resolver<br/>[storage-api.ts]"]
  node_storagehtml["HTML Storage Transform<br/>[storage-api.ts]"]
  node_storagebackend["Storage Backends"]
  node_db[("CMS Database<br/>[client.ts]")]
end

subgraph group_utilities["Developer Utilities"]
  node_sdkcache["SDK Cache<br/>[cache.ts]"]
  node_sdkcontext["SDK Context<br/>[context.ts]"]
  node_template["Template Language<br/>[engine.ts]"]
end

node_actor(("CMS User"))

node_actor -->|"uses dashboard"| node_editor
node_routes -->|"injects routes"| node_editor
node_plugin -->|"loads schemas"| node_pluginconfig
node_plugin -.->|"registers providers"| node_oauth
node_oauth -->|"uses requests"| node_oauthrequest
node_api -->|"defines contracts"| node_storageendpoint
node_storagehandler -->|"handles endpoints"| node_storageendpoint
node_storagehtml -->|"resolves identifiers"| node_storageapi
node_actor -.->|"publishes content"| node_renderers
node_actor -.->|"edits visually"| node_wysiwyg
node_actor -.->|"reads blog feeds"| node_blog
node_sdkcache -->|"uses context"| node_sdkcontext
node_template -->|"parses and renders"| node_template

click node_editor "https://github.com/withstudiocms/studiocms/tree/main/packages/studiocms/frontend"
click node_routes "https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/handlers/frontend/routes.ts"
click node_plugin "https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/handlers/pluginHandler.ts"
click node_pluginconfig "https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/schemas/plugins/shared.ts"
click node_oauth "https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/oauth/src/internal/oauth2.ts"
click node_oauthrequest "https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/oauth/src/internal/request.ts"
click node_authkit "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/auth-kit/src/modules/session.ts"
click node_api "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/api-spec/src/integrations/schemas.ts"
click node_storageendpoint "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/api-spec/src/integrations/routes/storage.ts"
click node_storagehandler "https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/frontend/pages/studiocms_api/_handlers/integration/storageManager.ts"
click node_storageapi "https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/storage-api.ts"
click node_storagehtml "https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/virtuals/components/ultrahtml-transformers/storage-api.ts"
click node_storagebackend "https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/s3-storage/src/s3-storage-manager.ts"
click node_db "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/kysely/src/core/client.ts"
click node_renderers "https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/markdown-remark/src/core/index.ts"
click node_wysiwyg "https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/wysiwyg/src/common/gjs-blocks.ts"
click node_blog "https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/blog/src/routes/rss.xml.ts"
click node_sdkcache "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/sdk/src/cache.ts"
click node_sdkcontext "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/sdk/src/context.ts"
click node_template "https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/template-lang/src/engine.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_editor,node_routes,node_actor toneBlue
class node_renderers,node_wysiwyg,node_blog toneAmber
class node_plugin,node_pluginconfig,node_oauth,node_oauthrequest,node_authkit toneMint
class node_api,node_storageendpoint,node_storagehandler,node_storageapi,node_storagehtml,node_storagebackend,node_db toneRose
class node_sdkcache,node_sdkcontext,node_template toneIndigo
```

## Components

### CMS Core

- [CMS Dashboard](https://github.com/withstudiocms/studiocms/tree/main/packages/studiocms/frontend): `packages/studiocms/frontend`
- [Route Injection](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/handlers/frontend/routes.ts): `packages/studiocms/src/handlers/frontend/routes.ts`

### Content Experience

- [Content Renderers](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/markdown-remark/src/core/index.ts): `packages/@studiocms/markdown-remark/src/core/index.ts`
- [Visual Editor](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/wysiwyg/src/common/gjs-blocks.ts): `packages/@studiocms/wysiwyg/src/common/gjs-blocks.ts`
- [Blog Output](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/blog/src/routes/rss.xml.ts): `packages/@studiocms/blog/src/routes/rss.xml.ts`

### Plugins & Auth

- [Plugin Handler](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/handlers/pluginHandler.ts): `packages/studiocms/src/handlers/pluginHandler.ts`
- [Plugin Schemas](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/schemas/plugins/shared.ts): `packages/studiocms/src/schemas/plugins/shared.ts`
- [OAuth Providers](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/oauth/src/internal/oauth2.ts): `packages/@studiocms/oauth/src/internal/oauth2.ts`
- [OAuth Requests](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/oauth/src/internal/request.ts): `packages/@studiocms/oauth/src/internal/request.ts`
- [User Sessions](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/auth-kit/src/modules/session.ts): `packages/@withstudiocms/auth-kit/src/modules/session.ts`

### API & Infrastructure

- [API Contracts](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/api-spec/src/integrations/schemas.ts): `packages/@withstudiocms/api-spec/src/integrations/schemas.ts`
- [Storage Endpoints](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/api-spec/src/integrations/routes/storage.ts): `packages/@withstudiocms/api-spec/src/integrations/routes/storage.ts`
- [Storage API Handler](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/frontend/pages/studiocms_api/_handlers/integration/storageManager.ts): `packages/studiocms/frontend/pages/studiocms_api/_handlers/integration/storageManager.ts`
- [Storage URL Resolver](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/storage-api.ts): `packages/studiocms/src/storage-api.ts`
- [HTML Storage Transform](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/virtuals/components/ultrahtml-transformers/storage-api.ts): `packages/studiocms/src/virtuals/components/ultrahtml-transformers/storage-api.ts`
- [Storage Backends](https://github.com/withstudiocms/studiocms/blob/main/packages/%40studiocms/s3-storage/src/s3-storage-manager.ts): `packages/@studiocms/s3-storage/src/s3-storage-manager.ts`
- [CMS Database](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/kysely/src/core/client.ts): `packages/@withstudiocms/kysely/src/core/client.ts`

### Developer Utilities

- [SDK Cache](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/sdk/src/cache.ts): `packages/@withstudiocms/sdk/src/cache.ts`
- [SDK Context](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/sdk/src/context.ts): `packages/@withstudiocms/sdk/src/context.ts`
- [Template Language](https://github.com/withstudiocms/studiocms/blob/main/packages/%40withstudiocms/template-lang/src/engine.ts): `packages/@withstudiocms/template-lang/src/engine.ts`

### Other components

- **CMS User**

## Connections

- CMS User → CMS Dashboard: uses dashboard (evidence: `README.md`)
- Route Injection → CMS Dashboard: injects routes (evidence: `packages/studiocms/src/handlers/frontend/routes.ts`)
- Plugin Handler → Plugin Schemas: loads schemas (evidence: `packages/studiocms/src/handlers/pluginHandler.ts`)
- Plugin Handler → OAuth Providers: registers providers
- OAuth Providers → OAuth Requests: uses requests (evidence: `packages/@studiocms/oauth/src/internal/client.ts`)
- API Contracts → Storage Endpoints: defines contracts (evidence: `packages/@withstudiocms/api-spec/src/integrations/routes/storage.ts`)
- Storage API Handler → Storage Endpoints: handles endpoints (evidence: `packages/studiocms/frontend/pages/studiocms_api/_handlers/integration/storageManager.ts`)
- HTML Storage Transform → Storage URL Resolver: resolves identifiers (evidence: `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 (evidence: `packages/@withstudiocms/sdk/src/cache.ts`)
- Template Language → Template Language: parses and renders (evidence: `packages/@withstudiocms/template-lang/src/engine.ts`)
