# module-federation/vite architecture

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

- Interactive diagram: https://gitdiagram.com/module-federation/vite
- Repository: https://github.com/module-federation/vite

## Overview

##### Main Components

a) Core Plugin Components:
- Plugin System (Central Hub)
- Module Federation Manager
- Virtual Module System
- Plugin Processors
- Remote Entry Handler
- Shared Module Manager

b) Integration Points:
- Vite Build Pipeline
- Module Federation Runtime
- Remote Entry Points
- Host Applications
- Remote Applications

**┌─────────────────────────────────────────────────────────────┐**
- Module Federation Plugin                 │
- ┬───────────────────┬──────────────────┤
- Plugin System     │  Virtual Modules   │   Utils Layer    │
- ┌───────────────┐  │ ┌───────────────┐  │ ┌──────────────┐ │
- Federation Core│  │ │Remote Entry   │  │ │Promise Store │ │
- Plugin Manager │  │ │Shared Modules │  │ │Package Utils │ │
- Config Normal. │  │ │Exposes Handler│  │ │Module Normal.│ │
- ┘  │ └───────────────┘  │ └──────────────┘ │
- ┤
- Integration Layer                        │
- ┬───────────────────┬──────────────────┤
- Vite Build Hook   │  Remote Loading   │  Shared Module   │
- Integration     │    Management     │    Resolution    │
- ┴───────────────────┴──────────────────┘

##### Key Relationships

a) Data Flow:
- Host → Remote Entry Points
- Plugin → Vite Build Pipeline
- Virtual Modules → Runtime Loading
- Shared Modules → Multiple Applications

b) Dependencies:
- Plugin → Vite
- Remote Apps → Host Apps
- Shared Modules → All Apps

##### Implementation Details to Highlight

- Plugin Architecture:
- Plugin system's modular structure (/src/plugins/)
- Virtual module generation (/src/virtualModules/)
- Utility services integration (/src/utils/)

- Integration Points:
- Demonstrate how different bundlers can work together (Vite, Webpack, Rspack)
- Support for multiple frameworks (Vue, React, Svelte, etc.)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph MFP["Module Federation Plugin"]
        subgraph PS["Plugin System"]
            PC["Federation Core"]:::core
            PM["Plugin Manager"]:::core
            CN["Config Normalizer"]:::core
        end

        subgraph VMS["Virtual Module System"]
            RE["Remote Entry"]:::virtual
            SM["Shared Modules"]:::virtual
            EH["Exposes Handler"]:::virtual
            RMH["Remote Module Handler"]:::virtual
        end

        subgraph UL["Utils Layer"]
            PS1["Promise Store"]:::util
            PU["Package Utils"]:::util
            MN["Module Normalizer"]:::util
            VMU["Virtual Module Utils"]:::util
        end
    end

    subgraph IL["Integration Layer"]
        VB["Vite Build Hook"]:::integration
        RL["Remote Loading"]:::integration
        SR["Shared Module Resolution"]:::integration
    end

    subgraph Examples["Integration Examples"]
        VV["Vite-to-Vite"]:::example
        VW["Vite-to-Webpack"]:::example
        NI["Nuxt Integration"]:::example
    end

    %% Relationships
    PC --> PM
    PM --> CN
    CN --> VMS
    RE --> RL
    SM --> SR
    EH --> RL
    RMH --> RL
    PS1 --> RL
    PU --> CN
    MN --> CN
    VMU --> VMS
    VB --> IL
    RL --> IL
    SR --> IL
    IL --> Examples

    %% Click Events
    click PC "https://github.com/module-federation/vite/tree/main/src/plugins/"
    click PM "https://github.com/module-federation/vite/blob/main/src/plugins/pluginMFManifest.ts"
    click RE "https://github.com/module-federation/vite/blob/main/src/virtualModules/virtualRemoteEntry.ts"
    click SM "https://github.com/module-federation/vite/blob/main/src/virtualModules/virtualShared_preBuild.ts"
    click EH "https://github.com/module-federation/vite/blob/main/src/virtualModules/virtualExposes.ts"
    click RMH "https://github.com/module-federation/vite/blob/main/src/virtualModules/virtualRemotes.ts"
    click PS1 "https://github.com/module-federation/vite/blob/main/src/utils/PromiseStore.ts"
    click PU "https://github.com/module-federation/vite/blob/main/src/utils/packageNameUtils.ts"
    click MN "https://github.com/module-federation/vite/blob/main/src/utils/normalizeModuleFederationOptions.ts"
    click VMU "https://github.com/module-federation/vite/blob/main/src/utils/VirtualModule.ts"
    click VV "https://github.com/module-federation/vite/tree/main/examples/vite-vite/"
    click VW "https://github.com/module-federation/vite/tree/main/examples/vite-webpack-rspack/"
    click NI "https://github.com/module-federation/vite/tree/main/examples/nuxt-vite/"

    %% Styling
    classDef core fill:#2196F3,stroke:#1565C0,color:white
    classDef virtual fill:#FF9800,stroke:#F57C00,color:white
    classDef util fill:#9C27B0,stroke:#7B1FA2,color:white
    classDef integration fill:#4CAF50,stroke:#388E3C,color:white
    classDef example fill:#795548,stroke:#5D4037,color:white

    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["Virtual Modules"]:::virtual
        L3["Utility Services"]:::util
        L4["Integration Points"]:::integration
        L5["Examples"]:::example
    end
```
