Guide

Where the fixes live

Adobe's apps aren't broken: they run fine on Windows. Wherever they misbehave under Wine, the gap is on Wine's side, and that's where Neutron patches.

The stack is five tiers:

Cockpit — entry points

The Collider GUI, the Mud Hut installer, or a plain terminal. Nothing here owns compatibility logic.

Contract — the neutron CLI

A hard boundary. Calls travel down; status comes back as JSON. Above the line: convenience. Below the line: compatibility.

Engine — Neutron

Owns prefixes, environment, registry, Wine-binary selection, and each app's launch settings.

Runtime

Neutron-Wine carries the fixes and hosts the Adobe application alongside DXVK, vkd3d-proton, the dcomp bridge, and the nvcuda wrapper.

Substrate

Vulkan, your GPU, and the Linux kernel.

Because the launcher and installer sit above the contract line, they can be rewritten or removed without touching a single fix — and every fix Neutron gains reaches all three entry points at once.