# googlecloudplatform/gcc-creative-studio architecture

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

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/gcc-creative-studio
- Repository: https://github.com/googlecloudplatform/gcc-creative-studio

## Overview

Creative Studio is a web-based generative multimedia platform. Creators authenticate, work in a workspace, submit prompts or media through the Angular studio, and request image, video, audio, or Gemini-assisted operations; generated media can then be browsed in galleries. The backend is organized by feature, with FastAPI controllers delegating to services and persistence. The README documents Vertex AI, Cloud SQL, and Cloud Storage capabilities; several feature implementations were not sampled, so uncertain frontend-to-backend links are dashed.

Main entry points: [`backend/main.py`](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/main.py) (FastAPI application), [`backend/src/images/imagen_service.py`](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/images/imagen_service.py) (Imagen generation), [`backend/src/galleries/gallery_service.py`](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/galleries/gallery_service.py) (Gallery service), [`frontend/src/app/app.module.ts`](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/app.module.ts) (Creative Studio UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Creator experience"]
  node_studio["Creative Studio UI<br/>[app.module.ts]"]
  node_image_ui["Image studio<br/>[home.component.ts]"]
  node_video_ui["Video studio<br/>[video.component.ts]"]
  node_workflow_ui["Workflow editor"]
  node_gallery_ui["Media gallery"]
end

subgraph group_generation["AI creation"]
  node_image_gen["Imagen generation<br/>[imagen_service.py]"]
  node_video_gen["Veo generation<br/>[veo_service.py]"]
  node_audio_gen["Audio generation<br/>[audio_service.py]"]
  node_gemini["Gemini tools<br/>[gemini_service.py]"]
  node_vertex{{"Vertex AI"}}
  node_workflows["Workflow execution"]
end

subgraph group_library["Media library"]
  node_gallery["Gallery service<br/>[gallery_service.py]"]
  node_source_assets["Source assets"]
  node_brand["Brand guidelines"]
  node_templates["Media templates"]
end

subgraph group_collaboration["Workspace and identity"]
  node_auth["Identity and access<br/>[auth_guard.py]"]
  node_workspace["Workspace access"]
  node_users["User management<br/>[user_service.py]"]
end

subgraph group_platform["Backend platform"]
  node_database[("Cloud SQL<br/>[database.py]")]
  node_storage[("Cloud Storage<br/>[storage_service.py]")]
  node_api["FastAPI application<br/>[main.py]"]
  node_firebase{{"Firebase Identity"}}
end

node_creator(("Creator"))

node_creator -->|"uses"| node_studio
node_studio -.->|"calls API"| node_api
node_studio -->|"hosts"| node_image_ui
node_image_ui -.->|"requests images"| node_image_gen
node_video_ui -.->|"requests video"| node_video_gen
node_workflow_ui -.->|"runs workflows"| node_workflows
node_gallery_ui -.->|"browses media"| node_gallery
node_api -->|"routes to"| node_image_gen
node_api -->|"routes to"| node_video_gen
node_api -->|"routes to"| node_audio_gen
node_api -->|"routes to"| node_gemini
node_api -->|"routes to"| node_gallery
node_api -->|"routes to"| node_source_assets
node_api -->|"routes to"| node_brand
node_api -->|"routes to"| node_templates
node_image_gen -.->|"generates with"| node_vertex
node_video_gen -.->|"generates with"| node_vertex
node_gemini -.->|"uses models"| node_vertex
node_image_gen -.->|"stores results"| node_gallery
node_brand -->|"uses signed uploads"| node_storage
node_source_assets -.->|"stores assets"| node_storage
node_auth -->|"verifies identity"| node_firebase
node_auth -->|"provisions user"| node_users
node_workspace -->|"checks membership"| node_database
node_users -.->|"persists users"| node_database
node_gallery -.->|"persists media"| node_database

click node_studio "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/app.module.ts"
click node_image_ui "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/home/home.component.ts"
click node_video_ui "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/video/video.component.ts"
click node_workflow_ui "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/workflows/workflow-editor/workflow-editor.component.ts"
click node_gallery_ui "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/gallery/media-gallery/media-gallery.component.ts"
click node_image_gen "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/images/imagen_service.py"
click node_video_gen "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/videos/veo_service.py"
click node_audio_gen "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/audios/audio_service.py"
click node_gemini "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/multimodal/gemini_service.py"
click node_workflows "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/workflows_executor/workflows_executor_service.py"
click node_gallery "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/galleries/gallery_service.py"
click node_source_assets "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/source_assets/source_asset_service.py"
click node_brand "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/brand_guidelines/brand_guideline_service.py"
click node_templates "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/media_templates/media_templates_service.py"
click node_database "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/database.py"
click node_storage "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/common/storage_service.py"
click node_api "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/main.py"
click node_auth "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/auth/auth_guard.py"
click node_workspace "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/workspaces/workspace_auth_guard.py"
click node_users "https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/users/user_service.py"

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_image_ui,node_video_ui,node_workflow_ui,node_gallery_ui toneBlue
class node_image_gen,node_video_gen,node_audio_gen,node_gemini,node_vertex,node_workflows toneAmber
class node_gallery,node_source_assets,node_brand,node_templates toneMint
class node_auth,node_workspace,node_users toneRose
class node_database,node_storage,node_api,node_firebase,node_creator toneIndigo
```

## Components

### Creator experience

- [Creative Studio UI](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/app.module.ts): `frontend/src/app/app.module.ts`
- [Image studio](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/home/home.component.ts): `frontend/src/app/home/home.component.ts`
- [Video studio](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/video/video.component.ts): `frontend/src/app/video/video.component.ts`
- [Workflow editor](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/workflows/workflow-editor/workflow-editor.component.ts): `frontend/src/app/workflows/workflow-editor/workflow-editor.component.ts`
- [Media gallery](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/frontend/src/app/gallery/media-gallery/media-gallery.component.ts): `frontend/src/app/gallery/media-gallery/media-gallery.component.ts`

### AI creation

- [Imagen generation](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/images/imagen_service.py): `backend/src/images/imagen_service.py`
- [Veo generation](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/videos/veo_service.py): `backend/src/videos/veo_service.py`
- [Audio generation](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/audios/audio_service.py): `backend/src/audios/audio_service.py`
- [Gemini tools](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/multimodal/gemini_service.py): `backend/src/multimodal/gemini_service.py`
- **Vertex AI**
- [Workflow execution](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/workflows_executor/workflows_executor_service.py): `backend/src/workflows_executor/workflows_executor_service.py`

### Media library

- [Gallery service](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/galleries/gallery_service.py): `backend/src/galleries/gallery_service.py`
- [Source assets](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/source_assets/source_asset_service.py): `backend/src/source_assets/source_asset_service.py`
- [Brand guidelines](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/brand_guidelines/brand_guideline_service.py): `backend/src/brand_guidelines/brand_guideline_service.py`
- [Media templates](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/media_templates/media_templates_service.py): `backend/src/media_templates/media_templates_service.py`

### Workspace and identity

- [Identity and access](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/auth/auth_guard.py): `backend/src/auth/auth_guard.py`
- [Workspace access](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/workspaces/workspace_auth_guard.py): `backend/src/workspaces/workspace_auth_guard.py`
- [User management](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/users/user_service.py): `backend/src/users/user_service.py`

### Backend platform

- [Cloud SQL](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/database.py): `backend/src/database.py`
- [Cloud Storage](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/src/common/storage_service.py): `backend/src/common/storage_service.py`
- [FastAPI application](https://github.com/googlecloudplatform/gcc-creative-studio/blob/main/backend/main.py): `backend/main.py`
- **Firebase Identity**

### Other components

- **Creator**

## Connections

- Creator → Creative Studio UI: uses
- Creative Studio UI → FastAPI application: calls API
- Creative Studio UI → Image studio: hosts (evidence: `frontend/src/app/app.module.ts`)
- Image studio → Imagen generation: requests images
- Video studio → Veo generation: requests video
- Workflow editor → Workflow execution: runs workflows
- Media gallery → Gallery service: browses media
- FastAPI application → Imagen generation: routes to (evidence: `backend/main.py`)
- FastAPI application → Veo generation: routes to (evidence: `backend/main.py`)
- FastAPI application → Audio generation: routes to (evidence: `backend/main.py`)
- FastAPI application → Gemini tools: routes to (evidence: `backend/main.py`)
- FastAPI application → Gallery service: routes to (evidence: `backend/main.py`)
- FastAPI application → Source assets: routes to (evidence: `backend/main.py`)
- FastAPI application → Brand guidelines: routes to (evidence: `backend/main.py`)
- FastAPI application → Media templates: routes to (evidence: `backend/main.py`)
- Imagen generation → Vertex AI: generates with
- Veo generation → Vertex AI: generates with
- Gemini tools → Vertex AI: uses models
- Imagen generation → Gallery service: stores results
- Brand guidelines → Cloud Storage: uses signed uploads
- Source assets → Cloud Storage: stores assets
- Identity and access → Firebase Identity: verifies identity (evidence: `backend/src/auth/auth_guard.py`)
- Identity and access → User management: provisions user (evidence: `backend/src/auth/auth_guard.py`)
- Workspace access → Cloud SQL: checks membership (evidence: `backend/src/workspaces/workspace_auth_guard.py`)
- User management → Cloud SQL: persists users
- Gallery service → Cloud SQL: persists media
