# edulinq/web-base architecture

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

- Interactive diagram: https://gitdiagram.com/edulinq/web-base
- Repository: https://github.com/edulinq/web-base

## Overview

EduLinq Web Template is a browser-side JavaScript and CSS library intended as a starting point for EduLinq web projects. A project developer incorporates its resources into a site; the JavaScript entry point exposes core services, models, renderers, and utilities, while the stylesheet collection supplies shared presentation. The sample site demonstrates use, but its implementation and the build tooling are not mapped as product components. Relationships below are limited to documented exports and source-index or excerpt evidence; unsampled subsystem internals are not inferred.

Main entry points: [`src/js/index.ts`](https://github.com/edulinq/web-base/blob/main/src/js/index.ts) (Library entry), [`src/js/core/events.ts`](https://github.com/edulinq/web-base/blob/main/src/js/core/events.ts) (Event system), [`src/js/model/timestamp.ts`](https://github.com/edulinq/web-base/blob/main/src/js/model/timestamp.ts) (Timestamps), [`src/js/core/log.ts`](https://github.com/edulinq/web-base/blob/main/src/js/core/log.ts) (Logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core services"]
  node_events["Event system<br/>[events.ts]"]
  node_logging["Logging<br/>[log.ts]"]
  node_routing["Hash routing<br/>[routing.ts]"]
end

subgraph group_models["Domain models"]
  node_fields["Form fields<br/>[field.ts]"]
  node_timestamps["Timestamps<br/>[timestamp.ts]"]
end

subgraph group_rendering["Rendering"]
  node_cards["Cards<br/>[cards.ts]"]
  node_code["Code rendering<br/>[code.ts]"]
  node_icons["Icon rendering<br/>[icons.ts]"]
  node_loading["Loading indicators<br/>[loading.ts]"]
end

subgraph group_utilities["Utilities"]
  node_brightness["Brightness mode<br/>[brightness.ts]"]
  node_json["JSON utilities<br/>[json.ts]"]
  node_objects["Object utilities<br/>[objects.ts]"]
  node_strings["String utilities<br/>[strings.ts]"]
  node_table["Table sorting<br/>[table.ts]"]
  node_testmode["Testing runtime mode<br/>[runtime.ts]"]
end

subgraph group_styling["Styles"]
  node_styles["Shared CSS"]
end

node_developer(("Project developer"))
node_entry["Library entry<br/>[index.ts]"]

node_developer -.->|"imports"| node_entry
node_entry -->|"exports"| node_events
node_entry -->|"exports"| node_logging
node_entry -->|"exports"| node_routing
node_entry -->|"exports"| node_fields
node_entry -->|"exports"| node_timestamps
node_entry -->|"exports"| node_cards
node_entry -->|"exports"| node_code
node_entry -->|"exports"| node_icons
node_entry -->|"exports"| node_loading
node_entry -->|"exports"| node_brightness
node_entry -->|"exports"| node_json
node_entry -->|"exports"| node_objects
node_entry -->|"exports"| node_strings
node_entry -->|"exports"| node_table
node_routing -->|"dispatches"| node_events
node_events -->|"compares with"| node_objects
node_logging -->|"timestamps records"| node_timestamps
node_timestamps -->|"checks mode"| node_testmode
node_loading -->|"uses icons"| node_icons
node_table -->|"compares with"| node_strings

click node_entry "https://github.com/edulinq/web-base/blob/main/src/js/index.ts"
click node_events "https://github.com/edulinq/web-base/blob/main/src/js/core/events.ts"
click node_logging "https://github.com/edulinq/web-base/blob/main/src/js/core/log.ts"
click node_routing "https://github.com/edulinq/web-base/blob/main/src/js/core/routing.ts"
click node_fields "https://github.com/edulinq/web-base/blob/main/src/js/model/field.ts"
click node_timestamps "https://github.com/edulinq/web-base/blob/main/src/js/model/timestamp.ts"
click node_cards "https://github.com/edulinq/web-base/blob/main/src/js/render/cards.ts"
click node_code "https://github.com/edulinq/web-base/blob/main/src/js/render/code.ts"
click node_icons "https://github.com/edulinq/web-base/blob/main/src/js/render/icons.ts"
click node_loading "https://github.com/edulinq/web-base/blob/main/src/js/render/loading.ts"
click node_brightness "https://github.com/edulinq/web-base/blob/main/src/js/util/brightness.ts"
click node_json "https://github.com/edulinq/web-base/blob/main/src/js/util/json.ts"
click node_objects "https://github.com/edulinq/web-base/blob/main/src/js/util/objects.ts"
click node_strings "https://github.com/edulinq/web-base/blob/main/src/js/util/strings.ts"
click node_table "https://github.com/edulinq/web-base/blob/main/src/js/util/table.ts"
click node_testmode "https://github.com/edulinq/web-base/blob/main/src/js/testing/runtime.ts"
click node_styles "https://github.com/edulinq/web-base/tree/main/src/css"

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_events,node_logging,node_routing toneBlue
class node_fields,node_timestamps toneAmber
class node_cards,node_code,node_icons,node_loading toneMint
class node_brightness,node_json,node_objects,node_strings,node_table,node_testmode toneRose
class node_styles,node_developer toneIndigo
class node_entry toneTeal
```

## Components

### Core services

- [Event system](https://github.com/edulinq/web-base/blob/main/src/js/core/events.ts): `src/js/core/events.ts`
- [Logging](https://github.com/edulinq/web-base/blob/main/src/js/core/log.ts): `src/js/core/log.ts`
- [Hash routing](https://github.com/edulinq/web-base/blob/main/src/js/core/routing.ts): `src/js/core/routing.ts`

### Domain models

- [Form fields](https://github.com/edulinq/web-base/blob/main/src/js/model/field.ts): `src/js/model/field.ts`
- [Timestamps](https://github.com/edulinq/web-base/blob/main/src/js/model/timestamp.ts): `src/js/model/timestamp.ts`

### Rendering

- [Cards](https://github.com/edulinq/web-base/blob/main/src/js/render/cards.ts): `src/js/render/cards.ts`
- [Code rendering](https://github.com/edulinq/web-base/blob/main/src/js/render/code.ts): `src/js/render/code.ts`
- [Icon rendering](https://github.com/edulinq/web-base/blob/main/src/js/render/icons.ts): `src/js/render/icons.ts`
- [Loading indicators](https://github.com/edulinq/web-base/blob/main/src/js/render/loading.ts): `src/js/render/loading.ts`

### Utilities

- [Brightness mode](https://github.com/edulinq/web-base/blob/main/src/js/util/brightness.ts): `src/js/util/brightness.ts`
- [JSON utilities](https://github.com/edulinq/web-base/blob/main/src/js/util/json.ts): `src/js/util/json.ts`
- [Object utilities](https://github.com/edulinq/web-base/blob/main/src/js/util/objects.ts): `src/js/util/objects.ts`
- [String utilities](https://github.com/edulinq/web-base/blob/main/src/js/util/strings.ts): `src/js/util/strings.ts`
- [Table sorting](https://github.com/edulinq/web-base/blob/main/src/js/util/table.ts): `src/js/util/table.ts`
- [Testing runtime mode](https://github.com/edulinq/web-base/blob/main/src/js/testing/runtime.ts): `src/js/testing/runtime.ts`

### Styles

- [Shared CSS](https://github.com/edulinq/web-base/tree/main/src/css): `src/css`

### Other components

- **Project developer**
- [Library entry](https://github.com/edulinq/web-base/blob/main/src/js/index.ts): `src/js/index.ts`

## Connections

- Project developer → Library entry: imports (evidence: `README.md`)
- Library entry → Event system: exports (evidence: `src/js/index.ts`)
- Library entry → Logging: exports (evidence: `src/js/index.ts`)
- Library entry → Hash routing: exports (evidence: `src/js/index.ts`)
- Library entry → Form fields: exports (evidence: `src/js/index.ts`)
- Library entry → Timestamps: exports (evidence: `src/js/index.ts`)
- Library entry → Cards: exports (evidence: `src/js/index.ts`)
- Library entry → Code rendering: exports (evidence: `src/js/index.ts`)
- Library entry → Icon rendering: exports (evidence: `src/js/index.ts`)
- Library entry → Loading indicators: exports (evidence: `src/js/index.ts`)
- Library entry → Brightness mode: exports (evidence: `src/js/index.ts`)
- Library entry → JSON utilities: exports (evidence: `src/js/index.ts`)
- Library entry → Object utilities: exports (evidence: `src/js/index.ts`)
- Library entry → String utilities: exports (evidence: `src/js/index.ts`)
- Library entry → Table sorting: exports (evidence: `src/js/index.ts`)
- Hash routing → Event system: dispatches (evidence: `src/js/core/routing.ts`)
- Event system → Object utilities: compares with (evidence: `src/js/core/events.ts`)
- Logging → Timestamps: timestamps records (evidence: `src/js/core/log.ts`)
- Timestamps → Testing runtime mode: checks mode (evidence: `src/js/model/timestamp.ts`)
- Loading indicators → Icon rendering: uses icons (evidence: `src/js/render/loading.ts`)
- Table sorting → String utilities: compares with (evidence: `src/js/util/table.ts`)
