# realmikkifriend/ist architecture

> Architecture diagram of the GitHub repository realmikkifriend/ist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/realmikkifriend/ist
- Repository: https://github.com/realmikkifriend/ist

## Overview

##### Main Components Identification

The system should be represented with these key components:

a. Frontend Application (Svelte-based)
- User Interface Layer
- Authentication Layer
- Task Management Layer
- Dynalist Integration Layer

b. External Services
- Todoist API Integration
- Dynalist API Integration

##### Component Relationships

- Authentication flow (Auth.svelte → OAuth → External Services)
- Task data flow (API → Stores → Components)
- User interaction flow (Components → Task Handlers → API)

##### Specific Implementation Details

a. Frontend Architecture:
**User Interface**
- ↓
**State Management (stores.js)**
- ↓
**API Layer (api.js)**
- ↓
**External Services**

b. Task Processing Pipeline:
**Todoist API → Process Layer (process.js) → Task Handlers → UI Components**

c. Dynalist Integration:
**Comments → Dynalist Parser → Interactive Checklist**

##### Technical Stack Representation

A tech stack section showing:
- Svelte (Frontend Framework)
- Tailwind CSS (Styling)
- Vite (Build Tool)
- External APIs (Todoist, Dynalist)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        App["App"]:::core
        Auth["Authentication"]:::auth
        Task["Task Management"]:::core
        Agenda["Agenda View"]:::core
        Sidebar["Sidebar"]:::core
        DeferModal["Defer Modal"]:::core
        DatePicker["Date Picker"]:::core
        TimePicker["Time Picker"]:::core
        Contexts["Contexts"]:::core
        ContextReorder["Context Reorder"]:::core
    end

    subgraph "State Management"
        Stores["Stores"]:::state
    end

    subgraph "Task Processing"
        Process["Process Layer"]:::process
        Filter["Filter"]:::process
        First["First Task"]:::process
        TaskHandlers["Task Handlers"]:::process
    end

    subgraph "Dynalist Integration"
        DynalistAuth["Dynalist Auth"]:::dynalist
        DynalistChecklist["Dynalist Checklist"]:::dynalist
        DynalistJS["Dynalist JS"]:::dynalist
    end

    subgraph "API Layer"
        API["API Integration"]:::api
    end

    subgraph "External Services"
        TodoistAPI["Todoist API"]:::external
        DynalistAPI["Dynalist API"]:::external
    end

    %% Relationships
    App --> Auth
    App --> Task
    App --> Agenda
    App --> Sidebar
    
    Sidebar --> Contexts
    Contexts --> ContextReorder
    
    Task --> DeferModal
    DeferModal --> DatePicker
    DeferModal --> TimePicker
    
    Auth --> API
    Task --> TaskHandlers
    TaskHandlers --> Process
    Process --> Filter
    Process --> First
    
    API --> TodoistAPI
    API --> DynalistAPI
    
    Task --> DynalistChecklist
    DynalistChecklist --> DynalistAuth
    DynalistAuth --> DynalistJS
    DynalistJS --> DynalistAPI
    
    Stores --> App
    Stores --> Task
    Stores --> Agenda
    Stores --> Sidebar
    
    API --> Stores

    %% Click Events
    click Auth "https://github.com/realmikkifriend/ist/blob/main/src/html/Auth.svelte"
    click Task "https://github.com/realmikkifriend/ist/blob/main/src/html/task/Task.svelte"
    click Agenda "https://github.com/realmikkifriend/ist/blob/main/src/html/agenda/Agenda.svelte"
    click Sidebar "https://github.com/realmikkifriend/ist/blob/main/src/html/sidebar/Sidebar.svelte"
    click DeferModal "https://github.com/realmikkifriend/ist/blob/main/src/html/defer/DeferModal.svelte"
    click DatePicker "https://github.com/realmikkifriend/ist/blob/main/src/html/defer/DatePicker.svelte"
    click TimePicker "https://github.com/realmikkifriend/ist/blob/main/src/html/defer/TimePicker.svelte"
    click Contexts "https://github.com/realmikkifriend/ist/blob/main/src/html/sidebar/Contexts.svelte"
    click ContextReorder "https://github.com/realmikkifriend/ist/blob/main/src/html/sidebar/ContextReorderModal.svelte"
    click Stores "https://github.com/realmikkifriend/ist/blob/main/src/js/stores.js"
    click Process "https://github.com/realmikkifriend/ist/blob/main/src/js/process.js"
    click Filter "https://github.com/realmikkifriend/ist/blob/main/src/js/filter.js"
    click First "https://github.com/realmikkifriend/ist/blob/main/src/js/first.js"
    click TaskHandlers "https://github.com/realmikkifriend/ist/blob/main/src/js/taskHandlers.js"
    click DynalistAuth "https://github.com/realmikkifriend/ist/blob/main/src/html/task/dynalist/DynalistAuthRequest.svelte"
    click DynalistChecklist "https://github.com/realmikkifriend/ist/blob/main/src/html/task/dynalist/DynalistChecklist.svelte"
    click DynalistJS "https://github.com/realmikkifriend/ist/blob/main/src/html/task/dynalist/dynalist.js"
    click API "https://github.com/realmikkifriend/ist/blob/main/src/js/api.js"
    click App "https://github.com/realmikkifriend/ist/blob/main/src/html/App.svelte"

    %% Styles
    classDef core fill:#3498db,stroke:#2980b9,color:white
    classDef auth fill:#e67e22,stroke:#d35400,color:white
    classDef state fill:#9b59b6,stroke:#8e44ad,color:white
    classDef process fill:#1abc9c,stroke:#16a085,color:white
    classDef api fill:#34495e,stroke:#2c3e50,color:white
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef dynalist fill:#e74c3c,stroke:#c0392b,color:white
```
