# builderio/mitosis architecture

> Architecture diagram of the GitHub repository builderio/mitosis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/builderio/mitosis
- Repository: https://github.com/builderio/mitosis

## Overview

Mitosis is a cross-framework component compiler: an engineer invokes the CLI, supplies Mitosis components, the compiler parses them into an intermediate representation, then target generators emit native framework code. The repository also exposes project scaffolding and a Figma-oriented workflow. The graph preserves major documented targets and shows event handling as an internal generation layer. Several orchestration links are inferred from the documented compiler structure; unsampled implementation details and test applications are intentionally omitted.

Main entry points: [`packages/core/src/flow.ts`](https://github.com/builderio/mitosis/blob/main/packages/core/src/flow.ts) (Compiler flow), [`packages/core/src/types/mitosis-component.ts`](https://github.com/builderio/mitosis/blob/main/packages/core/src/types/mitosis-component.ts) (Mitosis IR), [`packages/cli/src/cli.ts`](https://github.com/builderio/mitosis/blob/main/packages/cli/src/cli.ts) (Mitosis CLI), [`packages/core/src/generators/qwik/index.ts`](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/qwik/index.ts) (Qwik generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entrypoints"]
  node_cli["Mitosis CLI<br/>[cli.ts]"]
  node_compile["Compile command<br/>[compile.ts]"]
  node_build["Build command<br/>[build.ts]"]
  node_new_project["Project scaffolder<br/>[new.ts]"]
end

subgraph group_model["Core compiler"]
  node_jsx_parser["JSX parser<br/>[index.ts]"]
  node_svelte_parser["Svelte parser<br/>[index.ts]"]
  node_ir["Mitosis IR"]
  node_flow["Compiler flow<br/>[flow.ts]"]
  node_plugins["Compiler plugins<br/>[plugins.ts]"]
  node_events["Event normalization<br/>[event-handlers.ts]"]
end

subgraph group_targets["Target generators"]
  node_react["React generator<br/>[index.ts]"]
  node_vue["Vue generator<br/>[index.ts]"]
  node_angular["Angular generator<br/>[index.ts]"]
  node_svelte["Svelte generator<br/>[index.ts]"]
  node_solid["Solid generator<br/>[index.ts]"]
  node_alpine["Alpine generator<br/>[index.ts]"]
  node_qwik["Qwik generator<br/>[index.ts]"]
  node_other_targets["Other generators"]
  node_generated_code["Generated framework code"]
end

subgraph group_integrations["Integrations"]
  node_figma["Figma"]
end

node_developer(("Engineer"))

node_developer -->|"invokes"| node_cli
node_cli -->|"dispatches"| node_compile
node_cli -->|"dispatches"| node_build
node_cli -->|"dispatches"| node_new_project
node_build -->|"runs"| node_compile
node_compile -->|"starts"| node_flow
node_flow -->|"parses"| node_jsx_parser
node_flow -->|"parses"| node_svelte_parser
node_jsx_parser -->|"produces"| node_ir
node_svelte_parser -->|"produces"| node_ir
node_flow -->|"applies"| node_plugins
node_flow -->|"dispatches"| node_react
node_flow -->|"dispatches"| node_vue
node_flow -->|"dispatches"| node_angular
node_flow -->|"dispatches"| node_svelte
node_flow -->|"dispatches"| node_solid
node_flow -->|"dispatches"| node_alpine
node_flow -->|"dispatches"| node_qwik
node_flow -->|"dispatches"| node_other_targets
node_ir -->|"feeds"| node_react
node_ir -->|"feeds"| node_vue
node_ir -->|"feeds"| node_angular
node_ir -->|"feeds"| node_svelte
node_ir -->|"feeds"| node_solid
node_ir -->|"feeds"| node_alpine
node_ir -->|"feeds"| node_qwik
node_ir -->|"feeds"| node_other_targets
node_react -->|"emits"| node_generated_code
node_vue -->|"emits"| node_generated_code
node_angular -->|"emits"| node_generated_code
node_svelte -->|"emits"| node_generated_code
node_solid -->|"emits"| node_generated_code
node_alpine -->|"emits"| node_generated_code
node_qwik -->|"emits"| node_generated_code
node_other_targets -->|"emits"| node_generated_code
node_qwik -->|"normalizes"| node_events
node_figma -.->|"supplies designs"| node_compile

click node_cli "https://github.com/builderio/mitosis/blob/main/packages/cli/src/cli.ts"
click node_compile "https://github.com/builderio/mitosis/blob/main/packages/cli/src/commands/compile.ts"
click node_build "https://github.com/builderio/mitosis/blob/main/packages/cli/src/commands/build.ts"
click node_new_project "https://github.com/builderio/mitosis/blob/main/packages/cli/src/commands/new.ts"
click node_jsx_parser "https://github.com/builderio/mitosis/blob/main/packages/core/src/parsers/jsx/index.ts"
click node_svelte_parser "https://github.com/builderio/mitosis/blob/main/packages/core/src/parsers/svelte/index.ts"
click node_ir "https://github.com/builderio/mitosis/blob/main/packages/core/src/types/mitosis-component.ts"
click node_flow "https://github.com/builderio/mitosis/blob/main/packages/core/src/flow.ts"
click node_plugins "https://github.com/builderio/mitosis/blob/main/packages/core/src/modules/plugins.ts"
click node_events "https://github.com/builderio/mitosis/blob/main/packages/core/src/helpers/event-handlers.ts"
click node_react "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/react/index.ts"
click node_vue "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/vue/index.ts"
click node_angular "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/angular/index.ts"
click node_svelte "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/svelte/index.ts"
click node_solid "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/solid/index.ts"
click node_alpine "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/alpine/index.ts"
click node_qwik "https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/qwik/index.ts"
click node_other_targets "https://github.com/builderio/mitosis/tree/main/packages/core/src/generators"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_compile,node_build,node_new_project toneBlue
class node_jsx_parser,node_svelte_parser,node_ir,node_flow,node_plugins,node_events toneAmber
class node_react,node_vue,node_angular,node_svelte,node_solid,node_alpine,node_qwik,node_other_targets,node_generated_code toneMint
class node_figma toneRose
class node_developer toneIndigo
```

## Components

### CLI entrypoints

- [Mitosis CLI](https://github.com/builderio/mitosis/blob/main/packages/cli/src/cli.ts): `packages/cli/src/cli.ts`
- [Compile command](https://github.com/builderio/mitosis/blob/main/packages/cli/src/commands/compile.ts): `packages/cli/src/commands/compile.ts`
- [Build command](https://github.com/builderio/mitosis/blob/main/packages/cli/src/commands/build.ts): `packages/cli/src/commands/build.ts`
- [Project scaffolder](https://github.com/builderio/mitosis/blob/main/packages/cli/src/commands/new.ts): `packages/cli/src/commands/new.ts`

### Core compiler

- [JSX parser](https://github.com/builderio/mitosis/blob/main/packages/core/src/parsers/jsx/index.ts): `packages/core/src/parsers/jsx/index.ts`
- [Svelte parser](https://github.com/builderio/mitosis/blob/main/packages/core/src/parsers/svelte/index.ts): `packages/core/src/parsers/svelte/index.ts`
- [Mitosis IR](https://github.com/builderio/mitosis/blob/main/packages/core/src/types/mitosis-component.ts): `packages/core/src/types/mitosis-component.ts`
- [Compiler flow](https://github.com/builderio/mitosis/blob/main/packages/core/src/flow.ts): `packages/core/src/flow.ts`
- [Compiler plugins](https://github.com/builderio/mitosis/blob/main/packages/core/src/modules/plugins.ts): `packages/core/src/modules/plugins.ts`
- [Event normalization](https://github.com/builderio/mitosis/blob/main/packages/core/src/helpers/event-handlers.ts): `packages/core/src/helpers/event-handlers.ts`

### Target generators

- [React generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/react/index.ts): `packages/core/src/generators/react/index.ts`
- [Vue generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/vue/index.ts): `packages/core/src/generators/vue/index.ts`
- [Angular generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/angular/index.ts): `packages/core/src/generators/angular/index.ts`
- [Svelte generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/svelte/index.ts): `packages/core/src/generators/svelte/index.ts`
- [Solid generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/solid/index.ts): `packages/core/src/generators/solid/index.ts`
- [Alpine generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/alpine/index.ts): `packages/core/src/generators/alpine/index.ts`
- [Qwik generator](https://github.com/builderio/mitosis/blob/main/packages/core/src/generators/qwik/index.ts): `packages/core/src/generators/qwik/index.ts`
- [Other generators](https://github.com/builderio/mitosis/tree/main/packages/core/src/generators): `packages/core/src/generators`
- **Generated framework code**

### Integrations

- **Figma**

### Other components

- **Engineer**

## Connections

- Engineer → Mitosis CLI: invokes
- Mitosis CLI → Compile command: dispatches
- Mitosis CLI → Build command: dispatches
- Mitosis CLI → Project scaffolder: dispatches
- Build command → Compile command: runs
- Compile command → Compiler flow: starts
- Compiler flow → JSX parser: parses
- Compiler flow → Svelte parser: parses
- JSX parser → Mitosis IR: produces
- Svelte parser → Mitosis IR: produces
- Compiler flow → Compiler plugins: applies
- Compiler flow → React generator: dispatches
- Compiler flow → Vue generator: dispatches
- Compiler flow → Angular generator: dispatches
- Compiler flow → Svelte generator: dispatches
- Compiler flow → Solid generator: dispatches
- Compiler flow → Alpine generator: dispatches
- Compiler flow → Qwik generator: dispatches
- Compiler flow → Other generators: dispatches
- Mitosis IR → React generator: feeds
- Mitosis IR → Vue generator: feeds
- Mitosis IR → Angular generator: feeds
- Mitosis IR → Svelte generator: feeds
- Mitosis IR → Solid generator: feeds
- Mitosis IR → Alpine generator: feeds
- Mitosis IR → Qwik generator: feeds
- Mitosis IR → Other generators: feeds
- React generator → Generated framework code: emits
- Vue generator → Generated framework code: emits
- Angular generator → Generated framework code: emits
- Svelte generator → Generated framework code: emits
- Solid generator → Generated framework code: emits
- Alpine generator → Generated framework code: emits
- Qwik generator → Generated framework code: emits
- Other generators → Generated framework code: emits
- Qwik generator → Event normalization: normalizes
- Figma → Compile command: supplies designs
