How darkroomengineering/novus works
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: global-canvas/index.tsx Global canvas · routes/index.tsx Route handlers · wrapper.tsx App wrapper · transition-outlet.tsx Page transitions
Components 24
Routing and UI
- Route handlers
app/routes/index.tsx - App wrapper
components/wrapper.tsx
Page Experience
- Smooth scrolling
components/lenis/index.tsx - Custom scrollbar
components/scrollbar/index.tsx - Marquee
components/marquee/index.tsx - Scroll fold
components/fold/index.tsx - Progress text
components/progress-text/index.tsx - Page transitions
packages/transitions/transition-outlet.tsx - Transition coordination
packages/transitions/context.ts
WebGL System
- Global canvas
webgl/components/global-canvas/index.tsx - WebGL state
webgl/store.ts - GPU renderer
webgl/utils/create-renderer.ts - Flowmap effects
webgl/components/flowmap-provider/index.tsx
Content and Localization
- Sanity content
integrations/sanity/client.ts - Sanity queries
integrations/sanity/queries.ts - Static localization
packages/static-i18n/loader.server.ts - Localization build
packages/static-i18n/build.ts
Platform Packages
- Design system
packages/styling/css.ts - Font optimizer
packages/font-optimizer/plugin.ts - Font subsetting
packages/font-optimizer/subset.ts - Image optimizer
packages/image-optimizer/process.ts - Dev controls
packages/orchestra/cmdo.tsx - Dev overlays
packages/orchestra/index.tsx
Other components
- Site visitor
Connections 17
- Site visitor → Route handlers: requests page
- Route handlers → App wrapper: renders
app/routes/index.tsx - App wrapper → Smooth scrolling: renders
components/wrapper.tsx - App wrapper → Global canvas: mounts
components/wrapper.tsx - Custom scrollbar → Smooth scrolling: reads scroll state
components/scrollbar/index.tsx - Marquee → Smooth scrolling: reads velocity
components/marquee/index.tsx - Marquee → Page transitions
- Route handlers → Page transitions
- Page transitions → Transition coordination: coordinates callbacks
packages/transitions/context.ts - Global canvas → WebGL state: reads state
webgl/components/global-canvas/index.tsx - Global canvas → GPU renderer: creates renderer
webgl/components/global-canvas/index.tsx - Global canvas → Flowmap effects: renders provider
webgl/components/global-canvas/index.tsx - Sanity queries → Sanity content
- Localization build → Static localization
- Font optimizer → Font subsetting: subsets fonts
packages/font-optimizer/plugin.ts - Image optimizer → Image optimizer: processes images
packages/image-optimizer/process.ts - Dev overlays → Dev controls: subscribes
packages/orchestra/index.tsx