# karthikmudunuri/eldoraui architecture

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

- Interactive diagram: https://gitdiagram.com/karthikmudunuri/eldoraui
- Repository: https://github.com/karthikmudunuri/eldoraui

## Overview

##### Main Components Structure

a) Frontend Application Layer
- Next.js application structure with routes (/app directory)
- Marketing pages
- Documentation pages
- Component showcase

b) Core Component Library
- UI Components collection
- Animation system integration
- Theme system

c) Development & Build Infrastructure
- CLI tools
- Registry system
- Build pipeline

##### Key Relationships to Highlight

**[Website Layer]**
- ↓
**[Component Registry] ←→ [Core Components]**
- ↓
**[Build System] ←→ [CLI Tools]**

##### Specific Implementation Details

- Blue: Core UI components (/components/ui/*)
- Green: Animation components (Framer Motion integration)
- Purple: Documentation system
- Orange: Build & deployment infrastructure

##### Component Architecture Details

Key aspects:
**[Core Components]**
- ↓
**[Animation Layer (Framer Motion)]**
- ↓
**[Styling Layer (Tailwind CSS)]**
- ↓
**[React/TypeScript Foundation]**

##### Registry System Architecture

Registry system:
**[Registry]**
- Styles
- Themes
- Components
- Examples

##### Important Elements

- Component documentation flow
- Theme system integration
- Build pipeline
- CLI tooling integration
- Package distribution system

##### Technical Stack Indicators

- React/Next.js
- TypeScript
- Tailwind CSS
- Framer Motion
- MDX documentation

##### Development Workflow

Flow from:
**[Local Development] → [Component Creation] → [Registry Integration] → [Documentation] → [Distribution]**

Key Considerations:
- Keep the main component architecture at the center
- Clear separation between the website and the component library
- Registry system as it's central to the project
- CLI tooling integration points
- Documentation flow and integration

Remember to include:
- Version control integration
- Build process flow
- Documentation generation system
- Component showcase integration
- Theme system architecture

This will provide a comprehensive view of how Eldora UI works as both a component library and a documentation website.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Website
        Marketing["Marketing Pages"]
        Docs["Documentation System"]
        Showcase["Component Showcase"]
    end

    subgraph CoreLibrary["Core Component Library"]
        Components["Core UI Components"]
        Animations["Animation System"]
        ThemeSystem["Theme System"]
        StyleSystem["Style System"]
    end

    subgraph Infrastructure["Development & Build Infrastructure"]
        CLI["CLI Tools"]
        Registry["Registry System"]
        BuildSystem["Build System"]
        DevUtils["Development Utilities"]
    end

    subgraph Documentation["Documentation Layer"]
        CompDocs["Component Documentation"]
        InstallGuides["Installation Guides"]
        CompDemos["Component Demos"]
    end

    Marketing --> Registry
    Docs --> Registry
    Showcase --> Registry
    
    Registry --> Components
    Registry --> Animations
    Registry --> ThemeSystem
    Registry --> StyleSystem
    
    BuildSystem --> Registry
    CLI --> Registry
    DevUtils --> BuildSystem
    
    Components --> Documentation
    CompDemos --> Documentation
    
    %% Component Mappings
    click Docs "https://github.com/karthikmudunuri/eldoraui/tree/main/app/(docs)/docs"
    click Marketing "https://github.com/karthikmudunuri/eldoraui/tree/main/app/(marketing)"
    click Components "https://github.com/karthikmudunuri/eldoraui/tree/main/components/ui"
    click Animations "https://github.com/karthikmudunuri/eldoraui/tree/main/registry/default/eldoraui"
    click ThemeSystem "https://github.com/karthikmudunuri/eldoraui/tree/main/public/registry/themes"
    click CLI "https://github.com/karthikmudunuri/eldoraui/tree/main/packages/cli"
    click Registry "https://github.com/karthikmudunuri/eldoraui/tree/main/__registry__"
    click CompDocs "https://github.com/karthikmudunuri/eldoraui/tree/main/content/docs/components"
    click BuildSystem "https://github.com/karthikmudunuri/eldoraui/blob/main/scripts/build-registry.mts"
    click InstallGuides "https://github.com/karthikmudunuri/eldoraui/tree/main/content/docs/installation"
    click CompDemos "https://github.com/karthikmudunuri/eldoraui/tree/main/registry/default/demos"
    click DevUtils "https://github.com/karthikmudunuri/eldoraui/tree/main/lib"
    click StyleSystem "https://github.com/karthikmudunuri/eldoraui/tree/main/public/registry/styles"

    %% Styling
    classDef website fill:#e1f5fe,stroke:#01579b
    classDef core fill:#e8f5e9,stroke:#1b5e20
    classDef infra fill:#fff3e0,stroke:#e65100
    classDef docs fill:#f3e5f5,stroke:#4a148c

    class Marketing,Docs,Showcase website
    class Components,Animations,ThemeSystem,StyleSystem core
    class CLI,Registry,BuildSystem,DevUtils infra
    class CompDocs,InstallGuides,CompDemos docs

    %% Legend
    subgraph Legend
        WebsiteL["Website Layer"]:::website
        CoreL["Core Library"]:::core
        InfraL["Infrastructure"]:::infra
        DocsL["Documentation"]:::docs
    end
```
