# sutharjay1/reactui-email architecture

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

- Interactive diagram: https://gitdiagram.com/sutharjay1/reactui-email
- Repository: https://github.com/sutharjay1/reactui-email

## Overview

##### Main System Components

a) Application Layer (Top Level)
- Next.js Application (indicated by next.config.ts and src/app structure)
- Component Documentation System (src/app/docs)
- Template Preview System (various template routes like /apple, /framer, etc.)

b) Core Components Layer
- UI Component Library (src/components/ui)
- Email Templates (src/email)
- Features Module (src/features)

**┌─ Application Layer ─────────────────────┐**
- Next.js Frontend                        │
- Documentation Routes                │
- Template Preview Routes             │
- Global Styles (Tailwind CSS)        │

- Component Layer ──────────────────────┤
- UI Components                      │
- (All Atomic Components)        │
- Email Components                   │
- Templates                      │
- Layout Components              │

- Features Layer ───────────────────────┤
- Email Sending System               │
- Global Features                    │
- Hooks                              │
- Utilities                          │

- ┘

##### Important Relationships

- Template components → Email sending system
- UI components → Template components
- Hooks → Components that use them
- Global features → Application-wide services

##### Technical Details to Highlight

Key technical implementations:
- Email HTML conversion process (src/features/lib/email-to-html.tsx)
- Component registry system
- Theme management
- Query handling (src/features/providers/query-provider.tsx)

##### Additional Notes

Annotations for:
- Build process flow
- Template customization points
- Tailwind CSS integration points
- React Email integration

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Application
        NextApp["Next.js Application"]
        DocSystem["Documentation System"]
        PreviewSystem["Template Preview System"]
        GlobalStyles["Global Styles (Tailwind)"]
    end

    subgraph Components
        UILib["UI Component Library"]
        EmailComp["Email Components"]
        Templates["Email Templates"]
        LayoutComp["Template Layout System"]
    end

    subgraph Features
        EmailSend["Email Sending System"]
        GlobalFeat["Global Features"]
        Hooks["Hooks System"]
        ThemeManager["Theme Management"]
        QueryHandler["Query Handling"]
        HTMLConvert["Email HTML Conversion"]
        CompRegistry["Component Registry"]
    end

    subgraph BrandTemplates
        Apple["Apple Template"]
        Framer["Framer Template"]
        Peerlist["Peerlist Template"]
        Substack["Substack Template"]
    end

    %% Relationships
    NextApp --> DocSystem
    NextApp --> PreviewSystem
    NextApp --> GlobalStyles
    
    UILib --> EmailComp
    EmailComp --> Templates
    Templates --> LayoutComp
    
    Templates --> EmailSend
    GlobalFeat --> NextApp
    Hooks --> EmailComp
    ThemeManager --> NextApp
    QueryHandler --> NextApp
    HTMLConvert --> EmailSend
    CompRegistry --> Templates

    Templates --> BrandTemplates
    BrandTemplates --> Apple
    BrandTemplates --> Framer
    BrandTemplates --> Peerlist
    BrandTemplates --> Substack

    %% Click Events
    click NextApp "https://github.com/sutharjay1/reactui-email/blob/main/src/app/layout.tsx"
    click DocSystem "https://github.com/sutharjay1/reactui-email/tree/main/src/app/docs"
    click PreviewSystem "https://github.com/sutharjay1/reactui-email/tree/main/src/app/apple"
    click UILib "https://github.com/sutharjay1/reactui-email/tree/main/src/components/ui"
    click EmailComp "https://github.com/sutharjay1/reactui-email/tree/main/src/email/components"
    click Templates "https://github.com/sutharjay1/reactui-email/tree/main/src/email"
    click EmailSend "https://github.com/sutharjay1/reactui-email/tree/main/src/features/email/send"
    click GlobalFeat "https://github.com/sutharjay1/reactui-email/tree/main/src/features/global"
    click Hooks "https://github.com/sutharjay1/reactui-email/tree/main/src/features/hooks"
    click ThemeManager "https://github.com/sutharjay1/reactui-email/blob/main/src/features/global/theme-provider.tsx"
    click QueryHandler "https://github.com/sutharjay1/reactui-email/blob/main/src/features/providers/query-provider.tsx"
    click HTMLConvert "https://github.com/sutharjay1/reactui-email/blob/main/src/features/lib/email-to-html.tsx"
    click CompRegistry "https://github.com/sutharjay1/reactui-email/blob/main/src/features/lib/component.ts"
    click LayoutComp "https://github.com/sutharjay1/reactui-email/blob/main/src/features/global/template-layout.tsx"
    click GlobalStyles "https://github.com/sutharjay1/reactui-email/blob/main/src/app/globals.css"
    click Apple "https://github.com/sutharjay1/reactui-email/tree/main/src/email/apple"
    click Framer "https://github.com/sutharjay1/reactui-email/tree/main/src/email/framer"
    click Peerlist "https://github.com/sutharjay1/reactui-email/tree/main/src/email/peerlist"
    click Substack "https://github.com/sutharjay1/reactui-email/tree/main/src/email/substack"

    %% Styling
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px
    classDef application fill:#dbeafe,stroke:#333
    classDef component fill:#bbf7d0,stroke:#333
    classDef feature fill:#fef9c3,stroke:#333
    classDef template fill:#fecaca,stroke:#333

    class NextApp,DocSystem,PreviewSystem,GlobalStyles application
    class UILib,EmailComp,Templates,LayoutComp component
    class EmailSend,GlobalFeat,Hooks,ThemeManager,QueryHandler,HTMLConvert,CompRegistry feature
    class Apple,Framer,Peerlist,Substack template
```
