Documentation
Everything here reflects what the product actually does today. If something disagrees with the app, the app wins — and we'd like to hear about it: leads@hvacbuilder.app.
Getting started
A system is a graph of components joined by typed ports. The 3D scene is a view of that graph — positions are cosmetic; only connections matter to the solver.
PlaceClick a component under Components — the first group of the left-hand list — to drop it into the scene. Drag on the floor to arrange.
ConnectClick a port sphere, then a matching port on another component. Ports are typed — air (grey), water (blue), refrigerant (green) — and direction-checked; incompatible connections are refused.
Set boundariesEvery open air inlet needs entering air (dry-bulb / wet-bulb °C) in the right panel; open water inlets need a supply temperature. Altitude sets pressure.
SolveThe full thermodynamic balance: per-component states, duties, compressor operating point, totals. Non-convergence is reported as an error, never a silent partial result.
Fastest orientation: load an example (left panel), press Solve, then open the psychrometric chart. Every configuration field explains itself on hover (dotted underline), and the ones that need more than a tooltip carry a ? link into the reference.
