# raredeveloperofficials/rareenginejs architecture

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

- Interactive diagram: https://gitdiagram.com/raredeveloperofficials/rareenginejs
- Repository: https://github.com/raredeveloperofficials/rareenginejs

## Overview

RareEngineJs is a small browser-based 2D game engine. The sample entry point creates a screen-sized scene, adds a game object with image and behavior components, and the scene updates and renders it on a canvas while routing touch input. The graph focuses on that runtime and its component/vector layers; the README gives no further capability details, so unsampled behavior is not inferred.

Main entry points: [`js/RareEngine/Scene.js`](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/Scene.js) (Scene), [`js/index.js`](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/index.js) (Demo Entry), [`js/RareEngine/GameUtil/GameObject.js`](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/GameObject.js) (Game Object), [`js/RareEngine/GameUtil/Components/Renderables/Renderer.js`](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/Renderer.js) (Renderer Base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Scene Runtime"]
  node_entry["Demo Entry<br/>[index.js]"]
  node_engine["Engine<br/>[Engine.js]"]
  node_scene["Scene<br/>[Scene.js]"]
end

subgraph group_objects["Objects And Components"]
  node_gameobject["Game Object<br/>[GameObject.js]"]
  node_component["Component<br/>[Component.js]"]
  node_player["Player Behavior<br/>[index.js]"]
end

subgraph group_rendering["Rendering And Math"]
  node_renderer["Renderer Base<br/>[Renderer.js]"]
  node_image["Image Renderer<br/>[ImageRenderer.js]"]
  node_text["Text Renderer<br/>[TextRenderer.js]"]
  node_vector["Vector2<br/>[Vector.js]"]
end

node_developer(("Application User"))
node_browser["Browser APIs"]

node_developer -->|"starts demo"| node_entry
node_entry -->|"creates scene"| node_engine
node_entry -->|"creates object"| node_gameobject
node_entry -->|"creates renderer"| node_image
node_entry -->|"adds behavior"| node_player
node_engine -->|"creates and starts"| node_scene
node_engine -->|"sizes canvas"| node_browser
node_scene -->|"clears body"| node_engine
node_scene -->|"creates canvas; listens"| node_browser
node_scene -->|"updates objects"| node_gameobject
node_scene -->|"updates and routes input"| node_component
node_scene -->|"renders components"| node_renderer
node_scene -->|"converts touch coordinates"| node_vector
node_gameobject -->|"attaches components"| node_component
node_gameobject -->|"stores positions and scale"| node_vector
node_player -->|"extends"| node_component
node_player -->|"changes position"| node_gameobject
node_renderer -->|"extends"| node_component
node_renderer -->|"stores offset"| node_vector
node_image -->|"extends"| node_renderer
node_image -->|"loads and draws image"| node_browser
node_text -->|"extends"| node_renderer

click node_entry "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/index.js"
click node_engine "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/Engine.js"
click node_scene "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/Scene.js"
click node_gameobject "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/GameObject.js"
click node_component "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Component.js"
click node_player "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/index.js"
click node_renderer "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/Renderer.js"
click node_image "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/ImageRenderer.js"
click node_text "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/TextRenderer.js"
click node_vector "https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/vectors/Vector.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_entry,node_engine,node_scene,node_developer,node_browser toneBlue
class node_gameobject,node_component,node_player toneAmber
class node_renderer,node_image,node_text,node_vector toneMint
```

## Components

### Scene Runtime

- [Demo Entry](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/index.js): `js/index.js`
- [Engine](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/Engine.js): `js/RareEngine/Engine.js`
- [Scene](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/Scene.js): `js/RareEngine/Scene.js`

### Objects And Components

- [Game Object](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/GameObject.js): `js/RareEngine/GameUtil/GameObject.js`
- [Component](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Component.js): `js/RareEngine/GameUtil/Components/Component.js`
- [Player Behavior](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/index.js): `js/index.js`

### Rendering And Math

- [Renderer Base](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/Renderer.js): `js/RareEngine/GameUtil/Components/Renderables/Renderer.js`
- [Image Renderer](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/ImageRenderer.js): `js/RareEngine/GameUtil/Components/Renderables/ImageRenderer.js`
- [Text Renderer](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/GameUtil/Components/Renderables/TextRenderer.js): `js/RareEngine/GameUtil/Components/Renderables/TextRenderer.js`
- [Vector2](https://github.com/raredeveloperofficials/rareenginejs/blob/main/js/RareEngine/vectors/Vector.js): `js/RareEngine/vectors/Vector.js`

### Other components

- **Application User**
- **Browser APIs**

## Connections

- Application User → Demo Entry: starts demo (evidence: `js/index.js`)
- Demo Entry → Engine: creates scene (evidence: `js/index.js`)
- Demo Entry → Game Object: creates object (evidence: `js/index.js`)
- Demo Entry → Image Renderer: creates renderer (evidence: `js/index.js`)
- Demo Entry → Player Behavior: adds behavior (evidence: `js/index.js`)
- Engine → Scene: creates and starts (evidence: `js/RareEngine/Engine.js`)
- Engine → Browser APIs: sizes canvas (evidence: `js/RareEngine/Engine.js`)
- Scene → Engine: clears body (evidence: `js/RareEngine/Scene.js`)
- Scene → Browser APIs: creates canvas; listens (evidence: `js/RareEngine/Scene.js`)
- Scene → Game Object: updates objects (evidence: `js/RareEngine/Scene.js`)
- Scene → Component: updates and routes input (evidence: `js/RareEngine/Scene.js`)
- Scene → Renderer Base: renders components (evidence: `js/RareEngine/Scene.js`)
- Scene → Vector2: converts touch coordinates (evidence: `js/RareEngine/Scene.js`)
- Game Object → Component: attaches components (evidence: `js/RareEngine/GameUtil/GameObject.js`)
- Game Object → Vector2: stores positions and scale (evidence: `js/RareEngine/GameUtil/GameObject.js`)
- Player Behavior → Component: extends (evidence: `js/index.js`)
- Player Behavior → Game Object: changes position (evidence: `js/index.js`)
- Renderer Base → Component: extends (evidence: `js/RareEngine/GameUtil/Components/Renderables/Renderer.js`)
- Renderer Base → Vector2: stores offset (evidence: `js/RareEngine/GameUtil/Components/Renderables/Renderer.js`)
- Image Renderer → Renderer Base: extends (evidence: `js/RareEngine/GameUtil/Components/Renderables/ImageRenderer.js`)
- Image Renderer → Browser APIs: loads and draws image (evidence: `js/RareEngine/GameUtil/Components/Renderables/ImageRenderer.js`)
- Text Renderer → Renderer Base: extends (evidence: `js/RareEngine/GameUtil/Components/Renderables/TextRenderer.js`)
