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.
PlaceOpen a system tab — New system on the start page — press Add component over the scene and pick a kind to drop it in. Drag it on the floor to arrange; the 3D / 2D switch shows the same machine as a schematic.
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) in the column on the right; open water inlets need a supply temperature. Altitude sets pressure.
SolveSolve system, in the same column: the 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: open an example system — Start from an example on the start page, or ＋ Open in the tab strip — press Solve system, then open the psychrometric chart. Every document is a tab: a system, a building, a component, a 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.
