How wackyweasel/universalcharactersheet works
Universal Character Sheet is a TTRPG character-sheet app built around managing characters and arranging configurable widgets on an infinite canvas. The main workflow starts in the app shell, selects a character or opens its sheet, and uses shared state to manage sheet data and formula-driven values. Storage workspaces can persist that data in browser storage, a local directory, or Google Drive. The graph includes documented offline installation and progress-clock capabilities; unsampled implementation links are omitted or marked unverified.
Main entry points: useStore.ts Character state · App.tsx App shell · useStorageWorkspaceStore.ts Workspace manager · DraggableWidget.tsx Widget arrangement
Components 25
Application
- App shell
src/App.tsx - Character manager
src/components/CharacterList.tsx - Offline support
src/pwa
Sheets and widgets
- Sheet canvas
src/components/Sheet.tsx - Widget arrangement
src/components/DraggableWidget.tsx - Widget experiences
src/components/widgets - Table editor
src/components/widgets/TableWidget.tsx - Dice tools
src/components/widgets/DiceRollerWidget.tsx - Formula display
src/components/InlineFormulaText.tsx - Dice physics
src/components/DicePhysicsOverlay.tsx
State and logic
- Character state
src/store/useStore.ts - Formula engine
src/utils/formulaEngine.ts - Table cell logic
src/utils/tableCells.ts - Character presets
src/presets/index.ts - Timeline history
src/store/useTimelineStore.ts
Storage and integrations
- Workspace manager
src/store/useStorageWorkspaceStore.ts - Workspace registry
src/workspaces/workspaceRegistry.ts - Browser storage
src/workspaces/providers/browserWorkspaceProvider.ts - Directory storage
src/workspaces/providers/directoryWorkspaceProvider.ts - Drive storage
src/workspaces/providers/googleDriveWorkspaceProvider.ts - Google authorization
src/workspaces/google/googleClient.ts - Storage warnings
src/components/StorageWarning.tsx - Quota tracking
src/store/useStorageWarningStore.ts - Storage monitor
src/utils/storageMonitor.ts
Other components
- Player
Connections 28
- Player → App shell: opens
README.md - App shell → Character state: reads state
src/App.tsx - App shell → Character manager: renders
src/App.tsx - App shell → Sheet canvas: renders
src/App.tsx - App shell → Dice physics: renders
src/App.tsx - App shell → Storage warnings: renders
src/App.tsx - App shell → Workspace manager: initializes
src/App.tsx - Sheet canvas → Widget arrangement: arranges widgets
- Widget arrangement → Character state: updates sheet
src/components/DraggableWidget.tsx - Widget arrangement → Widget experiences: renders widgets
src/components/DraggableWidget.tsx - Widget experiences → Character state: updates data
src/components/widgets/CheckboxWidget.tsx - Dice tools → Character state: updates rolls
src/components/widgets/DiceRollerWidget.tsx - Dice tools → Dice physics: uses physics
src/components/widgets/DiceRollerWidget.tsx - Table editor → Formula engine: evaluates formulas
src/components/widgets/TableWidget.tsx - Table editor → Table cell logic: uses cell logic
src/components/widgets/TableWidget.tsx - Formula display → Formula engine: displays formulas
- Character state → Formula engine: resolves formulas
src/store/useStore.ts - Character state → Character presets: loads presets
src/store/useStore.ts - Timeline history → Character state: reads character
src/store/useTimelineStore.ts - Workspace manager → Character state: coordinates data
src/store/useStorageWorkspaceStore.ts - Workspace manager → Workspace registry: selects provider
src/store/useStorageWorkspaceStore.ts - Workspace manager → Browser storage: loads and saves
src/store/useStorageWorkspaceStore.ts - Workspace manager → Directory storage: creates and loads
src/store/useStorageWorkspaceStore.ts - Workspace manager → Drive storage: uses provider
src/store/useStorageWorkspaceStore.ts - Workspace manager → Google authorization: authorizes access
src/store/useStorageWorkspaceStore.ts - Storage warnings → Quota tracking: shows status
src/components/StorageWarning.tsx - Quota tracking → Storage monitor: checks quota
src/store/useStorageWarningStore.ts - Player → Offline support: installs app
README.md