# mikevetkin/doors-of-durin architecture

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

- Interactive diagram: https://gitdiagram.com/mikevetkin/doors-of-durin
- Repository: https://github.com/mikevetkin/doors-of-durin

## Overview

This is a small React application built around the Doors of Durin puzzle: visitors enter a code and name, submit them, and the app determines whether they are welcomed as a friend or remain a stranger. A reducer owns form, traveller, and light state; presentation modules turn that state into page view states. The UI also presents Tengwar and Ithildin effects. The README describes only a Vite template, so product capabilities are inferred from the source tree and excerpts; unsampled links are omitted where evidence is unavailable.

Main entry points: [`src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts) (Puzzle reducer), [`src/App.tsx`](https://github.com/mikevetkin/doors-of-durin/blob/main/src/App.tsx) (App), [`src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts`](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts) (Puzzle hook), [`src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx`](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx) (Door form page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application flow"]
  node_entry["React entry<br/>[main.tsx]"]
  node_app["App<br/>[App.tsx]"]
  node_hook["Puzzle hook<br/>[useDoorsOfDurin.ts]"]
end

subgraph group_domain["Door domain"]
  node_reducer["Puzzle reducer"]
  node_state["Puzzle state"]
  node_events["Puzzle events"]
  node_code["Code validation<br/>[Code.ts]"]
  node_name["Name validation<br/>[Name.ts]"]
  node_travellers["Traveller types"]
  node_forms["Form model"]
  node_lights["Light types"]
end

subgraph group_presentation["Pages and presentation"]
  node_appview["App presentation<br/>[AppPresentation.ts]"]
  node_doorspres["Door presentation"]
  node_doorview["Door view state"]
  node_doorpage["Door form page<br/>[index.tsx]"]
  node_welcomepres["Welcome presentation"]
  node_welcomeview["Welcome view state"]
  node_welcomepage["Welcome page<br/>[index.tsx]"]
end

subgraph group_shared["Shared visual features"]
  node_ithildinlogic["Light interpretation<br/>[handleLight.ts]"]
  node_ithildin["Ithildin display<br/>[index.tsx]"]
  node_tengwar["Tengwar display<br/>[index.tsx]"]
  node_controls["Form controls<br/>[button.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"uses state"| node_hook
node_app -->|"renders"| node_doorpage
node_app -->|"renders"| node_welcomepage
node_hook -->|"dispatches"| node_reducer
node_hook -->|"initializes"| node_state
node_hook -->|"presents state"| node_appview
node_reducer -->|"handles"| node_events
node_state -->|"contains"| node_forms
node_reducer -->|"validates"| node_code
node_reducer -->|"validates"| node_name
node_reducer -->|"creates traveller"| node_travellers
node_reducer -->|"checks light"| node_ithildinlogic
node_ithildinlogic -->|"matches types"| node_lights
node_appview -->|"selects view"| node_doorspres
node_appview -->|"selects view"| node_welcomepres
node_doorspres -->|"builds view state"| node_doorview
node_doorpage -->|"renders controls"| node_controls
node_doorpage -->|"renders text"| node_ithildin
node_doorpage -->|"renders script"| node_tengwar
node_welcomepres -->|"builds view state"| node_welcomeview
node_welcomepage -.->|"displays"| node_welcomeview

click node_entry "https://github.com/mikevetkin/doors-of-durin/blob/main/src/main.tsx"
click node_app "https://github.com/mikevetkin/doors-of-durin/blob/main/src/App.tsx"
click node_hook "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts"
click node_reducer "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts"
click node_state "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinState.ts"
click node_events "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinEvent.ts"
click node_code "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/entity/code/Code.ts"
click node_name "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/entity/name/Name.ts"
click node_travellers "https://github.com/mikevetkin/doors-of-durin/tree/main/src/context/moria/feature/doors-of-durin/domain/entity/traveller"
click node_forms "https://github.com/mikevetkin/doors-of-durin/tree/main/src/context/moria/feature/doors-of-durin/domain/entity/form"
click node_lights "https://github.com/mikevetkin/doors-of-durin/tree/main/src/context/moria/feature/doors-of-durin/domain/entity/light"
click node_appview "https://github.com/mikevetkin/doors-of-durin/blob/main/src/AppPresentation.ts"
click node_doorspres "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinPresentation.ts"
click node_doorview "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinViewState.ts"
click node_doorpage "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx"
click node_welcomepres "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaPresentation.ts"
click node_welcomeview "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaViewState.ts"
click node_welcomepage "https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/index.tsx"
click node_ithildinlogic "https://github.com/mikevetkin/doors-of-durin/blob/main/src/shared/Ithildin/domain/lib/handleLight.ts"
click node_ithildin "https://github.com/mikevetkin/doors-of-durin/blob/main/src/shared/Ithildin/ui/components/Ithildin/index.tsx"
click node_tengwar "https://github.com/mikevetkin/doors-of-durin/blob/main/src/shared/tengwar/ui/components/Tengwar/index.tsx"
click node_controls "https://github.com/mikevetkin/doors-of-durin/blob/main/src/components/ui/button.tsx"

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_app,node_hook toneBlue
class node_reducer,node_state,node_events,node_code,node_name,node_travellers,node_forms,node_lights toneAmber
class node_appview,node_doorspres,node_doorview,node_doorpage,node_welcomepres,node_welcomeview,node_welcomepage toneMint
class node_ithildinlogic,node_ithildin,node_tengwar,node_controls toneRose
class node_visitor toneIndigo
```

## Components

### Application flow

- [React entry](https://github.com/mikevetkin/doors-of-durin/blob/main/src/main.tsx): `src/main.tsx`
- [App](https://github.com/mikevetkin/doors-of-durin/blob/main/src/App.tsx): `src/App.tsx`
- [Puzzle hook](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts): `src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts`

### Door domain

- [Puzzle reducer](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts): `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`
- [Puzzle state](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinState.ts): `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinState.ts`
- [Puzzle events](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinEvent.ts): `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinEvent.ts`
- [Code validation](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/entity/code/Code.ts): `src/context/moria/feature/doors-of-durin/domain/entity/code/Code.ts`
- [Name validation](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/domain/entity/name/Name.ts): `src/context/moria/feature/doors-of-durin/domain/entity/name/Name.ts`
- [Traveller types](https://github.com/mikevetkin/doors-of-durin/tree/main/src/context/moria/feature/doors-of-durin/domain/entity/traveller): `src/context/moria/feature/doors-of-durin/domain/entity/traveller`
- [Form model](https://github.com/mikevetkin/doors-of-durin/tree/main/src/context/moria/feature/doors-of-durin/domain/entity/form): `src/context/moria/feature/doors-of-durin/domain/entity/form`
- [Light types](https://github.com/mikevetkin/doors-of-durin/tree/main/src/context/moria/feature/doors-of-durin/domain/entity/light): `src/context/moria/feature/doors-of-durin/domain/entity/light`

### Pages and presentation

- [App presentation](https://github.com/mikevetkin/doors-of-durin/blob/main/src/AppPresentation.ts): `src/AppPresentation.ts`
- [Door presentation](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinPresentation.ts): `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinPresentation.ts`
- [Door view state](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinViewState.ts): `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinViewState.ts`
- [Door form page](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx): `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx`
- [Welcome presentation](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaPresentation.ts): `src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaPresentation.ts`
- [Welcome view state](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaViewState.ts): `src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaViewState.ts`
- [Welcome page](https://github.com/mikevetkin/doors-of-durin/blob/main/src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/index.tsx): `src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/index.tsx`

### Shared visual features

- [Light interpretation](https://github.com/mikevetkin/doors-of-durin/blob/main/src/shared/Ithildin/domain/lib/handleLight.ts): `src/shared/Ithildin/domain/lib/handleLight.ts`
- [Ithildin display](https://github.com/mikevetkin/doors-of-durin/blob/main/src/shared/Ithildin/ui/components/Ithildin/index.tsx): `src/shared/Ithildin/ui/components/Ithildin/index.tsx`
- [Tengwar display](https://github.com/mikevetkin/doors-of-durin/blob/main/src/shared/tengwar/ui/components/Tengwar/index.tsx): `src/shared/tengwar/ui/components/Tengwar/index.tsx`
- [Form controls](https://github.com/mikevetkin/doors-of-durin/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → React entry: opens app
- React entry → App: renders (evidence: `src/main.tsx`)
- App → Puzzle hook: uses state (evidence: `src/App.tsx`)
- App → Door form page: renders (evidence: `src/App.tsx`)
- App → Welcome page: renders (evidence: `src/App.tsx`)
- Puzzle hook → Puzzle reducer: dispatches (evidence: `src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts`)
- Puzzle hook → Puzzle state: initializes (evidence: `src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts`)
- Puzzle hook → App presentation: presents state (evidence: `src/context/moria/feature/doors-of-durin/ui/hook/useDoorsOfDurin.ts`)
- Puzzle reducer → Puzzle events: handles (evidence: `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`)
- Puzzle state → Form model: contains (evidence: `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinState.ts`)
- Puzzle reducer → Code validation: validates (evidence: `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`)
- Puzzle reducer → Name validation: validates (evidence: `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`)
- Puzzle reducer → Traveller types: creates traveller (evidence: `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`)
- Puzzle reducer → Light interpretation: checks light (evidence: `src/context/moria/feature/doors-of-durin/domain/functional-core/DoorsOfDurinReducer.ts`)
- Light interpretation → Light types: matches types (evidence: `src/shared/Ithildin/domain/lib/handleLight.ts`)
- App presentation → Door presentation: selects view (evidence: `src/AppPresentation.ts`)
- App presentation → Welcome presentation: selects view (evidence: `src/AppPresentation.ts`)
- Door presentation → Door view state: builds view state (evidence: `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/DoorsOfDurinPresentation.ts`)
- Door form page → Form controls: renders controls (evidence: `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx`)
- Door form page → Ithildin display: renders text (evidence: `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx`)
- Door form page → Tengwar display: renders script (evidence: `src/context/moria/feature/doors-of-durin/ui/pages/DoorsOfDurin/index.tsx`)
- Welcome presentation → Welcome view state: builds view state (evidence: `src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/WelcomeToMoriaPresentation.ts`)
- Welcome page → Welcome view state: displays (evidence: `src/context/moria/feature/doors-of-durin/ui/pages/WelcomeToMoria/index.tsx`)
