Developer Reference

This section provides technical documentation for developers working on Oscilla itself or extending it with new cue types, control systems, or integrations. It covers the internal architecture, module organisation, synchronisation protocol, and the patterns used throughout the codebase.

These pages assume familiarity with the user-facing features documented in the preceding sections. Where a user doc explains what a feature does, the corresponding developer doc explains how it is implemented and how to modify or extend it.

Topics

• Architecture Overview
• Cue System -- dispatcher, handlers, lifecycle
• Adding a New Cue
• Live Console -- panel, remote execution, cue browser
• Timer Sync
• Client Persistence & Sync
• State Persistence -- drag positions, visibility, presets
• Sync Architecture
• New Project Flow
• propagate() Internals -- preprocessor, compound cues, live re-expansion, splitCueId
• DSL Inspector -- hit detection, save paths, propagate redirect

Tip: use ← → or ↑ ↓ to navigate the docs