# madebyarthouse/momentum-coalition-compass architecture

> Architecture diagram of the GitHub repository madebyarthouse/momentum-coalition-compass, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/madebyarthouse/momentum-coalition-compass
- Repository: https://github.com/madebyarthouse/momentum-coalition-compass

## Overview

##### Component Relationships

- Data flow from processed data to components
- Component hierarchy (parent-child relationships)
- Hook usage across components
- Utility function consumption

##### Widget Embedding System

- Build process for widget (momentum-venn.js)
- Widget integration flow
- Required assets (styles.css)

- Blue: Core React components
- Green: Data processing components
- Purple: External libraries
- Orange: Build/deployment artifacts
- Gray: Configuration files

Specific Implementation Details:

**[Data Processing Layer]**
- data.json → process-data.ts → data-minimal.json
- ↓
**[Client Application Layer]**
- Pages
- VennPage
- AnswersPerPartyPage
- AnswersPerQuestionPage

- Components
- VennDiagram
- Filters (Parties/Topics)
- Details

- Hooks
- useShare

- Utils
- MotionVariants

**[External Dependencies]**
- chart.js
- Tailwind CSS
- Framer Motion

**[Widget Build System]**
- Selected Components → Vite Build → momentum-venn.js

Important Elements to Highlight:
##### Static hosting deployment flow

Additional Considerations:
- A note about the client-side nature of the application
- Data processing workflow
- Widget embedding capability
- Configuration files (vite.config.ts, tailwind.config.js, etc.)

- Data flow directions
- Component relationships
- Build/deployment processes
- External dependency integration

This structure will provide a clear understanding of both the application's architecture and its data processing pipeline while maintaining the right level of abstraction for a principal software engineer to understand the system's complete architecture.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Data
        RawData["Raw Data (data.json)"]
        ProcessScript["Process Script"]
        MinData["Minimal Data"]
        DataTypes["Data Types"]
        DataAnalysis["Data Analysis"]
        
        RawData --> ProcessScript
        ProcessScript --> MinData
        DataTypes -.-> ProcessScript
        ProcessScript -.-> DataAnalysis
    end

    subgraph Frontend
        subgraph Pages
            VennPage["Venn Page"]
            AnswersPartyPage["Answers Per Party"]
            AnswersQuestionPage["Answers Per Question"]
        end

        subgraph Components
            VennDiagram["Venn Diagram"]
            PartiesFilter["Parties Filter"]
            TopicsFilter["Topics Filter"]
            Details["Details"]
            VennDetails["Venn Details"]
        end

        subgraph Hooks
            ShareHook["Share Hook"]
        end

        subgraph Utils
            Colors["Colors"]
            MotionVars["Motion Variants"]
            PartiesColors["Parties Colors"]
        end
    end

    subgraph Widget
        WidgetBuild["Widget Build"]
        WidgetStyles["Widget Styles"]
        WidgetIntegration["Widget Integration"]
        TestPage["Test Page"]
        
        WidgetBuild --> WidgetStyles
        WidgetBuild --> WidgetIntegration
        WidgetIntegration --> TestPage
    end

    subgraph Config
        ViteConfig["Vite Config"]
        TailwindConfig["Tailwind Config"]
        TSConfig["TypeScript Config"]
    end

    subgraph External
        ChartJS["Chart.js"]
        TailwindCSS["Tailwind CSS"]
        FramerMotion["Framer Motion"]
    end

    MinData --> VennPage
    MinData --> AnswersPartyPage
    MinData --> AnswersQuestionPage

    VennPage --> VennDiagram
    VennPage --> PartiesFilter
    VennPage --> TopicsFilter
    VennPage --> VennDetails

    ShareHook --> VennPage
    Colors --> VennDiagram
    MotionVars --> VennDiagram
    PartiesColors --> VennDiagram

    ChartJS --> VennDiagram
    TailwindCSS --> Frontend
    FramerMotion --> Frontend

    classDef config fill:#d3d3d3
    classDef data fill:#90EE90
    classDef frontend fill:#87CEEB
    classDef external fill:#DDA0DD
    classDef widget fill:#FFA500

    class ViteConfig,TailwindConfig,TSConfig config
    class RawData,ProcessScript,MinData,DataTypes,DataAnalysis data
    class VennPage,AnswersPartyPage,AnswersQuestionPage,VennDiagram,PartiesFilter,TopicsFilter,Details,VennDetails,ShareHook,Colors,MotionVars,PartiesColors frontend
    class ChartJS,TailwindCSS,FramerMotion external
    class WidgetBuild,WidgetStyles,WidgetIntegration,TestPage widget

    click VennPage "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/pages/venn-page.tsx"
    click AnswersPartyPage "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/pages/answers-per-party-page.tsx"
    click AnswersQuestionPage "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/pages/answers-per-question-page.tsx"
    click VennDiagram "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/components/venn-diagramm.tsx"
    click PartiesFilter "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/components/parties-filter.tsx"
    click TopicsFilter "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/components/topics-filter.tsx"
    click Details "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/components/details.tsx"
    click VennDetails "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/components/venn-details.tsx"
    click ShareHook "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/hooks/use-share.ts"
    click Colors "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/utils/colors.ts"
    click MotionVars "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/utils/motion-variants.ts"
    click PartiesColors "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/utils/partiesWithColors.ts"
    click RawData "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/wahlkabine-data/data.json"
    click ProcessScript "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/wahlkabine-data/process-data.ts"
    click MinData "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/wahlkabine-data/data-minimal.json"
    click DataTypes "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/wahlkabine-data/types.ts"
    click DataAnalysis "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/wahlkabine-data/analyse-data.ts"
    click WidgetBuild "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/public/momentum-venn.js"
    click WidgetStyles "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/public/styles.css"
    click WidgetIntegration "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/src/lib/diagram-injection.ts"
    click TestPage "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/public/test.html"
    click ViteConfig "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/vite.config.ts"
    click TailwindConfig "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/tailwind.config.js"
    click TSConfig "https://github.com/madebyarthouse/momentum-coalition-compass/blob/main/tsconfig.json"
```
