# dannycancode/ezzytracker architecture

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

- Interactive diagram: https://gitdiagram.com/dannycancode/ezzytracker
- Repository: https://github.com/dannycancode/ezzytracker

## Overview

##### Project Type and Purpose
- EzzyTracker is a React + TypeScript SPA bundled with Vite, styled with Tailwind CSS.
- It provides task management (Pomodoro timer, tags, priorities, due dates, stats) entirely in the browser, with persistent state in localStorage and desktop notifications via the Web Notification API.
- There is one external link/integration (EzzyFit).

##### File Structure
- Top-level configs (eslint.config.js, tsconfig*.json, tailwind.config.js, postcss.config.js, vite.config.ts) indicate a modern front-end toolchain.
- index.html, index–*.js, index-*.css are build outputs.
- No “backend” or “api” directory → frontend-only.

##### Core Components
a. Development Environment
– IDE/Code (src/ directory implied)
– Vite development server (npm run dev)
– Build pipeline (Vite → output: index.html + CSS + JS)

b. Hosting & Deployment
– Static host / CDN (e.g., Netlify) serving the built assets

c. Browser Runtime
– React Application (UI layer)
– Tailwind CSS (styling)
– State Management (React state/hooks)
– Persistence Layer (window.localStorage)
– Browser APIs:
- Notification API for Pomodoro alerts
- Responsive layout (CSS + media queries)

d. External Service
– EzzyFit (external link/integration)

##### Relationships & Data Flow
- Developer → commits to GitHub → CI/CD → deploys to Netlify
- Client’s browser requests index.html, CSS, JS from CDN
- React app boots in browser → reads/writes localStorage
- User interacts with UI → React state updates → persisted in localStorage
- Pomodoro timer expiry → triggers Notification API
- “EzzyFit” link → opens external EzzyFit app in new tab

##### Architectural Patterns & Design Principles
- SPA (Client-side rendering)
- Static hosting (no server-side logic)
- Unidirectional data flow (React hooks/state → view → events → state)
- Progressive enhancement (works offline, localStorage)
- Modular CSS (Tailwind utility classes)

##### Technologies & Frameworks to Call Out
- React (component architecture)
- TypeScript (type safety)
- Vite (ESM dev server + build)
- Tailwind CSS (utility-first styling)
- Browser APIs: localStorage, Notifications
- Netlify (static hosting / CDN)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Development & Build Pipeline
    subgraph "Development & Build"
        GitHub[(GitHub Repo)]:::dev
        IDE["IDE/Code (src/)"]:::dev
        ViteDev["Vite Dev Server & Build Pipeline"]:::dev
        TSConfig["TypeScript Configs"]:::dev
        ESLint["ESLint Config"]:::dev
        TailwindConfig["Tailwind & PostCSS Configs"]:::dev
        Package["package.json & package-lock.json"]:::dev
    end

    GitHub --> ViteDev
    IDE --> ViteDev
    TSConfig --> ViteDev
    ESLint --> ViteDev
    TailwindConfig --> ViteDev
    Package --> ViteDev

    %% Built Assets
    subgraph "Built Assets (dist)"
        HTML["index.html"]:::dev
        JS["index--P0nWqFU.js"]:::dev
        CSS["index-BgbulVla.css"]:::dev
    end

    ViteDev --> HTML
    ViteDev --> JS
    ViteDev --> CSS

    %% Hosting & CDN
    subgraph "Hosting & CDN"
        Netlify["Netlify CDN"]:::host
    end

    HTML --> Netlify
    JS --> Netlify
    CSS --> Netlify

    %% Browser Runtime
    subgraph "Browser Runtime"
        ReactApp["React SPA"]:::browser
        Tailwind["Tailwind CSS"]:::browser
        Lucide["Lucide Icons"]:::browser
        State["React State/Hooks"]:::browser
        LocalStorage["localStorage"]:::browser
        Timer["Pomodoro Timer Logic"]:::browser
        Notification["Notification API"]:::browser
        EzzyFit["EzzyFit Integration"]:::external
    end

    Netlify --> ReactApp
    ReactApp --> Tailwind
    ReactApp --> Lucide
    ReactApp --> State
    State --> LocalStorage
    ReactApp --> Timer
    Timer --> Notification
    ReactApp --> EzzyFit

    %% Click Events
    click ViteDev "https://github.com/dannycancode/ezzytracker/blob/main/vite.config.ts"
    click TSConfig "https://github.com/dannycancode/ezzytracker/blob/main/tsconfig.json"
    click TSConfig "https://github.com/dannycancode/ezzytracker/blob/main/tsconfig.app.json"
    click TSConfig "https://github.com/dannycancode/ezzytracker/blob/main/tsconfig.node.json"
    click TailwindConfig "https://github.com/dannycancode/ezzytracker/blob/main/tailwind.config.js"
    click TailwindConfig "https://github.com/dannycancode/ezzytracker/blob/main/postcss.config.js"
    click ESLint "https://github.com/dannycancode/ezzytracker/blob/main/eslint.config.js"
    click Package "https://github.com/dannycancode/ezzytracker/blob/main/package.json"
    click Package "https://github.com/dannycancode/ezzytracker/blob/main/package-lock.json"
    click HTML "https://github.com/dannycancode/ezzytracker/blob/main/index.html"
    click JS "https://github.com/dannycancode/ezzytracker/blob/main/index--P0nWqFU.js"
    click CSS "https://github.com/dannycancode/ezzytracker/blob/main/index-BgbulVla.css"
    click ReactApp "https://github.com/dannycancode/ezzytracker/blob/main/index--P0nWqFU.js"
    click EzzyFit "https://github.com/dannycancode/ezzytracker/blob/main/index--P0nWqFU.js"

    %% Styles
    classDef dev fill:#fde2e2,stroke:#d90429,stroke-width:1px
    classDef host fill:#e0f7fa,stroke:#00796b,stroke-width:1px
    classDef browser fill:#fff3e0,stroke:#ef6c00,stroke-width:1px
    classDef external fill:#e8f5e9,stroke:#2e7d32,stroke-width:1px
```
