Celestrian

An open-source Digital Audio Workstation (DAW) built with JUCE and modern web technologies.

Getting Started

Prerequisites

• CMake (3.22 or higher)
• A modern C++ compiler (supporting C++20)
• JUCE dependencies (automatically handled via CPM)

Build Instructions

1. Configure the project:

   cmake -B build

2. Build the application:

   cmake --build build --parallel 8

3. Run the application: On macOS:

   open build/Celestrian_artefacts/Celestrian.app

Running Unit Tests

Celestrian includes a suite of unit tests built with the juce::UnitTest framework.

# Build the test target
cmake --build build --target CelestrianTests

# Run the tests
./build/CelestrianTests_artefacts/CelestrianTests

Development

• Source Code: src/ (C++20, JUCE 8)
• UI: ui/ (HTML/CSS/JS)
• Design Docs: .agent/design_doc.md