Overview

Symphony uses a three-tier extension architecture designed to support scalable, modular, and flexible development across the IDE. The tiers are:

1. Global Extension System – Located at the root level; handles centralized, IDE-wide functionality.
2. Shared Extensions Package – Resides in the frontend monorepo; serves as a bridge and shared service layer.
3. Component-specific Extensions – Located within individual components; enables localized extension logic and behavior.

This design ensures separation of concerns, reusability of shared logic, and ease of integration for new features.

1. Global Extension System

Directory: symphony-ide/extensions/

• Purpose: Hosts centralized features applicable across the entire IDE.
• Contains:
  • registry/: Handles global registry logic, lifecycle management, and extension points.
  • builtin/: Built-in extensions like themes, keybindings, and AI features.

Key Files:

• registry.ts: Global registry implementation.
• extension-points.ts: Defines extension interfaces.
• lifecycle.ts: Manages loading/unloading lifecycle.

2. Shared Extensions Package

Directory: frontend/shared/extension-bridge/

• Purpose:
  • Acts as a bridge between global and component-specific extensions.
  • Provides shared utilities, services, and React hooks.

Key Files: