# mateusrodcosta/gnome-shell-extension-default-workspace architecture

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

- Interactive diagram: https://gitdiagram.com/mateusrodcosta/gnome-shell-extension-default-workspace
- Repository: https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace

## Overview

Default Workspace is a small GNOME Shell extension that selects a configured workspace during login. Its preferences expose a workspace-number setting; when startup completes, the extension reads that setting, creates workspaces if needed, then activates the selected one. The excerpts show the preference binding and runtime behavior, but not the schema contents or GNOME’s internal settings implementation.

Main entry points: [`src/extension.js`](https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace/blob/main/src/extension.js) (Workspace extension), [`src/prefs.js`](https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace/blob/main/src/prefs.js) (Preferences UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_preferences["Preferences UI<br/>[prefs.js]"]
node_settings[("Extension settings")]
node_extension["Workspace extension<br/>[extension.js]"]
node_startup["Startup event"]
node_workspaces["Workspace manager"]

node_user -->|"sets workspace"| node_preferences
node_preferences -->|"binds setting"| node_settings
node_extension -->|"reads setting"| node_settings
node_extension -->|"listens for"| node_startup
node_startup -->|"triggers change"| node_extension
node_extension -->|"creates and activates"| node_workspaces

click node_preferences "https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace/blob/main/src/prefs.js"
click node_extension "https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace/blob/main/src/extension.js"

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_user,node_preferences toneBlue
class node_settings toneAmber
class node_extension toneTeal
class node_startup,node_workspaces toneIndigo
```

## Components

### Other components

- **User**
- [Preferences UI](https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace/blob/main/src/prefs.js): `src/prefs.js`
- **Extension settings**
- [Workspace extension](https://github.com/mateusrodcosta/gnome-shell-extension-default-workspace/blob/main/src/extension.js): `src/extension.js`
- **Startup event**
- **Workspace manager**

## Connections

- User → Preferences UI: sets workspace (evidence: `src/prefs.js`)
- Preferences UI → Extension settings: binds setting (evidence: `src/prefs.js`)
- Workspace extension → Extension settings: reads setting (evidence: `src/extension.js`)
- Workspace extension → Startup event: listens for (evidence: `src/extension.js`)
- Startup event → Workspace extension: triggers change (evidence: `src/extension.js`)
- Workspace extension → Workspace manager: creates and activates (evidence: `src/extension.js`)
