# samydoesit/vue-turbo-starter architecture

> Architecture diagram of the GitHub repository samydoesit/vue-turbo-starter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/samydoesit/vue-turbo-starter
- Repository: https://github.com/samydoesit/vue-turbo-starter

## Overview

##### Project type and purpose
- This is a frontend-focused monorepo (managed with pnpm & Turborepo) that hosts:
- Three “apps” (Nuxt3, Storybook, Histoire) for demos and development
- A set of shared packages (UI component library, CSS preset, Pinia store, tsconfig presets)
- Purpose: Provide a starter scaffold for Vue 3/Nuxt 3 projects with integrated style presets, component library, state management, documentation (Storybook/Histoire), tests, and CI/CD.

##### File structure
- Top-level:
- Config files (.editorconfig, .gitignore, Dockerfiles, ESLint, Prettier, Turborepo)
- CI workflows under .github/workflows (autofix, CI)
- Scripts for release and commit verification
- apps/:
- histoire/ – Histoire playground using Vite, UnoCSS
- nuxt/ – Nuxt 3 SSR app with E2E (Playwright), Vitest, Netlify config
- storybook/ – Storybook v7 server (Go), MDX stories, Netlify config
- packages/:
- ui/ – Vue component library used by all apps
- css-preset/ – UnoCSS preset module
- pinia-store/ – Pinia stores
- tsconfig/ – Shared TypeScript configuration
- Build & deployment:
- Dockerfiles per app
- Netlify config for storybook & nuxt
- Testing:
- Vitest for unit tests
- Playwright for E2E in nuxt
- Test fixtures under each package/app where relevant

##### Key insights from README
- Tech stack: pnpm, Turborepo, Vue 3, Nuxt 3, Vite, UnoCSS, Storybook, Histoire, Vitest, Playwright
- Each app and package is TypeScript-ready
- Build & run commands, Docker instructions, CI via GitHub Actions
- Demo URLs showing deployed Nuxt & Storybook via Netlify

