# meragi-celebrations/flutter_meragi_design architecture

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

- Interactive diagram: https://gitdiagram.com/meragi-celebrations/flutter_meragi_design
- Repository: https://github.com/meragi-celebrations/flutter_meragi_design

## Overview

##### Main Components Identification

a) Core UI Component Layer
- Components logically:
- Basic Elements (Button, Card, Typography)
- Form Elements (Fields directory)
- Layout Components (AppBar, Scaffold, NavigationRail)
- Complex Components (Carousel, Editor, Modal)

b) Theme System Layer
- Theme management structure (/lib/src/theme)
- Connections to:
- Theme Tokens
- Style Definitions
- Theme Data

c) CRUD Operations Layer
- CRUD system (/lib/src/crud)
- Include:
- Request Handling
- Caching Mechanism
- Repository Pattern

d) Utilities Layer
- Support utilities (/lib/src/utils)
- Utilities like:
- Platform Detection
- State Management
- Currency Handling

##### Component Relationships

**[Theme System Layer]**
- ↓
**[Core UI Component Layer] ← [Utilities Layer]**
- ↓
**[CRUD Operations Layer]**

##### Implementation Details

For each major component, include:
- Component name
- Key responsibilities
- Dependencies
- Configuration options

Example for the Editor component:
**[Editor Component]**
- Handlers
- User Mention
- Inline Actions
- Editor Core

##### Cross-Platform Support

A section showing platform-specific implementations:
- Android
- iOS
- Web
- Desktop (Windows, macOS, Linux)

##### Integration Points

Integration points for:
- JSON Widget System
- Form Building System
- Theme Customization
- CRUD Operations

Key Considerations:
##### Version compatibility information

Remember to include a note about the JSON-driven UI capability, as this appears to be a significant feature based on the /src/components/json directory structure.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef theme fill:#90EE90,stroke:#333,stroke-width:2px
    classDef component fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef crud fill:#FFA07A,stroke:#333,stroke-width:2px
    classDef utils fill:#D3D3D3,stroke:#333,stroke-width:2px
    
    %% Theme System Layer
    subgraph ThemeSystem["Theme System"]
        ThemeManagement["Theme Management"]
        ThemeTokens["Theme Tokens"]
        StyleDefs["Style Definitions"]
        ThemeData["Theme Data"]
    end
    
    %% Core UI Component Layer
    subgraph CoreUI["Core UI Components"]
        subgraph BasicElements["Basic Elements"]
            Button["Button"]
            Card["Card"]
            Typography["Typography"]
        end
        
        subgraph FormElements["Form Elements"]
            Fields["Form Fields"]
        end
        
        subgraph LayoutComponents["Layout Components"]
            Layout["Layout System"]
        end
        
        subgraph ComplexComponents["Complex Components"]
            Carousel["Carousel"]
            Modal["Modal"]
            
            subgraph EditorSystem["Editor System"]
                Editor["Editor Core"]
                UserMention["User Mention Handler"]
                InlineActions["Inline Actions"]
            end
        end
        
        subgraph JSONSystem["JSON Widget System"]
            JSONInterface["JSON Interface"]
            JSONDataManager["Data Manager"]
            JSONWidgetMap["Widget Mapping"]
        end
    end
    
    %% CRUD Operations Layer
    subgraph CRUDSystem["CRUD Operations"]
        RequestHandling["Request Handling"]
        CacheMechanism["Cache Mechanism"]
        Repository["Repository Pattern"]
    end
    
    %% Utilities Layer
    subgraph Utils["Utilities"]
        Platform["Platform Detection"]
        StateManagement["State Management"]
        Currency["Currency Handling"]
    end
    
    %% Relationships
    ThemeSystem --> CoreUI
    Utils --> CoreUI
    CoreUI --> CRUDSystem
    
    %% Component Relationships
    Editor --> UserMention
    Editor --> InlineActions
    
    %% Click Events
    click ThemeManagement "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/theme/theme.dart"
    click ThemeTokens "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/theme/theme_tokens.dart"
    click StyleDefs "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/theme/style.dart"
    click ThemeData "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/theme/theme_data.dart"
    click Button "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/button.dart"
    click Card "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/card.dart"
    click Typography "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/typography.dart"
    click Fields "https://github.com/meragi-celebrations/flutter_meragi_design/tree/main/lib/src/components/fields/"
    click Layout "https://github.com/meragi-celebrations/flutter_meragi_design/tree/main/lib/src/components/layout/"
    click Carousel "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/carousel.dart"
    click Modal "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/modal.dart"
    click Editor "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/fields/editor/editor.dart"
    click UserMention "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/fields/editor/handlers/user_mention.dart"
    click InlineActions "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/fields/editor/inline_actions_command.dart"
    click RequestHandling "https://github.com/meragi-celebrations/flutter_meragi_design/tree/main/lib/src/crud/request/"
    click CacheMechanism "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/crud/request/cache.dart"
    click Repository "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/crud/request/repo.dart"
    click Platform "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/utils/platform.dart"
    click StateManagement "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/utils/widget_state.dart"
    click Currency "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/utils/currency.dart"
    click JSONInterface "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/json/json_interface.dart"
    click JSONDataManager "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/json/json_data_manager.dart"
    click JSONWidgetMap "https://github.com/meragi-celebrations/flutter_meragi_design/blob/main/lib/src/components/json/json_widget_map.dart"
    
    %% Style Applications
    class ThemeManagement,ThemeTokens,StyleDefs,ThemeData theme
    class Button,Card,Typography,Fields,Layout,Carousel,Modal,Editor,UserMention,InlineActions,JSONInterface,JSONDataManager,JSONWidgetMap component
    class RequestHandling,CacheMechanism,Repository crud
    class Platform,StateManagement,Currency utils
```
