# anvayb/priorityvizualizer architecture

> Architecture diagram of the GitHub repository anvayb/priorityvizualizer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anvayb/priorityvizualizer
- Repository: https://github.com/anvayb/priorityvizualizer

## Overview

##### Project Type & Purpose
- Full-stack, single-page application (SPA) for priority/task management.
- Frontend: React 18 + TypeScript + Vite + TailwindCSS + shadcn/ui components.
- Backend: Supabase (PostgreSQL + Auth) as a serverless BaaS.
- Hosting/CI: Netlify serves static assets; Supabase CLI handles migrations.

##### File Structure
- Top-level configs: .env, netlify.toml, tsconfig*, vite.config.ts, Makefile, supabase/config.toml
- Frontend source (src/):
– main.tsx (entry point)
– pages/ (Auth, Index, NotFound)
– components/ (UI and feature components: PieChart, PriorityForm, CompletionCounter, etc.)
– integrations/supabase/ (client.ts, types.ts)
– hooks/, lib/, types/
- Public assets (public/): static JSON, robots.txt
- Supabase folder: migration files, CLI temp
- Build & style scripts: package.json, postcss.config.js, tailwind.config.ts, eslint.config.js

##### Key Architectural Insights from README
- SPA architecture: client-heavy; all business logic runs in browser.
- Data persistence options:
– Cloud-sync via Supabase (Auth + Row-Level Security + Postgres).
– Local export/import of JSON.
- UI patterns: hierarchical pie chart, dynamic forms, React Hook Form + Zod.

