# phase-rs/phase architecture

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

- Interactive diagram: https://gitdiagram.com/phase-rs/phase
- Repository: https://github.com/phase-rs/phase

## Overview

phase.rs is an MTG rules engine and game client: players build decks or draft, start games, make decisions through the client, and play against the rules engine or other players. The README documents the Rust engine running natively and as WASM, with browser and Tauri clients, AI, multiplayer, deck building, and metagame feeds. Source excerpts show details of the rules and native-engine layers, but not the full client wiring; edges below reflect documented relationships or indexed source references.

Main entry points: [`crates/engine/src/game/zone_pipeline.rs`](https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/zone_pipeline.rs) (Rules engine), [`client/src/App.tsx`](https://github.com/phase-rs/phase/blob/main/client/src/App.tsx) (React client), [`client/src-tauri/src/native_engine.rs`](https://github.com/phase-rs/phase/blob/main/client/src-tauri/src/native_engine.rs) (Desktop host), [`client/src/components/draft/DraftIntro.tsx`](https://github.com/phase-rs/phase/blob/main/client/src/components/draft/DraftIntro.tsx) (Draft interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Game client"]
  node_app["React client<br/>[App.tsx]"]
  node_native["Desktop host<br/>[native_engine.rs]"]
  node_adapter["Engine adapters<br/>[engine-worker.ts]"]
  node_gameui["Game interface<br/>[GameBoard.tsx]"]
  node_deckbuilder["Deck builder<br/>[DeckBuilder.tsx]"]
end

subgraph group_rules["Rules engine"]
  node_engine["Rules engine<br/>[zone_pipeline.rs]"]
  node_gameobjects["Game state<br/>[game_object.rs]"]
  node_combat["Combat rules<br/>[combat.rs]"]
  node_abilities["Ability rules"]
  node_replacement["Replacement effects"]
  node_enginewasm["WASM engine<br/>[lib.rs]"]
end

subgraph group_play["Game modes"]
  node_ai["AI opponent<br/>[session.rs]"]
  node_draft["Draft sessions<br/>[session.rs]"]
  node_draftui["Draft interface<br/>[DraftIntro.tsx]"]
end

subgraph group_online["Online services"]
  node_server["Multiplayer server<br/>[persistence.rs]"]
  node_wireguard["Message validation"]
  node_lobby["Lobby service<br/>[index.ts]"]
end

subgraph group_data["Cards and feeds"]
  node_carddata[("Card data<br/>[engineRuntime.ts]")]
  node_feed["Metagame feeds<br/>[main.rs]"]
end

node_player(("Player"))

node_player -->|"plays through"| node_app
node_app -->|"uses rules"| node_engine
node_engine -->|"drives gameplay"| node_app
node_player -->|"builds decks"| node_deckbuilder
node_player -->|"drafts cards"| node_draftui
node_player -->|"joins games"| node_lobby
node_engine -->|"compiles to"| node_enginewasm
node_native -->|"imports"| node_adapter
node_native -.->|"exposes gameplay"| node_gameui
node_engine -->|"uses game objects"| node_gameobjects
node_engine -->|"consults effects"| node_replacement
node_engine -->|"reads active abilities"| node_abilities
node_engine -.->|"resolves combat"| node_combat
node_engine -.->|"supports decisions"| node_ai
node_draftui -.->|"runs draft sessions"| node_draft
node_server -.->|"validates messages"| node_wireguard
node_lobby -.->|"coordinates games"| node_server
node_engine -.->|"uses card data"| node_carddata
node_feed -.->|"supplies metagame data"| node_deckbuilder

click node_app "https://github.com/phase-rs/phase/blob/main/client/src/App.tsx"
click node_native "https://github.com/phase-rs/phase/blob/main/client/src-tauri/src/native_engine.rs"
click node_adapter "https://github.com/phase-rs/phase/blob/main/client/src/adapter/engine-worker.ts"
click node_gameui "https://github.com/phase-rs/phase/blob/main/client/src/components/board/GameBoard.tsx"
click node_deckbuilder "https://github.com/phase-rs/phase/blob/main/client/src/components/deck-builder/DeckBuilder.tsx"
click node_engine "https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/zone_pipeline.rs"
click node_gameobjects "https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/game_object.rs"
click node_combat "https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/combat.rs"
click node_abilities "https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/functioning_abilities.rs"
click node_replacement "https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/engine_replacement.rs"
click node_enginewasm "https://github.com/phase-rs/phase/blob/main/crates/engine-wasm/src/lib.rs"
click node_ai "https://github.com/phase-rs/phase/blob/main/crates/phase-ai/src/session.rs"
click node_draft "https://github.com/phase-rs/phase/blob/main/crates/draft-core/src/session.rs"
click node_draftui "https://github.com/phase-rs/phase/blob/main/client/src/components/draft/DraftIntro.tsx"
click node_server "https://github.com/phase-rs/phase/blob/main/crates/phase-server/src/persistence.rs"
click node_wireguard "https://github.com/phase-rs/phase/blob/main/crates/server-core/src/client_message_wire_guard.rs"
click node_lobby "https://github.com/phase-rs/phase/blob/main/lobby-worker/src/index.ts"
click node_carddata "https://github.com/phase-rs/phase/blob/main/client/src/services/engineRuntime.ts"
click node_feed "https://github.com/phase-rs/phase/blob/main/crates/feed-scraper/src/main.rs"

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_app,node_native,node_adapter,node_gameui,node_deckbuilder toneBlue
class node_engine,node_gameobjects,node_combat,node_abilities,node_replacement,node_enginewasm toneAmber
class node_ai,node_draft,node_draftui toneMint
class node_server,node_wireguard,node_lobby toneRose
class node_carddata,node_feed,node_player toneIndigo
```

## Components

### Game client

- [React client](https://github.com/phase-rs/phase/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Desktop host](https://github.com/phase-rs/phase/blob/main/client/src-tauri/src/native_engine.rs): `client/src-tauri/src/native_engine.rs`
- [Engine adapters](https://github.com/phase-rs/phase/blob/main/client/src/adapter/engine-worker.ts): `client/src/adapter/engine-worker.ts`
- [Game interface](https://github.com/phase-rs/phase/blob/main/client/src/components/board/GameBoard.tsx): `client/src/components/board/GameBoard.tsx`
- [Deck builder](https://github.com/phase-rs/phase/blob/main/client/src/components/deck-builder/DeckBuilder.tsx): `client/src/components/deck-builder/DeckBuilder.tsx`

### Rules engine

- [Rules engine](https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/zone_pipeline.rs): `crates/engine/src/game/zone_pipeline.rs`
- [Game state](https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/game_object.rs): `crates/engine/src/game/game_object.rs`
- [Combat rules](https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/combat.rs): `crates/engine/src/game/combat.rs`
- [Ability rules](https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/functioning_abilities.rs): `crates/engine/src/game/functioning_abilities.rs`
- [Replacement effects](https://github.com/phase-rs/phase/blob/main/crates/engine/src/game/engine_replacement.rs): `crates/engine/src/game/engine_replacement.rs`
- [WASM engine](https://github.com/phase-rs/phase/blob/main/crates/engine-wasm/src/lib.rs): `crates/engine-wasm/src/lib.rs`

### Game modes

- [AI opponent](https://github.com/phase-rs/phase/blob/main/crates/phase-ai/src/session.rs): `crates/phase-ai/src/session.rs`
- [Draft sessions](https://github.com/phase-rs/phase/blob/main/crates/draft-core/src/session.rs): `crates/draft-core/src/session.rs`
- [Draft interface](https://github.com/phase-rs/phase/blob/main/client/src/components/draft/DraftIntro.tsx): `client/src/components/draft/DraftIntro.tsx`

### Online services

- [Multiplayer server](https://github.com/phase-rs/phase/blob/main/crates/phase-server/src/persistence.rs): `crates/phase-server/src/persistence.rs`
- [Message validation](https://github.com/phase-rs/phase/blob/main/crates/server-core/src/client_message_wire_guard.rs): `crates/server-core/src/client_message_wire_guard.rs`
- [Lobby service](https://github.com/phase-rs/phase/blob/main/lobby-worker/src/index.ts): `lobby-worker/src/index.ts`

### Cards and feeds

- [Card data](https://github.com/phase-rs/phase/blob/main/client/src/services/engineRuntime.ts): `client/src/services/engineRuntime.ts`
- [Metagame feeds](https://github.com/phase-rs/phase/blob/main/crates/feed-scraper/src/main.rs): `crates/feed-scraper/src/main.rs`

### Other components

- **Player**

## Connections

- Player → React client: plays through (evidence: `README.md`)
- React client → Rules engine: uses rules (evidence: `README.md`)
- Rules engine → React client: drives gameplay (evidence: `README.md`)
- Player → Deck builder: builds decks (evidence: `README.md`)
- Player → Draft interface: drafts cards (evidence: `README.md`)
- Player → Lobby service: joins games (evidence: `README.md`)
- Rules engine → WASM engine: compiles to (evidence: `README.md`)
- Desktop host → Engine adapters: imports (evidence: `client/src-tauri/src/native_engine.rs`)
- Desktop host → Game interface: exposes gameplay
- Rules engine → Game state: uses game objects (evidence: `crates/engine/src/game/zone_pipeline.rs`)
- Rules engine → Replacement effects: consults effects (evidence: `crates/engine/src/game/zone_pipeline.rs`)
- Rules engine → Ability rules: reads active abilities (evidence: `crates/engine/src/game/functioning_abilities.rs`)
- Rules engine → Combat rules: resolves combat (evidence: `crates/engine/src/game/zone_pipeline.rs`)
- Rules engine → AI opponent: supports decisions
- Draft interface → Draft sessions: runs draft sessions
- Multiplayer server → Message validation: validates messages
- Lobby service → Multiplayer server: coordinates games
- Rules engine → Card data: uses card data
- Metagame feeds → Deck builder: supplies metagame data
