# darkroomengineering/novus architecture

> Architecture diagram of the GitHub repository darkroomengineering/novus, 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/darkroomengineering/novus
- Repository: https://github.com/darkroomengineering/novus

## Overview

Novus is a React Router starter and reusable front-end platform, rather than a single end-user application. Its runtime centers on serving routed pages through a shared layout with scroll/UI and optional WebGL; accompanying packages provide transitions, static localization, Sanity content integration, design-system generation, and development visualization. The README also documents font and image optimization capabilities. Several links are explicit in sampled imports; unsampled subsystem relationships are shown only where documented, with evidence limits reflected by omitted links.

Main entry points: [`webgl/components/global-canvas/index.tsx`](https://github.com/darkroomengineering/novus/blob/main/webgl/components/global-canvas/index.tsx) (Global canvas), [`app/routes/index.tsx`](https://github.com/darkroomengineering/novus/blob/main/app/routes/index.tsx) (Route handlers), [`components/wrapper.tsx`](https://github.com/darkroomengineering/novus/blob/main/components/wrapper.tsx) (App wrapper), [`packages/transitions/transition-outlet.tsx`](https://github.com/darkroomengineering/novus/blob/main/packages/transitions/transition-outlet.tsx) (Page transitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing and UI"]
  node_routes["Route handlers<br/>[index.tsx]"]
  node_wrapper["App wrapper<br/>[wrapper.tsx]"]
end

subgraph group_experience["Page Experience"]
  node_scroll["Smooth scrolling<br/>[index.tsx]"]
  node_scrollbar["Custom scrollbar<br/>[index.tsx]"]
  node_marquee["Marquee<br/>[index.tsx]"]
  node_fold["Scroll fold<br/>[index.tsx]"]
  node_progress["Progress text<br/>[index.tsx]"]
  node_transitions["Page transitions"]
  node_transitionstate["Transition coordination<br/>[context.ts]"]
end

subgraph group_graphics["WebGL System"]
  node_canvas["Global canvas<br/>[index.tsx]"]
  node_webglstore["WebGL state<br/>[store.ts]"]
  node_renderer["GPU renderer<br/>[create-renderer.ts]"]
  node_flowmap["Flowmap effects<br/>[index.tsx]"]
end

subgraph group_content["Content and Localization"]
  node_sanity["Sanity content<br/>[client.ts]"]
  node_sanityqueries["Sanity queries<br/>[queries.ts]"]
  node_i18n["Static localization<br/>[loader.server.ts]"]
  node_i18nbuild["Localization build<br/>[build.ts]"]
end

subgraph group_tooling["Platform Packages"]
  node_styling["Design system<br/>[css.ts]"]
  node_fonts["Font optimizer<br/>[plugin.ts]"]
  node_fontsubset["Font subsetting<br/>[subset.ts]"]
  node_images["Image optimizer<br/>[process.ts]"]
  node_orchestra["Dev controls<br/>[cmdo.tsx]"]
  node_orchestratools["Dev overlays<br/>[index.tsx]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"requests page"| node_routes
node_routes -->|"renders"| node_wrapper
node_wrapper -->|"renders"| node_scroll
node_wrapper -->|"mounts"| node_canvas
node_scrollbar -->|"reads scroll state"| node_scroll
node_marquee -->|"reads velocity"| node_scroll
node_marquee -.-> node_transitions
node_routes -.-> node_transitions
node_transitions -->|"coordinates callbacks"| node_transitionstate
node_canvas -->|"reads state"| node_webglstore
node_canvas -->|"creates renderer"| node_renderer
node_canvas -->|"renders provider"| node_flowmap
node_sanityqueries -.-> node_sanity
node_i18nbuild -.-> node_i18n
node_fonts -->|"subsets fonts"| node_fontsubset
node_images -.->|"processes images"| node_images
node_orchestratools -->|"subscribes"| node_orchestra

click node_routes "https://github.com/darkroomengineering/novus/blob/main/app/routes/index.tsx"
click node_wrapper "https://github.com/darkroomengineering/novus/blob/main/components/wrapper.tsx"
click node_scroll "https://github.com/darkroomengineering/novus/blob/main/components/lenis/index.tsx"
click node_scrollbar "https://github.com/darkroomengineering/novus/blob/main/components/scrollbar/index.tsx"
click node_marquee "https://github.com/darkroomengineering/novus/blob/main/components/marquee/index.tsx"
click node_fold "https://github.com/darkroomengineering/novus/blob/main/components/fold/index.tsx"
click node_progress "https://github.com/darkroomengineering/novus/blob/main/components/progress-text/index.tsx"
click node_transitions "https://github.com/darkroomengineering/novus/blob/main/packages/transitions/transition-outlet.tsx"
click node_transitionstate "https://github.com/darkroomengineering/novus/blob/main/packages/transitions/context.ts"
click node_canvas "https://github.com/darkroomengineering/novus/blob/main/webgl/components/global-canvas/index.tsx"
click node_webglstore "https://github.com/darkroomengineering/novus/blob/main/webgl/store.ts"
click node_renderer "https://github.com/darkroomengineering/novus/blob/main/webgl/utils/create-renderer.ts"
click node_flowmap "https://github.com/darkroomengineering/novus/blob/main/webgl/components/flowmap-provider/index.tsx"
click node_sanity "https://github.com/darkroomengineering/novus/blob/main/integrations/sanity/client.ts"
click node_sanityqueries "https://github.com/darkroomengineering/novus/blob/main/integrations/sanity/queries.ts"
click node_i18n "https://github.com/darkroomengineering/novus/blob/main/packages/static-i18n/loader.server.ts"
click node_i18nbuild "https://github.com/darkroomengineering/novus/blob/main/packages/static-i18n/build.ts"
click node_styling "https://github.com/darkroomengineering/novus/blob/main/packages/styling/css.ts"
click node_fonts "https://github.com/darkroomengineering/novus/blob/main/packages/font-optimizer/plugin.ts"
click node_fontsubset "https://github.com/darkroomengineering/novus/blob/main/packages/font-optimizer/subset.ts"
click node_images "https://github.com/darkroomengineering/novus/blob/main/packages/image-optimizer/process.ts"
click node_orchestra "https://github.com/darkroomengineering/novus/blob/main/packages/orchestra/cmdo.tsx"
click node_orchestratools "https://github.com/darkroomengineering/novus/blob/main/packages/orchestra/index.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_routes,node_wrapper toneBlue
class node_scroll,node_scrollbar,node_marquee,node_fold,node_progress,node_transitions,node_transitionstate toneAmber
class node_canvas,node_webglstore,node_renderer,node_flowmap toneMint
class node_sanity,node_sanityqueries,node_i18n,node_i18nbuild toneRose
class node_styling,node_fonts,node_fontsubset,node_images,node_orchestra,node_orchestratools,node_visitor toneIndigo
```

## Components

### Routing and UI

- [Route handlers](https://github.com/darkroomengineering/novus/blob/main/app/routes/index.tsx): `app/routes/index.tsx`
- [App wrapper](https://github.com/darkroomengineering/novus/blob/main/components/wrapper.tsx): `components/wrapper.tsx`

### Page Experience

- [Smooth scrolling](https://github.com/darkroomengineering/novus/blob/main/components/lenis/index.tsx): `components/lenis/index.tsx`
- [Custom scrollbar](https://github.com/darkroomengineering/novus/blob/main/components/scrollbar/index.tsx): `components/scrollbar/index.tsx`
- [Marquee](https://github.com/darkroomengineering/novus/blob/main/components/marquee/index.tsx): `components/marquee/index.tsx`
- [Scroll fold](https://github.com/darkroomengineering/novus/blob/main/components/fold/index.tsx): `components/fold/index.tsx`
- [Progress text](https://github.com/darkroomengineering/novus/blob/main/components/progress-text/index.tsx): `components/progress-text/index.tsx`
- [Page transitions](https://github.com/darkroomengineering/novus/blob/main/packages/transitions/transition-outlet.tsx): `packages/transitions/transition-outlet.tsx`
- [Transition coordination](https://github.com/darkroomengineering/novus/blob/main/packages/transitions/context.ts): `packages/transitions/context.ts`

### WebGL System

- [Global canvas](https://github.com/darkroomengineering/novus/blob/main/webgl/components/global-canvas/index.tsx): `webgl/components/global-canvas/index.tsx`
- [WebGL state](https://github.com/darkroomengineering/novus/blob/main/webgl/store.ts): `webgl/store.ts`
- [GPU renderer](https://github.com/darkroomengineering/novus/blob/main/webgl/utils/create-renderer.ts): `webgl/utils/create-renderer.ts`
- [Flowmap effects](https://github.com/darkroomengineering/novus/blob/main/webgl/components/flowmap-provider/index.tsx): `webgl/components/flowmap-provider/index.tsx`

### Content and Localization

- [Sanity content](https://github.com/darkroomengineering/novus/blob/main/integrations/sanity/client.ts): `integrations/sanity/client.ts`
- [Sanity queries](https://github.com/darkroomengineering/novus/blob/main/integrations/sanity/queries.ts): `integrations/sanity/queries.ts`
- [Static localization](https://github.com/darkroomengineering/novus/blob/main/packages/static-i18n/loader.server.ts): `packages/static-i18n/loader.server.ts`
- [Localization build](https://github.com/darkroomengineering/novus/blob/main/packages/static-i18n/build.ts): `packages/static-i18n/build.ts`

### Platform Packages

- [Design system](https://github.com/darkroomengineering/novus/blob/main/packages/styling/css.ts): `packages/styling/css.ts`
- [Font optimizer](https://github.com/darkroomengineering/novus/blob/main/packages/font-optimizer/plugin.ts): `packages/font-optimizer/plugin.ts`
- [Font subsetting](https://github.com/darkroomengineering/novus/blob/main/packages/font-optimizer/subset.ts): `packages/font-optimizer/subset.ts`
- [Image optimizer](https://github.com/darkroomengineering/novus/blob/main/packages/image-optimizer/process.ts): `packages/image-optimizer/process.ts`
- [Dev controls](https://github.com/darkroomengineering/novus/blob/main/packages/orchestra/cmdo.tsx): `packages/orchestra/cmdo.tsx`
- [Dev overlays](https://github.com/darkroomengineering/novus/blob/main/packages/orchestra/index.tsx): `packages/orchestra/index.tsx`

### Other components

- **Site visitor**

## Connections

- Site visitor → Route handlers: requests page
- Route handlers → App wrapper: renders (evidence: `app/routes/index.tsx`)
- App wrapper → Smooth scrolling: renders (evidence: `components/wrapper.tsx`)
- App wrapper → Global canvas: mounts (evidence: `components/wrapper.tsx`)
- Custom scrollbar → Smooth scrolling: reads scroll state (evidence: `components/scrollbar/index.tsx`)
- Marquee → Smooth scrolling: reads velocity (evidence: `components/marquee/index.tsx`)
- Marquee → Page transitions
- Route handlers → Page transitions
- Page transitions → Transition coordination: coordinates callbacks (evidence: `packages/transitions/context.ts`)
- Global canvas → WebGL state: reads state (evidence: `webgl/components/global-canvas/index.tsx`)
- Global canvas → GPU renderer: creates renderer (evidence: `webgl/components/global-canvas/index.tsx`)
- Global canvas → Flowmap effects: renders provider (evidence: `webgl/components/global-canvas/index.tsx`)
- Sanity queries → Sanity content
- Localization build → Static localization
- Font optimizer → Font subsetting: subsets fonts (evidence: `packages/font-optimizer/plugin.ts`)
- Image optimizer → Image optimizer: processes images (evidence: `packages/image-optimizer/process.ts`)
- Dev overlays → Dev controls: subscribes (evidence: `packages/orchestra/index.tsx`)
