Five Production Failures That Change How You Architect a Revit Add-in

The most expensive Revit failures are rarely syntax errors. They are mismatches between an otherwise reasonable application design and the host’s lifecycle, document state or transaction rules.

1. Treating the host like a stateless web page

Documents open, close, change and become unavailable. Views change. Commands are invoked from contexts with different capabilities. A production add-in needs explicit lifecycle handling and clear behavior when the active document is not ready.

2. Hiding transactions inside convenience code

Model changes must be grouped, named and recoverable. A transaction strategy that works for one button click can become fragile when a long-running operation mixes reads, writes, failures and user cancellation.

3. Ignoring the external event queue

Modeless UI and background work cannot reach into Revit whenever they want. External events provide the boundary, but the boundary needs a queue, cancellation behavior and a clear status model so the interface never promises a result that the host has not accepted.

4. Assuming one version of the API

Version-aware integration is a product concern. API differences, packaging, deployment and upgrade paths should be isolated behind deliberate adapters rather than spread through the interface and domain logic.

5. Treating model state as an implementation detail

Worksharing, permissions, linked models, stale caches and partial selections all affect the meaning of a result. A reliable tool reports the state it used and fails clearly when the state is not sufficient for the operation.

The architecture that survives

Keep the host adapter thin, put domain behavior in testable services, make state and evaluation explicit, and give the user a result that can be reproduced. A Revit add-in becomes easier to evolve when the product surface explains what happened instead of hiding the host’s complexity behind a spinner.

See the related Revit API notes and the production systems section in Selected Work.