How scratchfoundation/scratch-gui works
Scratch GUI is a React interface for creating and running Scratch 3.0 projects. The user-facing workflow enters the editor, presents project controls and visual programming tools, and runs the project through the Scratch VM. The map also preserves asset editing and libraries, tutorials, cloud support, and state management. The README and excerpts establish the main UI and several integrations; unsampled subsystems are represented only where the tree and source index support them, so some connections are intentionally omitted.
Main entry points: containers/gui.jsx GUI container · index.js GUI entry · gui/gui.jsx Editor layout · blocks.jsx Block workspace
Components 30
Application shell
- GUI entry
src/index.js - App state
src/lib/app-state-hoc.jsx - Editor layout
src/components/gui/gui.jsx - GUI container
src/containers/gui.jsx - Menu bar
src/components/menu-bar/menu-bar.jsx
Project editor
- Block workspace
src/containers/blocks.jsx - Toolbox generation
src/lib/make-toolbox-xml.js - Block integration
src/lib/blocks.js - Target pane
src/containers/target-pane.jsx - Stage view
src/containers/stage.jsx - Costume editor
src/containers/costume-tab.jsx - Sound editor
src/containers/sound-editor.jsx - Sound editor UI
src/components/sound-editor/sound-editor.jsx
Project runtime
- VM lifecycle
src/lib/vm-manager-hoc.jsx - Scratch VM
- Audio engine
- Cloud connection manager
src/lib/cloud-manager-hoc.jsx - Cloud provider
src/lib/cloud-provider.js
Content and assets
- Asset libraries
src/components/library/library.jsx - Tutorial decks
src/lib/libraries/decks/index.jsx - Backpack
src/containers/backpack.jsx - Project and asset storage
src/lib/storage.js
State management
- GUI state
src/reducers/gui.js - Project state
src/reducers/project-state.js - Alert state
src/reducers/alerts.js - Tutorial state
src/reducers/cards.js - Editor tab state
src/reducers/editor-tab.js - Locale state
src/reducers/locales.js - Modal state
src/reducers/modals.js
Other components
- Project creator
Connections 29
- Project creator → GUI entry: opens editor
- GUI entry → GUI container: exports
src/index.js - GUI entry → App state: exports
src/index.js - GUI entry → GUI state: registers reducer
src/index.js - GUI entry → Locale state: registers reducer
src/index.js - GUI container → Editor layout: renders
src/containers/gui.jsx - Editor layout → Block workspace: renders
src/components/gui/gui.jsx - Editor layout → Target pane: renders
src/components/gui/gui.jsx - Editor layout → Stage view: renders stage wrapper
src/components/gui/gui.jsx - Block workspace → Block integration: initializes
src/containers/blocks.jsx - Block workspace → Toolbox generation: generates toolbox
src/containers/blocks.jsx - GUI container → VM lifecycle: composes lifecycle
src/containers/gui.jsx - VM lifecycle → Scratch VM: initializes and loads
src/lib/vm-manager-hoc.jsx - VM lifecycle → Audio engine: attaches engine
src/lib/vm-manager-hoc.jsx - Cloud connection manager → Cloud provider: creates provider
src/lib/cloud-manager-hoc.jsx - Cloud connection manager → Scratch VM: sets cloud provider
src/lib/cloud-manager-hoc.jsx - GUI container → Project state: reads project state
src/containers/gui.jsx - GUI container → Project and asset storage: configures storage
src/containers/gui.jsx - Costume editor → Asset libraries: uses asset panel
src/containers/costume-tab.jsx - Sound editor → Sound editor UI: renders editor
src/containers/sound-editor.jsx - Asset libraries → Tutorial decks: loads deck data
src/components/library/library.jsx - Editor layout → Menu bar: renders
src/components/gui/gui.jsx - GUI container → GUI state: connects state
src/containers/gui.jsx - Block workspace → Editor tab state: dispatches tab change
src/containers/blocks.jsx - Cloud connection manager → Alert state: shows cloud alert
src/lib/cloud-manager-hoc.jsx - GUI container → Modal state: connects modal state
src/containers/gui.jsx - GUI container → Tutorial state: connects tutorial state
src/containers/gui.jsx - Backpack → Project and asset storage: uses asset storage
- Project and asset storage → Project creator: reads and writes remotely