# solidjs/reactivescript architecture

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

- Interactive diagram: https://gitdiagram.com/solidjs/reactivescript
- Repository: https://github.com/solidjs/reactivescript

## Overview

ReactiveScript is a language and compiler for reactive UIs: users write `.rx` programs, which are parsed, checked against the language rules, linked across modules, then compiled to Solid-compatible JavaScript. The production compiler also supports editor diagnostics and TypeScript projection, a Vite-facing frontend, and CLI/Wasm interfaces. The graph covers those documented capabilities and the sampled compiler call paths; several integration paths are documented or implied but their implementation files were not excerpted, so those links are dashed.

Main entry points: [`compiler/src/app.rs`](https://github.com/solidjs/reactivescript/blob/main/compiler/src/app.rs) (App Compilation), [`compiler/src/check.rs`](https://github.com/solidjs/reactivescript/blob/main/compiler/src/check.rs) (Static Checker), [`compiler/src/serve.rs`](https://github.com/solidjs/reactivescript/blob/main/compiler/src/serve.rs) (Editor Analysis), [`compiler/src/modules.rs`](https://github.com/solidjs/reactivescript/blob/main/compiler/src/modules.rs) (Module Loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_language["Language Frontend"]
  node_parser["Parser<br/>[parse.rs]"]
  node_syntax["AST<br/>[ast.rs]"]
  node_module_loader["Module Loader<br/>[modules.rs]"]
  node_signatures["Module Signatures<br/>[signature.rs]"]
  node_checker["Static Checker<br/>[check.rs]"]
  node_inference["Type Inference<br/>[infer.rs]"]
end

subgraph group_compile["Compilation"]
  node_emitter["Code Emitter<br/>[emit.rs]"]
  node_oxc["Solid Compiler Bridge<br/>[oxc.rs]"]
  node_projector["TSX Projection<br/>[project.rs]"]
  node_app_compile["App Compilation<br/>[app.rs]"]
end

subgraph group_interfaces["User Interfaces"]
  node_cli["Compiler CLI<br/>[main.rs]"]
  node_node_api["Node API<br/>[node.rs]"]
  node_wasm_api["Wasm API<br/>[wasm.rs]"]
  node_vite["Vite Frontend<br/>[vite.mjs]"]
end

subgraph group_editor["Editor Support"]
  node_serve["Editor Analysis<br/>[serve.rs]"]
  node_language_server["Language Server<br/>[index.js]"]
  node_vscode["VS Code Extension<br/>[client.js]"]
end

node_developer((".rx Author"))
node_solid["Solid Compiler"]
node_typescript["TypeScript Services"]

node_developer -.->|"writes source"| node_parser
node_app_compile -->|"loads modules"| node_module_loader
node_app_compile -->|"checks modules"| node_checker
node_app_compile -->|"compiles modules"| node_emitter
node_app_compile -->|"lowers views"| node_emitter
node_module_loader -->|"parses modules"| node_parser
node_module_loader -->|"parses signatures"| node_signatures
node_checker -->|"uses parsed program"| node_parser
node_checker -->|"uses inference"| node_inference
node_checker -->|"walks AST"| node_syntax
node_emitter -->|"emits from AST"| node_syntax
node_emitter -->|"uses compiler bridge"| node_oxc
node_serve -->|"loads editor modules"| node_module_loader
node_serve -->|"projects modules"| node_projector
node_serve -->|"checks modules"| node_checker
node_cli -.->|"invokes compilation"| node_app_compile
node_node_api -.->|"provides compilation"| node_app_compile
node_vite -.->|"uses compiler API"| node_node_api
node_wasm_api -.->|"serves analysis"| node_serve
node_language_server -.->|"requests diagnostics"| node_serve
node_language_server -->|"registers services"| node_typescript
node_vscode -->|"starts server"| node_language_server
node_projector -.->|"supports type checking"| node_typescript
node_oxc -.->|"lowers Solid views"| node_solid

click node_parser "https://github.com/solidjs/reactivescript/blob/main/compiler/src/parse.rs"
click node_syntax "https://github.com/solidjs/reactivescript/blob/main/compiler/src/ast.rs"
click node_module_loader "https://github.com/solidjs/reactivescript/blob/main/compiler/src/modules.rs"
click node_signatures "https://github.com/solidjs/reactivescript/blob/main/compiler/src/signature.rs"
click node_checker "https://github.com/solidjs/reactivescript/blob/main/compiler/src/check.rs"
click node_inference "https://github.com/solidjs/reactivescript/blob/main/compiler/src/infer.rs"
click node_emitter "https://github.com/solidjs/reactivescript/blob/main/compiler/src/emit.rs"
click node_oxc "https://github.com/solidjs/reactivescript/blob/main/compiler/src/oxc.rs"
click node_projector "https://github.com/solidjs/reactivescript/blob/main/compiler/src/project.rs"
click node_app_compile "https://github.com/solidjs/reactivescript/blob/main/compiler/src/app.rs"
click node_cli "https://github.com/solidjs/reactivescript/blob/main/compiler/src/main.rs"
click node_node_api "https://github.com/solidjs/reactivescript/blob/main/compiler/src/node.rs"
click node_wasm_api "https://github.com/solidjs/reactivescript/blob/main/compiler/src/wasm.rs"
click node_vite "https://github.com/solidjs/reactivescript/blob/main/compiler/vite.mjs"
click node_serve "https://github.com/solidjs/reactivescript/blob/main/compiler/src/serve.rs"
click node_language_server "https://github.com/solidjs/reactivescript/blob/main/tooling/rx-language-server/src/index.js"
click node_vscode "https://github.com/solidjs/reactivescript/blob/main/tooling/vscode-rx/client.js"

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_parser,node_syntax,node_module_loader,node_signatures,node_checker,node_inference toneBlue
class node_emitter,node_oxc,node_projector,node_app_compile toneAmber
class node_cli,node_node_api,node_wasm_api,node_vite toneMint
class node_serve,node_language_server,node_vscode toneRose
class node_developer,node_solid,node_typescript toneIndigo
```

## Components

### Language Frontend

- [Parser](https://github.com/solidjs/reactivescript/blob/main/compiler/src/parse.rs): `compiler/src/parse.rs`
- [AST](https://github.com/solidjs/reactivescript/blob/main/compiler/src/ast.rs): `compiler/src/ast.rs`
- [Module Loader](https://github.com/solidjs/reactivescript/blob/main/compiler/src/modules.rs): `compiler/src/modules.rs`
- [Module Signatures](https://github.com/solidjs/reactivescript/blob/main/compiler/src/signature.rs): `compiler/src/signature.rs`
- [Static Checker](https://github.com/solidjs/reactivescript/blob/main/compiler/src/check.rs): `compiler/src/check.rs`
- [Type Inference](https://github.com/solidjs/reactivescript/blob/main/compiler/src/infer.rs): `compiler/src/infer.rs`

### Compilation

- [Code Emitter](https://github.com/solidjs/reactivescript/blob/main/compiler/src/emit.rs): `compiler/src/emit.rs`
- [Solid Compiler Bridge](https://github.com/solidjs/reactivescript/blob/main/compiler/src/oxc.rs): `compiler/src/oxc.rs`
- [TSX Projection](https://github.com/solidjs/reactivescript/blob/main/compiler/src/project.rs): `compiler/src/project.rs`
- [App Compilation](https://github.com/solidjs/reactivescript/blob/main/compiler/src/app.rs): `compiler/src/app.rs`

### User Interfaces

- [Compiler CLI](https://github.com/solidjs/reactivescript/blob/main/compiler/src/main.rs): `compiler/src/main.rs`
- [Node API](https://github.com/solidjs/reactivescript/blob/main/compiler/src/node.rs): `compiler/src/node.rs`
- [Wasm API](https://github.com/solidjs/reactivescript/blob/main/compiler/src/wasm.rs): `compiler/src/wasm.rs`
- [Vite Frontend](https://github.com/solidjs/reactivescript/blob/main/compiler/vite.mjs): `compiler/vite.mjs`

### Editor Support

- [Editor Analysis](https://github.com/solidjs/reactivescript/blob/main/compiler/src/serve.rs): `compiler/src/serve.rs`
- [Language Server](https://github.com/solidjs/reactivescript/blob/main/tooling/rx-language-server/src/index.js): `tooling/rx-language-server/src/index.js`
- [VS Code Extension](https://github.com/solidjs/reactivescript/blob/main/tooling/vscode-rx/client.js): `tooling/vscode-rx/client.js`

### Other components

- **.rx Author**
- **Solid Compiler**
- **TypeScript Services**

## Connections

- .rx Author → Parser: writes source (evidence: `README.md`)
- App Compilation → Module Loader: loads modules (evidence: `compiler/src/app.rs`)
- App Compilation → Static Checker: checks modules (evidence: `compiler/src/app.rs`)
- App Compilation → Code Emitter: compiles modules (evidence: `compiler/src/app.rs`)
- App Compilation → Code Emitter: lowers views (evidence: `compiler/src/app.rs`)
- Module Loader → Parser: parses modules (evidence: `compiler/src/modules.rs`)
- Module Loader → Module Signatures: parses signatures (evidence: `compiler/src/modules.rs`)
- Static Checker → Parser: uses parsed program (evidence: `compiler/src/check.rs`)
- Static Checker → Type Inference: uses inference (evidence: `compiler/src/check.rs`)
- Static Checker → AST: walks AST (evidence: `compiler/src/check.rs`)
- Code Emitter → AST: emits from AST (evidence: `compiler/src/emit.rs`)
- Code Emitter → Solid Compiler Bridge: uses compiler bridge (evidence: `compiler/src/emit.rs`)
- Editor Analysis → Module Loader: loads editor modules (evidence: `compiler/src/serve.rs`)
- Editor Analysis → TSX Projection: projects modules (evidence: `compiler/src/serve.rs`)
- Editor Analysis → Static Checker: checks modules (evidence: `compiler/src/serve.rs`)
- Compiler CLI → App Compilation: invokes compilation
- Node API → App Compilation: provides compilation (evidence: `compiler/src/app.rs`)
- Vite Frontend → Node API: uses compiler API (evidence: `README.md`)
- Wasm API → Editor Analysis: serves analysis (evidence: `compiler/src/serve.rs`)
- Language Server → Editor Analysis: requests diagnostics
- Language Server → TypeScript Services: registers services
- VS Code Extension → Language Server: starts server (evidence: `tooling/vscode-rx/client.js`)
- TSX Projection → TypeScript Services: supports type checking (evidence: `README.md`)
- Solid Compiler Bridge → Solid Compiler: lowers Solid views (evidence: `README.md`)