##### Elements
- from monorepo → Turborepo/pnpm → build/test tasks
- from packages → apps
- from CI/CD → Docker/Netlify
- Another for “apps”
- Annotations for key frameworks (Vue, Nuxt, Storybook, Histoire)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Monorepo Root
    Root["Monorepo Root (GitHub)"]:::root
    Root --> Tooling

    %% Tooling Layer
    subgraph "Tooling & Configuration"
        direction TB
        Turborepo["Turborepo & pnpm"]:::tooling
        Configs["Root Configs"]:::tooling
        Scripts["Release & Commit Scripts"]:::tooling
    end
    Root --> Turborepo
    Root --> Configs
    Root --> Scripts

    %% Packages Layer
    subgraph "Shared Packages"
        direction TB
        UI["UI Component Library"]:::package
        CSS["UnoCSS Preset"]:::package
        Pinia["Pinia Store"]:::package
        TSConfig["TSConfig Presets"]:::package
    end
    Turborepo --> UI
    Turborepo --> CSS
    Turborepo --> Pinia
    Turborepo --> TSConfig

    %% Apps Layer
    subgraph "Applications"
        direction TB
        Nuxt["Nuxt 3 SSR App"]:::app
        Storybook["Storybook v7 Server"]:::app
        Histoire["Histoire Playground"]:::app
    end
    UI --> Nuxt
    CSS --> Nuxt
    Pinia --> Nuxt
    TSConfig --> Nuxt

    UI --> Storybook
    CSS --> Storybook
    Pinia --> Storybook
    TSConfig --> Storybook

    UI --> Histoire
    CSS --> Histoire
    Pinia --> Histoire
    TSConfig --> Histoire

    Turborepo --> Nuxt
    Turborepo --> Storybook
    Turborepo --> Histoire

    %% CI/CD
    subgraph "CI/CD Pipeline"
        direction TB
        GitHubActions["GitHub Actions"]:::cicd
    end
    Turborepo --> GitHubActions
    UI --> GitHubActions
    CSS --> GitHubActions
    Pinia --> GitHubActions
    TSConfig --> GitHubActions
    Nuxt --> GitHubActions
    Storybook --> GitHubActions
    Histoire --> GitHubActions

    %% Deployment
    subgraph "Deployment Targets"
        direction TB
        DockerRegistry["Docker Registry"]:::deploy
        Netlify["Netlify Hosting"]:::deploy
    end
    GitHubActions --> DockerRegistry
    GitHubActions --> Netlify

    DockerRegistry --> Nuxt
    DockerRegistry --> Storybook
    DockerRegistry --> Histoire
    Netlify --> Nuxt
    Netlify --> Storybook

    %% Click Events - Monorepo Root & Configs
    click Root "https://github.com/samydoesit/vue-turbo-starter/tree/main//"
    click Turborepo "https://github.com/samydoesit/vue-turbo-starter/blob/main/pnpm-workspace.yaml"
    click Turborepo "https://github.com/samydoesit/vue-turbo-starter/blob/main/turbo.json"
    click Configs "https://github.com/samydoesit/vue-turbo-starter/blob/main/.editorconfig"
    click Configs "https://github.com/samydoesit/vue-turbo-starter/blob/main/eslint.config.js"
    click Configs "https://github.com/samydoesit/vue-turbo-starter/blob/main/.prettierrc"

    %% Click Events - Scripts
    click Scripts "https://github.com/samydoesit/vue-turbo-starter/blob/main/scripts/release.ts"
    click Scripts "https://github.com/samydoesit/vue-turbo-starter/blob/main/scripts/releaseUtils.ts"
    click Scripts "https://github.com/samydoesit/vue-turbo-starter/blob/main/scripts/verifyCommit.ts"

    %% Click Events - Packages
    click UI "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/ui"
    click UI "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/ui/src"
    click UI "https://github.com/samydoesit/vue-turbo-starter/blob/main/packages/ui/vitest.config.ts"
    click CSS "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/css-preset"
    click CSS "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/css-preset/src"
    click CSS "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/css-preset/src/rules"
    click CSS "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/css-preset/src/theme"
    click CSS "https://github.com/samydoesit/vue-turbo-starter/blob/main/packages/css-preset/build.config.ts"
    click Pinia "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/pinia-store"
    click Pinia "https://github.com/samydoesit/vue-turbo-starter/blob/main/packages/pinia-store/index.ts"
    click Pinia "https://github.com/samydoesit/vue-turbo-starter/blob/main/packages/pinia-store/user/user.ts"
    click TSConfig "https://github.com/samydoesit/vue-turbo-starter/tree/main/packages/tsconfig"
    click TSConfig "https://github.com/samydoesit/vue-turbo-starter/blob/main/packages/tsconfig/base.json"
    click TSConfig "https://github.com/samydoesit/vue-turbo-starter/blob/main/packages/tsconfig/vite.json"

    %% Click Events - Applications
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/nuxt"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/nuxt.config.ts"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/tsconfig.json"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/uno.config.ts"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/app.vue"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/e2e/test.e2e.ts"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/playwright.config.ts"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/vitest.config.ts"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/nuxt/Dockerfile"
    click Nuxt "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/netlify.toml"

    click Storybook "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/storybook"
    click Storybook "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/storybook/.storybook/main.ts"
    click Storybook "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/storybook/server.go"
    click Storybook "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/storybook/vite.config.js"
    click Storybook "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/storybook/stories"
    click Storybook "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/storybook/Dockerfile"
    click Storybook "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/storybook/netlify.toml"

    click Histoire "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/histoire"
    click Histoire "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/histoire/histoire.config.ts"
    click Histoire "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/histoire/histoire.setup.ts"
    click Histoire "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/histoire/vite.config.ts"
    click Histoire "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/histoire/uno.config.ts"
    click Histoire "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/histoire/src/test.story.vue"
    click Histoire "https://github.com/samydoesit/vue-turbo-starter/tree/main/apps/histoire/Dockerfile"

    %% Click Events - CI/CD
    click GitHubActions "https://github.com/samydoesit/vue-turbo-starter/blob/main/.github/workflows/autofix.yml"
    click GitHubActions "https://github.com/samydoesit/vue-turbo-starter/blob/main/.github/workflows/ci.yml"

    %% Click Events - Deployment
    click DockerRegistry "https://github.com/samydoesit/vue-turbo-starter/blob/main/.dockerignore"
    click Netlify "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/nuxt/netlify.toml"
    click Netlify "https://github.com/samydoesit/vue-turbo-starter/blob/main/apps/storybook/netlify.toml"

    %% Styling
    classDef root fill:#f9f,stroke:#333,stroke-width:2px
    classDef tooling fill:#bbf,stroke:#333,stroke-width:1px
    classDef package fill:#eee,stroke:#666,stroke-width:1px
    classDef app fill:#ade,stroke:#333,stroke-width:1px
    classDef cicd fill:#faf,stroke:#333,stroke-width:1px
    classDef deploy fill:#dfd,stroke:#333,stroke-width:1px
```