##### Main Components & Relationships
A. User’s Browser (React SPA)
– UI Layer: Pages, Components, Charts, Forms
– State Layer: React hooks + context (use-mobile, use-toast)
– Integration Layer: supabase client for Auth & DB operations
– Utilities: JSON export/import (src/lib/utils.ts)
B. Static Asset Hosting (Netlify)
– Vite build outputs JS/CSS, deployed by Netlify
– netlify.toml configures build & redirects
C. Supabase Service
– Auth module for user sign-up / sign-in
– PostgreSQL database with tables: sections → subsections → tasks
– Row-Level Security enforces per-user data isolation
– CLI migrations (supabase/migrations/*.sql) for schema versioning
D. External Storage: Local File System
– JSON generation (timestamped) and download
– JSON upload parser for importing data

##### Architectural Patterns & Design Principles
- SPA with “API-driven UI” — clear separation of UI, state, and data layers.
- BaaS pattern — no custom backend code; relies on Supabase for persistence and auth.
- Progressive enhancement — offline mode via local JSON export/import.
- Component-based architecture — reusable UI primitives under src/components/ui.
- Infrastructure-as-code — supabase/config.toml + migration SQL files.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Primary Blocks
    subgraph "User Browser (React SPA)"
        direction TB
        subgraph "UI Layer" 
            direction TB
            Entry["React SPA Entry Point\n(src/main.tsx)"]:::ui
            click Entry "https://github.com/anvayb/priorityvizualizer/blob/main/src/main.tsx"
            App["Root App Component\n(src/App.tsx)"]:::ui
            click App "https://github.com/anvayb/priorityvizualizer/blob/main/src/App.tsx"
            subgraph "UI Components Directory" 
                direction TB
                UI_Prim["UI Primitive Library\n(src/components/ui)"]:::ui
                click UI_Prim "https://github.com/anvayb/priorityvizualizer/tree/main/src/components/ui"
                CC["Completion Counter\n(src/components/CompletionCounter.tsx)"]:::ui
                click CC "https://github.com/anvayb/priorityvizualizer/blob/main/src/components/CompletionCounter.tsx"
                HI["Hover Info Tooltip\n(src/components/HoverInfo.tsx)"]:::ui
                click HI "https://github.com/anvayb/priorityvizualizer/blob/main/src/components/HoverInfo.tsx"
                PC["Hierarchical Pie Chart\n(src/components/PieChart.tsx)"]:::ui
                click PC "https://github.com/anvayb/priorityvizualizer/blob/main/src/components/PieChart.tsx"
                PF["Priority Form\n(src/components/PriorityForm.tsx)"]:::ui
                click PF "https://github.com/anvayb/priorityvizualizer/blob/main/src/components/PriorityForm.tsx"
            end
            subgraph "Pages" 
                direction TB
                Auth["Authentication Page\n(src/pages/Auth.tsx)"]:::ui
                click Auth "https://github.com/anvayb/priorityvizualizer/blob/main/src/pages/Auth.tsx"
                Index["Main Dashboard Page\n(src/pages/Index.tsx)"]:::ui
                click Index "https://github.com/anvayb/priorityvizualizer/blob/main/src/pages/Index.tsx"
                NotFound["404 Not Found Page\n(src/pages/NotFound.tsx)"]:::ui
                click NotFound "https://github.com/anvayb/priorityvizualizer/blob/main/src/pages/NotFound.tsx"
            end
        end
        subgraph "State Layer"
            direction TB
            MobileHook["use-mobile Hook\n(src/hooks/use-mobile.tsx)"]:::state
            click MobileHook "https://github.com/anvayb/priorityvizualizer/blob/main/src/hooks/use-mobile.tsx"
            ToastHook["use-toast Hook\n(src/hooks/use-toast.ts)"]:::state
            click ToastHook "https://github.com/anvayb/priorityvizualizer/blob/main/src/hooks/use-toast.ts"
        end
        subgraph "Integration Layer"
            direction TB
            SupClient["Supabase Client Init\n(src/integrations/supabase/client.ts)"]:::data
            click SupClient "https://github.com/anvayb/priorityvizualizer/blob/main/src/integrations/supabase/client.ts"
            SupTypes["Supabase Types\n(src/integrations/supabase/types.ts)"]:::data
            click SupTypes "https://github.com/anvayb/priorityvizualizer/blob/main/src/integrations/supabase/types.ts"
        end
        subgraph "Utilities"
            direction TB
            Utils["JSON Export/Import Utils\n(src/lib/utils.ts)"]:::infra
            click Utils "https://github.com/anvayb/priorityvizualizer/blob/main/src/lib/utils.ts"
            DomainTypes["Domain Types\n(src/types/priorities.ts)"]:::infra
            click DomainTypes "https://github.com/anvayb/priorityvizualizer/blob/main/src/types/priorities.ts"
        end
    end

    subgraph "Netlify CDN / Hosting"
        direction TB
        NetlifyConf["netlify.toml"]:::infra
        click NetlifyConf "https://github.com/anvayb/priorityvizualizer/blob/main/netlify.toml"
        MakefileNode["Makefile"]:::infra
        click MakefileNode "https://github.com/anvayb/priorityvizualizer/tree/main/Makefile"
        ViteConfig["Vite Config\n(vite.config.ts)"]:::infra
        click ViteConfig "https://github.com/anvayb/priorityvizualizer/blob/main/vite.config.ts"
        TailwindConfig["TailwindCSS Config\n(tailwind.config.ts)"]:::infra
        click TailwindConfig "https://github.com/anvayb/priorityvizualizer/blob/main/tailwind.config.ts"
        PostCSS["PostCSS Config\n(postcss.config.js)"]:::infra
        click PostCSS "https://github.com/anvayb/priorityvizualizer/blob/main/postcss.config.js"
        ESLint["ESLint Config\n(eslint.config.js)"]:::infra
        click ESLint "https://github.com/anvayb/priorityvizualizer/blob/main/eslint.config.js"
    end

    subgraph "Supabase Service"
        direction TB
        SupConfig["Supabase CLI Config\n(supabase/config.toml)"]:::data
        click SupConfig "https://github.com/anvayb/priorityvizualizer/blob/main/supabase/config.toml"
        Migrations["Database Migrations\n(supabase/migrations/)"]:::data
        click Migrations "https://github.com/anvayb/priorityvizualizer/tree/main/supabase/migrations"
        AuthMod["Auth Module"]:::data
        DB["PostgreSQL DB"]:::data
    end

    subgraph "Local File Storage (JSON)"
        direction TB
        PublicJSON["Static Guest Data\n(public/guest_data.json)"]:::infra
        click PublicJSON "https://github.com/anvayb/priorityvizualizer/blob/main/public/guest_data.json"
    end

    %% Data Flows
    Entry -->|"renders"| App
    App -->|"uses"| UI_Prim
    App -->|"loads pages"| Auth
    App -->|"loads pages"| Index
    App -->|"loads pages"| NotFound

    Auth -->|"triggers"| SupClient
    Index -->|"calls"| SupClient
    CC -->|"updates"| SupClient
    PC -->|"updates"| SupClient
    PF -->|"submits"| SupClient

    SupClient -->|"HTTP/gRPC"| AuthMod
    SupClient -->|"HTTP/gRPC"| DB
    SupClient -->|"uses types"| SupTypes

    CC -->|"reads"| MobileHook
    HI -->|"reads"| MobileHook
    UI_Prim -->|"triggers"| ToastHook

    PF -->|"validates"| DomainTypes

    Utils -->|"exports state"| LocalFS[/"User File System"/]
    Utils -->|"imports"| App

    Index -->|"exports JSON"| Utils
    Auth -->|"can import JSON"| Utils

    PublicJSON -->|"preload data"| App

    %% Infra Flows
    ViteConfig -->|"build config"| NetlifyCDN[("Netlify CDN")]
    TailwindConfig -->|"style config"| ViteConfig
    PostCSS -->|"postcss"| ViteConfig
    ESLint -->|"linting"| Entry
    MakefileNode -->|"scripts"| ViteConfig
    MakefileNode -->|"scripts"| SupConfig

    NetlifyCDN -->|"serves static"| Entry

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366d6,stroke-width:1px
    classDef state fill:#FFF4D6,stroke:#d69e2e,stroke-width:1px
    classDef data fill:#DFFFE0,stroke:#2e8a3e,stroke-width:1px
    classDef infra fill:#F0E0FF,stroke:#6f42c1,stroke-width:1px
```
