How hkpc-labs/snapcode-suite works
Snapcode is a visual Flutter-app authoring product, represented here by both its Windows IDE and a web editor/worker implementation. The main workflow is designing UI or Blockly logic, generating Dart, preserving developer edits, and running the Flutter project on a discovered device. The README documents the desktop compile-and-run path; source-index references and excerpts support the specific implementation links shown. Some web/worker wiring and unsampled desktop view interactions are not verified, so those connections are omitted.
Main entry points: EditorPage.jsx Web Editor · ProjectService.cs Project Files · FlutterCompilerService.cs Flutter Compiler · UserCodePreservationService.cs Code Preservation
Components 29
Windows IDE
- UI Designer
src/Views/NativeUIDesigner.xaml.cs - Editor Page
src/Views/EditorPage.xaml.cs - Project Files
src/Services/ProjectService.cs - Page Metadata
src/Models/PageMetadata.cs - Project Templates
src/Services/TemplateService.cs - Flutter Compiler
src/Services/FlutterCompilerService.cs - Code Preservation
src/Services/UserCodePreservationService.cs - Dart Formatter
src/Services/DartFormatterService.cs - Asset Manager
src/Views/AssetManagerDialog.xaml.cs - Asset Service
src/Services/AssetService.cs - Project Explorer
src/ViewModels/ProjectExplorerViewModel.cs - Device Manager
src/Views/EmulatorManagerDialog.xaml.cs - Device Discovery
src/Services/DeviceService.cs
Web Editor
- Web Editor
snapcode-frontend/src/pages/EditorPage.jsx - Blockly Canvas
snapcode-frontend/src/components/BlockEditor.jsx - Dart Generator
snapcode-frontend/src/blockly/generators/dartGenerator.js - Code Preview
snapcode-frontend/src/components/CodePreview.jsx - Export Panel
snapcode-frontend/src/components/ExportPanel.jsx - Authentication
snapcode-frontend/src/contexts/AuthContext.jsx - API Client
snapcode-frontend/src/services/api.js
Cloud Workers
- Token Verification
snapcode-workers/src/middleware/auth.js - Project State Worker
snapcode-workers/src/state-worker.js - Build Consumer
snapcode-workers/src/consumer-worker.js - Project Builder
snapcode-workers/src/codegen/projectBuilder.js - Dart Emitter
snapcode-workers/src/codegen/dartEmitter.js
Flutter Toolchain
- Flutter Runner
src/Services/FlutterExecutionService.cs
Other components
- Developer
- Target Device
- Firebase Auth
Connections 26
- Developer → UI Designer: designs UI
- Developer → Web Editor: authors project
- UI Designer → Flutter Compiler: compiles layout
- Editor Page → Project Files: manages project
- Project Files → Page Metadata: loads metadata
src/Services/ProjectService.cs - Project Templates → Project Files: creates project
src/Services/TemplateService.cs - Project Files → Flutter Compiler: generates Dart
src/Services/ProjectService.cs - Project Files → Code Preservation: saves preserving code
src/Services/ProjectService.cs - Flutter Compiler → Code Preservation: preserves edits
- Code Preservation → Dart Formatter: formats Dart
src/Services/UserCodePreservationService.cs - Flutter Compiler → Dart Formatter: formats output
src/Services/FlutterCompilerService.cs - Asset Manager → Asset Service: imports assets
src/Views/AssetManagerDialog.xaml.cs - Developer → Device Manager: selects device
- Device Manager → Device Discovery: scans devices
src/Views/EmulatorManagerDialog.xaml.cs - Flutter Compiler → Flutter Runner: produces app code
- Flutter Runner → Target Device: runs app
- Web Editor → Blockly Canvas: renders canvas
snapcode-frontend/src/pages/EditorPage.jsx - Web Editor → Dart Generator: generates Dart
snapcode-frontend/src/pages/EditorPage.jsx - Web Editor → Code Preview: shows generated code
snapcode-frontend/src/pages/EditorPage.jsx - Web Editor → Export Panel: offers export
snapcode-frontend/src/pages/EditorPage.jsx - Authentication → Firebase Auth: authenticates users
snapcode-frontend/src/contexts/AuthContext.jsx - Authentication → API Client: syncs user
- API Client → Token Verification: sends bearer token
- Project State Worker → Token Verification: verifies requests
snapcode-workers/src/state-worker.js - Build Consumer → Project Builder: builds project
snapcode-workers/src/consumer-worker.js - Project Builder → Dart Emitter: emits Dart
snapcode-workers/src/codegen/projectBuilder.js