How software-mansion-labs/goldie works
Goldie turns configured Argent flows into store-ready screenshots and preview videos: it checks the environment, captures simulator or emulator output, frames and renders assets, then verifies them against store specifications. Its browser studio previews and edits the design saved for subsequent CLI renders. The graph includes documented Android, iPad, font, bezel, and layout capabilities; some studio/server wiring and unsampled subsystem details are represented only where documented or left unconnected.
Main entry points: cli.ts Goldie CLI · render.ts Asset renderer · App.tsx Studio application · capture.ts Flow capture
Components 23
Capture workflow
- Goldie CLI
src/cli.ts - Device management
src/device.ts - Argent flow runner
src/argent.ts - Flow capture
src/capture.ts - Flow repair guidance
src/repair.ts - Raw captures
Design and rendering
- Layouts and templates
src/layouts.ts - Device bezels
src/frame.ts - Font registry
src/fonts.ts - Asset renderer
src/render.ts - Screenshot and video assets
- Store manifest
src/manifest.ts
Browser studio
- Studio server
src/studio-server.ts - Studio application
studio/src/App.tsx - Design controls
studio/src/components/DesignPanel.tsx - Screenshot strip
studio/src/components/Strip.tsx - Studio sidebar
studio/src/components/Sidebar.tsx - Saved design choices
studio/src/manifest.ts
Configuration and checks
- Config and scenes
src/config.ts - Environment doctor
src/doctor.ts - Store specifications
src/specs.ts
Other components
- User or agent
- iOS / Android devices
Connections 31
- User or agent → Goldie CLI: runs commands
README.md - Goldie CLI → Config and scenes: loads settings
src/cli.ts - Goldie CLI → Environment doctor: runs checks
src/cli.ts - Environment doctor → Device management: checks devices
src/doctor.ts - Goldie CLI → Device management: selects devices
src/cli.ts - Device management → iOS / Android devices: boots and prepares
src/device.ts - Flow capture → Device management: prepares device
src/capture.ts - Flow capture → Argent flow runner: runs flows
src/capture.ts - Argent flow runner → iOS / Android devices: replays on
README.md - Goldie CLI → Flow capture: starts capture
src/cli.ts - Flow capture → Raw captures: writes captures
src/capture.ts - Flow capture → Flow repair guidance: reports flow failures
src/capture.ts - Goldie CLI → Asset renderer: renders assets
src/cli.ts - Asset renderer → Raw captures: reads captures
src/render.ts - Asset renderer → Layouts and templates: uses geometry
src/render.ts - Asset renderer → Device bezels: uses bezels
- Asset renderer → Font registry: uses registered fonts
src/render.ts - Asset renderer → Store specifications: applies constraints
src/render.ts - Asset renderer → Screenshot and video assets: writes screenshots and video
src/render.ts - Goldie CLI → Store manifest: builds manifest
src/cli.ts - Store manifest → Screenshot and video assets: collects asset metadata
src/manifest.ts - Goldie CLI → Studio server: opens studio
src/cli.ts - Studio server → Studio application: serves browser studio
README.md - Studio application → Design controls: renders design controls
studio/src/App.tsx - Studio application → Studio sidebar: renders sidebar
studio/src/App.tsx - Studio application → Screenshot strip: renders screenshot strip
studio/src/App.tsx - Studio application → Store manifest: loads asset manifest
README.md - Studio application → Saved design choices: loads and saves choices
studio/src/App.tsx - Design controls → Saved design choices: edits design choices
studio/src/components/DesignPanel.tsx - Screenshot strip → Layouts and templates: resolves compositions
studio/src/components/Strip.tsx - Saved design choices → Config and scenes: informs CLI rendering
README.md