Build from source

Run the native app or work on the official website.

Desktop application

Install current stable Rust and full Xcode with the Metal compiler. The standalone Command Line Tools are not sufficient.

Bash
1git clone https://github.com/backrunner/mixless.git2cd mixless3./dev.sh --check4./dev.sh

The script finds an Xcode installation with Metal support; an explicit DEVELOPER_DIR takes precedence. Use ./dev.sh --build to build without launching. Development uses the normal local application library and does not watch files automatically.

The first build optimizes the audio engine and UI dependencies and can take longer. Rerun after changes. Mixless → About Mixless shows the version, Git revision, and build time.

Workspace

Area	Responsibility
`apps/desktop`	Native GPUI interface and application state
`mixless-engine` / `mixless-protocol`	Audio graph, transport, commands and snapshots
`mixless-library`	Local library, playlists and persisted data
`mixless-analyze` / `mixless-stems`	Offline music analysis and local inference
`mixless-mixplan`	Musical transition planning
`mixless-midi`	Controller mapping and input
`mixless-spotify` / `mixless-acquire*`	Playlist metadata and optional local audio acquisition
`mixless-tools`	Packaging and release helpers
`apps/site`	This svedocs website

The desktop UI does not implement DSP. Real-time processing stays in the audio engine.

Website

From the repository root, with Node.js 22.12+ and pnpm:

Bash
1pnpm -C apps/site install --frozen-lockfile2pnpm -C apps/site dev

The website uses svedocs and svedocs-cli 0.2.1 with a custom landing page, navigation, and theme. English content lives directly under content/docs and content/pages; Chinese mirrors it under each root's zh directory.

Bash
1pnpm -C apps/site check2pnpm -C apps/site check:content3pnpm -C apps/site build

The build emits a static site in apps/site/build. Set SITE_URL when building for a different domain. Run pnpm -C apps/site assets after changing the source screenshots or branding.

Contribute

Read CONTRIBUTING.md for checks and commit conventions, and RELEASING.md for signed macOS releases.

Mixless is licensed under MPL 2.0. Attribution and component licenses are listed in THIRD_PARTY_NOTICES.md.