📚 Modules

Modules that power GoGrab Space applications.

This section documents the modules that form the backbone of the GoGrab Space ecosystem, providing reusable components, services, and utilities that power our applications.

✅ Unified Documentation: This is now the single source of truth. External references to GoGrab-modules have been consolidated here.

🎯 Quick Start

🚀 The Revolutionary Approach

Hybrid Module Creation ⭐⭐⭐ START HERE - Visual Builder + Code-First = Production-Ready Modules in Minutes

Creating Modules

1. Module Creation Guide - Complete guide (Visual & Code-First)
2. Module Registration - How modules are discovered and loaded
3. Defining Modularity - Philosophy and architecture

Module Capabilities

4. Public Actions Guide - Creating cross-module actions
5. Embeddable Components Guide - Creating reusable widgets
6. User Management Reference - Complete working example

🏗️ System Architecture

Understanding how the pieces fit together:

1. Module System Architecture

The core orchestration layer.

• 8-Layer Architecture: From core to orchestration.
• Lifecycle Management: How modules load, start, and stop.
• Contracts: BrowserModuleContract and ModuleManifest.

2. Action System Architecture

The communication layer.

• Command Pattern: Decoupled execution.
• Circuit Breakers: Resilience and error handling.
• Action Registry: Auto-discovery of @PublicAction.

3. Widget System Architecture

The presentation layer.

• Grid Layout: Responsive CSS Grid system.
• Error Boundaries: Protecting the dashboard from widget failures.
• Integration: How modules provide embeddable widgets.

📋 Progress & Changes

Monorepo Unification

• Monorepo Synchronization - Status of unifying editor and foundation patterns.
• Consolidation Summary - Details of the documentation consolidation.

📦 Archive

• Archive - December 3, 2025 - Pre-consolidation documentation preserved for historical reference.
  • Contains 15 files archived during the complete consolidation effort
  • Includes old architecture docs, progress notes, and planning documents
  • ⚠️ Do not use for development - Use current documentation instead

🚨 Important Updates

December 3, 2025: Complete Documentation Consolidation

All gograb-modules documentation has been unified into the editor monorepo.

What Was Consolidated:

• ✅ Module System: Complete 8-layer architecture documented
• ✅ Action System: Command pattern, circuit breakers, public actions
• ✅ Widget System: Embeddables, grid layouts, responsive design
• ✅ Parameter System: Unified metadata system for inputs/outputs
• ✅ Mock API System: Development mocking infrastructure
• ✅ Reference Implementation: User Management as the gold standard
• ✅ Guides: Public actions, embeddables, creation patterns

New Documentation Files (December 3, 2025):

• modules/module-creation-guide.md - Complete creation guide
• modules/public-actions-guide.md - Action development
• modules/embeddable-components-guide.md - Widget development
• modules/user-management-reference.md - Reference example
• architecture/module-system.md - System architecture
• architecture/action-system.md - Action architecture
• architecture/widget-system.md - Widget architecture
• architecture/parameter-system.md - Parameter architecture
• architecture/mock-api-system.md - Mock API architecture

Result: ✅ Single source of truth - No need to reference external gograb-modules repo

Maintainer: Platform Team Status: ✅ Production Ready