# chromeos/chromeos.dev architecture

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

- Interactive diagram: https://gitdiagram.com/chromeos/chromeos.dev
- Repository: https://github.com/chromeos/chromeos.dev

## Overview

ChromeOS.dev is a developer-focused content site backed by a Sanity CMS. The principal workflow is editors authoring structured, localized content in the CMS, followed by the site retrieving and presenting it to developers. The tree also shows search, offline support, RSS, and deployment-related endpoints. Sampled evidence confirms CMS schema registration and configuration, but not the site’s complete rendering or data-fetching flow; those links are marked unverified where useful.

Main entry points: [`site/astro.config.mjs`](https://github.com/chromeos/chromeos.dev/blob/main/site/astro.config.mjs) (ChromeOS.dev site), [`cms/sanity.config.ts`](https://github.com/chromeos/chromeos.dev/blob/main/cms/sanity.config.ts) (Sanity Studio), [`site/lib/sanity.ts`](https://github.com/chromeos/chromeos.dev/blob/main/site/lib/sanity.ts) (Content access), [`site/src/components/Search.svelte`](https://github.com/chromeos/chromeos.dev/blob/main/site/src/components/Search.svelte) (Search interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cms["Content management"]
  node_studio["Sanity Studio<br/>[sanity.config.ts]"]
  node_studio_theme["Studio theme<br/>[theme.ts]"]
end

subgraph group_content["Content models"]
  node_schema_registry["Schema registry<br/>[index.ts]"]
  node_editorial_docs["Editorial content"]
  node_localized_content["Localized content<br/>[constants.ts]"]
end

subgraph group_site["Developer website"]
  node_website["ChromeOS.dev site<br/>[astro.config.mjs]"]
  node_content_data["Content access<br/>[sanity.ts]"]
  node_content_transform["Content transforms<br/>[portabletext.ts]"]
  node_learning_content["Guides and tutorials<br/>[guidelines.ts]"]
  node_news_stories["News and stories<br/>[posts.ts]"]
end

subgraph group_features["Site capabilities"]
  node_search["Site search<br/>[search.ts]"]
  node_search_ui["Search interface<br/>[Search.svelte]"]
  node_search_results["Search results"]
  node_offline["Offline support<br/>[sw.js]"]
  node_rss["RSS feed<br/>[rss.xml.ts]"]
  node_deploy_endpoint["Deploy endpoint<br/>[deploy.ts]"]
end

node_editor(("Content editor"))
node_sanity[("Sanity content service")]
node_developer(("Developer"))

node_editor -->|"authors content"| node_studio
node_studio -->|"configures schemas"| node_schema_registry
node_schema_registry -->|"registers models"| node_editorial_docs
node_studio -->|"configures languages"| node_localized_content
node_studio -->|"applies theme"| node_studio_theme
node_studio -.->|"stores authored content"| node_sanity
node_developer -->|"visits"| node_website
node_website -.->|"loads content"| node_content_data
node_content_data -.->|"queries content"| node_sanity
node_content_data -.->|"prepares content"| node_content_transform
node_website -.->|"presents guidance"| node_learning_content
node_website -.->|"presents updates"| node_news_stories
node_search_ui -.->|"requests search"| node_search
node_search_ui -.->|"displays results"| node_search_results
node_website -.->|"supports offline use"| node_offline
node_website -.->|"provides feed"| node_rss
node_website -.->|"exposes endpoint"| node_deploy_endpoint

click node_studio "https://github.com/chromeos/chromeos.dev/blob/main/cms/sanity.config.ts"
click node_schema_registry "https://github.com/chromeos/chromeos.dev/blob/main/cms/schemas/index.ts"
click node_editorial_docs "https://github.com/chromeos/chromeos.dev/tree/main/cms/schemas"
click node_localized_content "https://github.com/chromeos/chromeos.dev/blob/main/cms/lib/constants.ts"
click node_studio_theme "https://github.com/chromeos/chromeos.dev/blob/main/cms/lib/theme.ts"
click node_website "https://github.com/chromeos/chromeos.dev/blob/main/site/astro.config.mjs"
click node_content_data "https://github.com/chromeos/chromeos.dev/blob/main/site/lib/sanity.ts"
click node_content_transform "https://github.com/chromeos/chromeos.dev/blob/main/site/lib/portabletext.ts"
click node_learning_content "https://github.com/chromeos/chromeos.dev/blob/main/site/lib/data/guidelines.ts"
click node_news_stories "https://github.com/chromeos/chromeos.dev/blob/main/site/lib/posts.ts"
click node_search "https://github.com/chromeos/chromeos.dev/blob/main/site/lib/search.ts"
click node_search_ui "https://github.com/chromeos/chromeos.dev/blob/main/site/src/components/Search.svelte"
click node_search_results "https://github.com/chromeos/chromeos.dev/blob/main/site/src/components/SearchResults.svelte"
click node_offline "https://github.com/chromeos/chromeos.dev/blob/main/site/src/sw.js"
click node_rss "https://github.com/chromeos/chromeos.dev/blob/main/site/src/pages/%5Blang%5D/rss.xml.ts"
click node_deploy_endpoint "https://github.com/chromeos/chromeos.dev/blob/main/site/src/pages/endpoints/deploy.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_studio,node_studio_theme toneBlue
class node_schema_registry,node_editorial_docs,node_localized_content,node_sanity toneAmber
class node_website,node_content_data,node_content_transform,node_learning_content,node_news_stories toneMint
class node_search,node_search_ui,node_search_results,node_offline,node_rss,node_deploy_endpoint toneRose
class node_editor,node_developer toneIndigo
```

## Components

### Content management

- [Sanity Studio](https://github.com/chromeos/chromeos.dev/blob/main/cms/sanity.config.ts): `cms/sanity.config.ts`
- [Studio theme](https://github.com/chromeos/chromeos.dev/blob/main/cms/lib/theme.ts): `cms/lib/theme.ts`

### Content models

- [Schema registry](https://github.com/chromeos/chromeos.dev/blob/main/cms/schemas/index.ts): `cms/schemas/index.ts`
- [Editorial content](https://github.com/chromeos/chromeos.dev/tree/main/cms/schemas): `cms/schemas`
- [Localized content](https://github.com/chromeos/chromeos.dev/blob/main/cms/lib/constants.ts): `cms/lib/constants.ts`

### Developer website

- [ChromeOS.dev site](https://github.com/chromeos/chromeos.dev/blob/main/site/astro.config.mjs): `site/astro.config.mjs`
- [Content access](https://github.com/chromeos/chromeos.dev/blob/main/site/lib/sanity.ts): `site/lib/sanity.ts`
- [Content transforms](https://github.com/chromeos/chromeos.dev/blob/main/site/lib/portabletext.ts): `site/lib/portabletext.ts`
- [Guides and tutorials](https://github.com/chromeos/chromeos.dev/blob/main/site/lib/data/guidelines.ts): `site/lib/data/guidelines.ts`
- [News and stories](https://github.com/chromeos/chromeos.dev/blob/main/site/lib/posts.ts): `site/lib/posts.ts`

### Site capabilities

- [Site search](https://github.com/chromeos/chromeos.dev/blob/main/site/lib/search.ts): `site/lib/search.ts`
- [Search interface](https://github.com/chromeos/chromeos.dev/blob/main/site/src/components/Search.svelte): `site/src/components/Search.svelte`
- [Search results](https://github.com/chromeos/chromeos.dev/blob/main/site/src/components/SearchResults.svelte): `site/src/components/SearchResults.svelte`
- [Offline support](https://github.com/chromeos/chromeos.dev/blob/main/site/src/sw.js): `site/src/sw.js`
- [RSS feed](https://github.com/chromeos/chromeos.dev/blob/main/site/src/pages/%5Blang%5D/rss.xml.ts): `site/src/pages/[lang]/rss.xml.ts`
- [Deploy endpoint](https://github.com/chromeos/chromeos.dev/blob/main/site/src/pages/endpoints/deploy.ts): `site/src/pages/endpoints/deploy.ts`

### Other components

- **Content editor**
- **Sanity content service**
- **Developer**

## Connections

- Content editor → Sanity Studio: authors content
- Sanity Studio → Schema registry: configures schemas (evidence: `cms/sanity.config.ts`)
- Schema registry → Editorial content: registers models (evidence: `cms/schemas/index.ts`)
- Sanity Studio → Localized content: configures languages (evidence: `cms/sanity.config.ts`)
- Sanity Studio → Studio theme: applies theme (evidence: `cms/sanity.config.ts`)
- Sanity Studio → Sanity content service: stores authored content
- Developer → ChromeOS.dev site: visits (evidence: `README.md`)
- ChromeOS.dev site → Content access: loads content
- Content access → Sanity content service: queries content
- Content access → Content transforms: prepares content
- ChromeOS.dev site → Guides and tutorials: presents guidance
- ChromeOS.dev site → News and stories: presents updates
- Search interface → Site search: requests search
- Search interface → Search results: displays results
- ChromeOS.dev site → Offline support: supports offline use
- ChromeOS.dev site → RSS feed: provides feed
- ChromeOS.dev site → Deploy endpoint: exposes endpoint
