# sharevb/it-tools architecture

> Architecture diagram of the GitHub repository sharevb/it-tools, 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/sharevb/it-tools
- Repository: https://github.com/sharevb/it-tools

## Overview

IT Tools is a browser-based collection of developer utilities. Users discover a tool from the home catalogue or navigation, open its routed interface, provide inputs, and receive a generated or transformed result; many tools run their domain logic in the browser. The architecture also supports localization, persistent/query-based settings, themes, favorites, and optional usage tracking. The README documents runtime customization and external companion services. Several individual tools are unsampled, so the graph groups them by capability rather than inferring their internal call chains.

Main entry points: [`src/tools`](https://github.com/sharevb/it-tools/tree/chore/all-my-stuffs/src/tools) (Utility collection), [`src/main.ts`](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/main.ts) (App bootstrap), [`src/router.ts`](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/router.ts) (Route dispatch), [`src/App.vue`](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/App.vue) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_bootstrap["App bootstrap<br/>[main.ts]"]
  node_appview["App shell<br/>[App.vue]"]
  node_router["Route dispatch<br/>[router.ts]"]
  node_base["Base layout<br/>[base.layout.vue]"]
  node_toolview["Tool layout<br/>[tool.layout.vue]"]
end

subgraph group_discovery["Tool discovery"]
  node_home["Home catalogue<br/>[Home.page.vue]"]
  node_toolmenu["Tool navigation"]
  node_command["Command palette"]
  node_toolregistry["Tool registry<br/>[index.ts]"]
end

subgraph group_tools["Tool capabilities"]
  node_toolcollection["Utility collection"]
  node_customtools["Custom external tools"]
end

subgraph group_shared["Shared services"]
  node_settings["Runtime settings<br/>[tools-settings.ts]"]
  node_querysettings["Query and storage<br/>[queryParams.ts]"]
  node_localization["Localization<br/>[i18n.plugin.ts]"]
  node_themes["Theme state<br/>[style.store.ts]"]
  node_tracking["Usage tracking"]
end

subgraph group_integrations["External integrations"]
  node_plausible["Plausible analytics"]
  node_companion["Companion services"]
end

node_user(("User"))

node_user -->|"browses"| node_home
node_user -.->|"navigates"| node_toolmenu
node_user -.->|"searches"| node_command
node_bootstrap -->|"mounts"| node_appview
node_bootstrap -->|"installs"| node_router
node_appview -->|"renders"| node_base
node_appview -->|"renders routes"| node_router
node_router -->|"routes to"| node_home
node_router -->|"builds routes"| node_toolregistry
node_router -->|"selects layout"| node_toolview
node_base -->|"renders"| node_toolmenu
node_toolregistry -.->|"registers tools"| node_toolcollection
node_user -->|"uses"| node_toolcollection
node_toolview -->|"hosts tool"| node_toolcollection
node_home -->|"lists tools"| node_toolregistry
node_home -->|"supports custom content"| node_customtools
node_bootstrap -->|"loads"| node_settings
node_settings -->|"provides defaults"| node_querysettings
node_toolcollection -.->|"persists parameters"| node_querysettings
node_appview -->|"reads theme"| node_themes
node_bootstrap -->|"installs"| node_localization
node_toolcollection -.->|"uses translations"| node_localization
node_bootstrap -->|"installs"| node_tracking
node_tracking -->|"tracks events"| node_plausible
node_toolcollection -.->|"may require services"| node_companion

click node_bootstrap "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/main.ts"
click node_appview "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/App.vue"
click node_router "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/router.ts"
click node_base "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/layouts/base.layout.vue"
click node_toolview "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/layouts/tool.layout.vue"
click node_home "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/pages/Home.page.vue"
click node_toolmenu "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/components/CollapsibleToolMenu.vue"
click node_command "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/modules/command-palette/command-palette.vue"
click node_toolregistry "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/tools/index.ts"
click node_toolcollection "https://github.com/sharevb/it-tools/tree/chore/all-my-stuffs/src/tools"
click node_customtools "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/components/ExternalToolContent.vue"
click node_settings "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/tools-settings.ts"
click node_querysettings "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/composable/queryParams.ts"
click node_localization "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/plugins/i18n.plugin.ts"
click node_themes "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/stores/style.store.ts"
click node_tracking "https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/plugins/plausible.plugin.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_bootstrap,node_appview,node_router,node_base,node_toolview,node_user toneBlue
class node_home,node_toolmenu,node_command,node_toolregistry toneAmber
class node_toolcollection,node_customtools toneMint
class node_settings,node_querysettings,node_localization,node_themes,node_tracking toneRose
class node_plausible,node_companion toneIndigo
```

## Components

### Application shell

- [App bootstrap](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/main.ts): `src/main.ts`
- [App shell](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/App.vue): `src/App.vue`
- [Route dispatch](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/router.ts): `src/router.ts`
- [Base layout](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/layouts/base.layout.vue): `src/layouts/base.layout.vue`
- [Tool layout](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/layouts/tool.layout.vue): `src/layouts/tool.layout.vue`

### Tool discovery

- [Home catalogue](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/pages/Home.page.vue): `src/pages/Home.page.vue`
- [Tool navigation](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/components/CollapsibleToolMenu.vue): `src/components/CollapsibleToolMenu.vue`
- [Command palette](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/modules/command-palette/command-palette.vue): `src/modules/command-palette/command-palette.vue`
- [Tool registry](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/tools/index.ts): `src/tools/index.ts`

### Tool capabilities

- [Utility collection](https://github.com/sharevb/it-tools/tree/chore/all-my-stuffs/src/tools): `src/tools`
- [Custom external tools](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/components/ExternalToolContent.vue): `src/components/ExternalToolContent.vue`

### Shared services

- [Runtime settings](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/tools-settings.ts): `src/tools-settings.ts`
- [Query and storage](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/composable/queryParams.ts): `src/composable/queryParams.ts`
- [Localization](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/plugins/i18n.plugin.ts): `src/plugins/i18n.plugin.ts`
- [Theme state](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/stores/style.store.ts): `src/stores/style.store.ts`
- [Usage tracking](https://github.com/sharevb/it-tools/blob/chore/all-my-stuffs/src/plugins/plausible.plugin.ts): `src/plugins/plausible.plugin.ts`

### External integrations

- **Plausible analytics**
- **Companion services**

### Other components

- **User**

## Connections

- User → Home catalogue: browses
- User → Tool navigation: navigates
- User → Command palette: searches
- App bootstrap → App shell: mounts (evidence: `src/main.ts`)
- App bootstrap → Route dispatch: installs (evidence: `src/main.ts`)
- App shell → Base layout: renders (evidence: `src/App.vue`)
- App shell → Route dispatch: renders routes (evidence: `src/App.vue`)
- Route dispatch → Home catalogue: routes to (evidence: `src/router.ts`)
- Route dispatch → Tool registry: builds routes (evidence: `src/router.ts`)
- Route dispatch → Tool layout: selects layout (evidence: `src/router.ts`)
- Base layout → Tool navigation: renders (evidence: `src/layouts/base.layout.vue`)
- Tool registry → Utility collection: registers tools
- User → Utility collection: uses
- Tool layout → Utility collection: hosts tool (evidence: `src/layouts/tool.layout.vue`)
- Home catalogue → Tool registry: lists tools (evidence: `src/pages/Home.page.vue`)
- Home catalogue → Custom external tools: supports custom content
- App bootstrap → Runtime settings: loads (evidence: `src/main.ts`)
- Runtime settings → Query and storage: provides defaults (evidence: `src/composable/queryParams.ts`)
- Utility collection → Query and storage: persists parameters
- App shell → Theme state: reads theme (evidence: `src/App.vue`)
- App bootstrap → Localization: installs (evidence: `src/main.ts`)
- Utility collection → Localization: uses translations (evidence: `src/tools/url-text-fragment-maker/url-text-fragment-maker.service.ts`)
- App bootstrap → Usage tracking: installs (evidence: `src/main.ts`)
- Usage tracking → Plausible analytics: tracks events (evidence: `src/plugins/plausible.plugin.ts`)
- Utility collection → Companion services: may require services
