How openc4rd/opencard works
OpenCard is a desktop card-design workbench. Its documented workflow is to open a project, define a reusable card blueprint, create and edit instances, manage shared fonts/icons/dictionary text, and iterate or export. The graph preserves those domain stages and major supporting capabilities. Edges from the README reflect documented workflow; source-level edges use the supplied excerpts or SOURCE INDEX. Unsampled subsystems are represented by supported directory paths, with uncertain implementation links omitted.
Main entry points: renderPipeline.ts Render preparation · projectStore.ts Project state · main.ts Desktop application · model.ts Card blueprint
Components 20
App shell
- Desktop application
opencard-app/src/main.ts - Workspace navigation
opencard-app/src/features/shell/OpenCardShell.vue
Project workspace
- Project state
opencard-app/src/features/workspace/store/projectStore.ts - Project file access
opencard-app/src/features/workspace/services/fileSystemService.ts - Project structure
opencard-app/src/features/workspace/model/projectStructure.ts
Card design
- Card blueprint
opencard-app/src/entities/card/model.ts - Card instances
opencard-app/src/entities/card/instance.ts - Visual editor
opencard-app/src/features/card-designer/CardDesignEditor.vue - Render preparation
opencard-app/src/features/card-rendering/renderPipeline.ts - Card canvas rendering
opencard-app/src/features/card-rendering/components
Shared resources
- Project dictionary
opencard-app/src/features/workspace/model/projectDictionary.ts - Font resources
opencard-app/src/features/workspace/model/projectFontRegistry.ts - Icon resources
opencard-app/src/features/workspace/services/projectIconCatalog.ts - Resource packages
opencard-app/src/features/workspace/model/resourcePackage.ts - Network resource cache
opencard-app/src/features/network-resources/services/networkResourceCacheService.ts
Supporting capabilities
- Project export
opencard-app/src/features/exporting/exportRunner.ts - Project templates
opencard-app/src/features/project-templates/services/projectTemplateService.ts - Version control
opencard-app/src/features/version-control/gitService.ts - Feedback service
services/feedback-worker/src/index.ts
Other components
- Card designers
Connections 23
- Card designers → Desktop application: uses
README.md - Desktop application → Workspace navigation: starts
- Workspace navigation → Project state: opens project
README.md - Project state → Project file access: reads project
- Project state → Project structure: uses structure
- Card designers → Card blueprint: designs
README.md - Card designers → Visual editor: edits visually
README.md - Visual editor → Card blueprint: edits blueprint
- Card blueprint → Card instances: creates instances
README.md - Card designers → Card instances: fills content
README.md - Render preparation → Card instances: applies instance
opencard-app/src/features/card-rendering/renderPipeline.ts - Render preparation → Card canvas rendering: prepares render
- Render preparation → Icon resources: resolves icons
opencard-app/src/features/card-rendering/renderPipeline.ts - Render preparation → Project dictionary: resolves bindings
opencard-app/src/features/card-rendering/renderPipeline.ts - Card designers → Project dictionary: maintains text
README.md - Card designers → Font resources: registers fonts
README.md - Card designers → Icon resources: registers icon sets
README.md - Project state → Resource packages: manages packages
- Card designers → Project export: exports project
README.md - Card designers → Project templates: uses templates
- Card designers → Version control: uses Git
README.md - Desktop application → Network resource cache: prunes cache
- Card designers → Feedback service: submits feedback