@openwork/ui
Shared UI primitives for OpenWork apps.
This package ships one entrypoint: @openwork/ui/react, used by apps/app
and ee/apps/den-web. (A Solid flavor existed during the Solid-to-React
migration and was removed once the last Solid consumer disappeared.)
Exports resolve to src/ directly, so consumers need no build step.
Paper components
The first shared components live under the paper namespace and wrap Paper Design shaders with OpenWork-specific defaults and deterministic seed support.
Current components:
PaperMeshGradientPaperGrainGradientOpenWorkRoadmapDownloadOpenWorkCard
Both accept a seed prop. Pass a TypeID-like string such as om_01kmhbscaze02vp04ykqa4tcsb and the component will deterministically derive colors and shader params from it. The same seed always produces the same result.
Explicit props still work and override the seeded values, so the merge order is:
- OpenWork defaults
- Seed-derived values from
seed - Explicit props passed by the caller
Roadmap component
OpenWorkRoadmap is the shared visual roadmap used by the landing and docs
routes. Its typed sections are exported as roadmapSections so other OpenWork
surfaces can reuse the same source of truth.
Layout convention
These components default to fill={true}, which means they render at width: 100% and height: 100%. Put them inside a sized container and they will fill it without needing manual width or height props.
Agent notes
- Shared seed logic lives in
src/common/paper.ts - React wrappers live in
src/react/paper/* - Prefer extending the existing seed helpers instead of inventing per-app one-off shader configs