How codelessly/codelesslysdk works
Project Type and Purpose
• This is a cross‐platform Flutter SDK (a Dart library) called Codelessly CloudUI™ SDK, designed to let Flutter apps render dynamic UIs and receive real-time updates from the Codelessly Editor/Cloud.
• It comprises two main parts:
• The SDK library under lib/src/...
• An example Flutter app under example/ demonstrating usage on Android, iOS, macOS, Windows, Linux, and Web.
Top-Level Architectural View
• Example App (Flutter front end)
• Initializes and configures the SDK
• Embeds CodelesslyWidget
• Supplies optional data/functions
• Codelessly SDK
• Initialization & Configuration (Codelessly.instance, CodelesslyConfig)
• Auth Module (auth_manager.dart)
• Data Module
– DataManager orchestrates between cloud_database.dart, firebase_data_repository.dart, network_data_repository.dart, local_database.dart, and web_data_repository.dart
• Cache Module (cache_manager.dart, codelessly_cache_manager.dart)
• Transformer Pipeline
– node_registry.dart, node_transformer_manager.dart, + many passive_*_transformer.dart
– Converts JSON layout definitions into Flutter widget AST nodes
• UI Renderer
– CodelesslyWidget, widget controller, dialog & error screens
• Functions Module (functions_repository.dart, async_functions.dart)
– Handles “Call Function” actions and hooks into app callbacks
• Logging & Metrics (debug_logger.dart, error_logger.dart, stat_tracker.dart)
• Utilities & Helpers (HTTP client, font parser, image builder, etc.)
• External Services
• Codelessly Cloud (real-time layout streaming, REST endpoints)
• Firebase (optional analytics/crash reporting via firebase_options_prod.dart)
Component Relationships & Data Flow
• The Example App → calls → Codelessly.instance.initialize(config)
• Auth Module ↔ Codelessly Cloud (auth token verification)
• Data Manager → fetch layout JSON → from Cloud / Firebase / Local Cache / Web Repo
• Cache Manager ← caches layout JSON for offline/preload
• Transformer Pipeline → parses JSON → produces widget node tree
• UI Renderer → builds Flutter widgets from node tree → displays on screen
• Functions Module ← registers callbacks → invoked by UI on user actions
• Logging ← collects logs & metrics → optionally reports to Codelessly backend
Architectural Patterns & Principles
• Modular Layers: clear separation of concerns (Auth, Data, Cache, Transform, UI, Functions, Logging)
• Repository Pattern in lib/src/data to abstract multiple data sources
• Transformer Pattern for pluggable widget node transformations
• Singleton / Facade via Codelessly.instance to expose SDK surface
• Plugin‐style Extensibility: add or override transformers, functions, data sources
Detailing & Labels
• Notes on preview vs. production mode branching at Initialization