Massing

Guides & tutorials

Plain-English, step-by-step. No BIM or real-estate-finance background needed β€” each tutorial takes about five minutes.

πŸ‘‹ Brand new? Open the live demo or the desktop app and take the built-in 60-second tour (the ? button, top-right). Then come back here for the deep dives.
Lifecycle coverage: one IFC model spans acquisition to turnover
One IFC model spans the whole lifecycle β€” the tutorials below follow it left to right.
Getting started 1 Β· Explore a model 2 Β· Generate from zoning 3 Β· Underwrite a deal 4 Β· Run a project 5 Β· Hand it over 6 Β· List & value it Glossary FAQ

Getting started β€” three ways to run it

🧊 Try it in your browser (nothing to install)

Open the live demo, switch to the Model workspace, and pick a sample from Open β–Ύ. The viewer runs entirely in your browser on bundled models.

πŸ’Ύ Free desktop app (full platform, offline)

Download the installer for Windows, macOS, or Linux. It's the whole platform in one app β€” no login, no Docker. Your data stays on your machine.

🐳 Server stack (teams)

For multi-user use, run the Docker stack β€” see the README.

Tutorial 1 Β· Explore a model

Learn to move around a 3D building and read its data.

  1. Open the app and make sure you're in the Model workspace (top bar).
  2. Click Open β–Ύ β†’ BasicHouse (or any sample). The building loads in the viewer.
  3. Orbit by dragging, pan with right-drag, zoom with the wheel. Click β€’ Fit to recenter.
  4. Click any element β€” its properties open on the right, grouped into Attributes, Quantities (areas / volumes / lengths) and each Property Set. Filter to find a field, click a row to copy it, or Copy all; the ⧉ button copies the element's permanent IFC GUID.
  5. Use the left rail: the tree (spatial breakdown), layers (show/hide by type), and βŠ™ Isolate / ⊞ Show all.
  6. Try Section (cut through the model) and Measure (distances/areas) from the toolbar.
  7. Need other formats? Open β–Ύ β†’ Open mesh / point cloud / GIS… loads OBJ/STL/PLY/glTF meshes, PCD/XYZ/LAS/LAZ point clouds, and GIS / topography (GeoJSON site vectors, GeoTIFF DEM terrain) as georeferenced overlays. Tap πŸ“± Share via QR to open the project on a phone or tablet.
  8. Layer & coordinate models (Navisworks-style): each reference model has a β›­ align panel (offset / Z-up flip / scale / move-to-point). Add discipline IFCs in the Coordination & QA panel (οΌ‹ Add discipline IFC), then πŸ”— Federated clash finds cross-discipline conflicts and files them as issues on the model.
There's nothing to "save" β€” the model is read from its IFC file. Edits you make (Tutorial 4+) are written back to IFC server-side, keeping every ID stable.
A dimensioned floor plan generated from the model
The same model also generates 2D drawings β€” dimensioned plans, sections, elevations, PDF sheets.

Tutorial 2 · Generate a building from zoning ⭐

The headline feature: turn a lot + zoning rules into a real building and a first-cut deal.

  1. Go to the Finance workspace β†’ Proforma tab.
  2. Find the πŸ—οΈ Generate from zoning panel. Enter your lot (width Γ— depth or area), FAR, setbacks, and a height limit.
  3. Tick the options you want: structural frame, unit layout (apartments on a corridor), facade envelope, service core.
  4. Click Estimate yield to preview the program (floors, units, GSF) and a starter proforma β€” instantly, without saving anything.
  5. Happy with it? Click Generate IFC model + apply. It builds a real IFC building, publishes it to the viewer, and loads the numbers into the live proforma.
  6. Switch to the Model workspace to see your generated building. Open Test Fit (back in Finance) to compare unit-mix schemes or ⚑ Optimize for the highest-yield layout.
A building rises floor by floor from a zoning envelope, then the deal is underwritten
Zoning in β†’ a real IFC building rises β†’ the deal is underwritten.
Inputs to an IFC massing model and acquisition proforma
πŸ’‘ The building is real openBIM β€” it flows straight into drawings, takeoff, the estimate, and the deal. One input, the whole chain.

Tutorial 3 Β· Underwrite a deal

Build the cost budget, balance the capital, and produce an investor package.

  1. In Finance, open the cost budget panel. Add line items by category β€” acquisition, hard (construction), soft (design/fees) β€” as $/unit Γ— quantity, with a contingency %.
  2. Click Apply to proforma β€” the budget rolls into the deal's cost tree.
  3. Open Sources & Uses to see the capital plan (debt sized to your LTC/LTV/DSCR, plus equity).
  4. Tune the drivers (rent, exit cap, hold). Watch the returns bar β€” IRR, equity multiple, yield-on-cost β€” update live. Guardrail badges flag anything outside market ranges.
  5. Open the Statements tab for full financial statements off the live deal: a stabilized income statement (rent β†’ NOI β†’ depreciation β†’ net income), a balance sheet that balances every year, a cash-flow statement, the tax at sale (depreciation recapture + capital gains β†’ an after-tax IRR), and the budget as a two-sided Uses ∣ Sources view.
  6. Click πŸ“„ Investment memo or πŸ“Š Pitch deck to generate a polished PDF from the live numbers.
  7. Once the job is live, track the capital: the developer dashboard reconciles the GC's GMP to your underwritten hard cost (one click to sync), models construction-loan draws (equity-first, with interest accrual), and exports a lender draw-request PDF. The portfolio view rolls returns up across every deal.
Modeling something unusual (e.g. on-site solar or a vertical farm)? The ⚑ Specialty panel adds those economics β€” and their revenue is automatically risk-adjusted so the IRR stays honest.

Tutorial 4 Β· Run a project (GC portal)

Manage construction β€” works even with no model loaded.

  1. Click οΌ‹ New in the top bar to create a project (no IFC needed).
  2. Go to the Construction workspace. You'll see the dashboard and a catalog of modules (RFIs, submittals, change orders, daily reports, inspections, safety…).
  3. Open RFIs β†’ οΌ‹ New, fill in the subject and question, and save. Use the workflow buttons (submit β†’ respond) to move it along.
  4. Contracts & change orders: open a Prime Contract, Subcontract, or Change Order record β†’ Generate the document (AIA-style PDF), Compose Exhibit A (scope from the clause library), View & markup to redline, and Sign (per-party typed signatures) β€” then approve via the workflow. Change orders show the original β†’ revised contract sum.
  5. Explore Board (kanban), filters, and the Related panel on a record (it links RFIs β†’ change events β†’ CORs automatically).
  6. Use Schedule for CPM/critical path, the takt chart, and the ⏱ 4D sequence slider to scrub the build in the viewer. ⏩ Accelerate (advisory) reads the critical path and suggests where to crash or fast-track work (advisory only β€” it never rewrites your schedule).
  7. Permitting β†’ πŸ› Import from city open data: pick a city (NYC Β· SF Β· Chicago Β· LA Β· Austin, more easily added), search by address or near the site, and import issued/filed permits straight into your permit log β€” owner, architect, GC, units, valuation and status come along, deduped on re-import.
  8. Pull a report: the Report Center renders an executive summary, cost, EVM, change-order, RFI, contracts and a risk digest β€” each as a PDF and an Excel workbook.
  9. Track health with the analytics dashboards (each a live tool and a PDF/Excel report): a quality dashboard (inspection pass-rate, NCR disposition→close loop, deficiency ball-in-court), RFI and submittal registers (ball-in-court / overdue / turnaround), a T&M rollup tied to change events, a field-log rollup (manpower / weather lost-days), an OSHA safety dashboard (TRIR / DART), and a closeout dashboard (punchlist, commissioning, warranties) — all stitched into an executive project-health rollup.
  10. Specifications β†’ submittals: keep your project manual in the Specification register (Preconstruction), then run Β§ Spec submittal log to derive the required submittals per CSI section β€” typed (shop drawing, product data, sample…) β€” and see which are missing against what you've logged, with a coverage %. ✨ Extract submittals from a spec turns pasted spec text into a typed submittal list (AI when an API key is set, a built-in parser otherwise) and, one click, logs them and builds the register straight from the spec book.
  11. Open Schedule β†’ Budget for the project GMP: it assembles automatically from your cost codes, committed subcontracts (buyout) and GC/GR staffing, plus overhead / fee / contingency. Each line carries budget β†’ committed β†’ actual β†’ forecast (EAC) and the variance, and reconciles to the prime contract. A cash-flow S-curve spreads it across the schedule.
  12. See cost on the model (5D): click any element for its 5D readout (cost code, budget, progress), or open the cost / progress heatmap to color the whole model by spend or % complete.
  13. Bill the owner: generate the pay application (G702/G703) PDF from the Schedule of Values β€” it draws straight from the budget lines, with retainage and stored-materials handled.
  14. Watch the Deadlines widget on the portal home β€” a cross-module feed of what's overdue or due this week across RFIs, submittals, change orders, inspections and more.
  15. Ask the "Ask AI" box plain-English questions like "what's overdue?" or "are we over budget?"
Workflow buttons stay disabled until the required fields are filled (an RFI can't be Answered without an answer), and every record view shows a workflow map β€” a small state diagram of where the record is and what moves it forward.
Working with a team? Invite members from the account menu and give each a capability role (viewer β†’ admin, gates what they can edit) and a party role (GC, Owner, Owner's Rep, Consultant, Subcontractor β€” sets their default view and who can move a workflow forward).
A Gantt schedule generated from the project's activities
Schedule views (Gantt + line-of-balance) generate from the project's activities.

Tutorial 5 Β· Hand it over (turnover)

Close the project out and produce the handover package.

  1. Work the Punchlist: open an item, mark it ready, attach a photo, then verify (verification requires the photo β€” an evidence gate).
  2. Record commissioning, as-builts, warranties, and the completion certificate.
  3. Export COBie (the standard facilities-handover spreadsheet), the QTO, and a one-click turnover package (as-built IFC + COBie + closeout docs).

Tutorial 6 Β· List & value it

Take the finished (or off-plan) building to market and put a defensible value on it.

  1. In Finance, open the Listing panel and click Auto-fill from model + proforma. It pulls the address, areas, unit mix, amenities and price straight from the IFC model and the deal β€” no retyping.
  2. Generate the marketing fact sheet PDF (a BIM-native Listing Fact Sheet), then Share to get a signed public link + QR code β€” read-only, so you can market a building off-plan before it's built.
  3. Open the Valuation tab to appraise it three ways β€” cost, income, and sales-comparison cards β€” then set the reconciliation weights to blend them into a final value. Import comparables (paste CSV or upload β€” RESO field names work too) to feed the sales approach, and download the Valuation report (PDF or Excel).
  4. Once you own and operate it, the Operations tab is a live rent roll (occupancy, WALT, in-place income) plus lease management β€” renewal/expiration pipeline, rent-escalation schedule and CAM/expense-recovery reconciliation. The Investors tab holds the cap table, runs capital calls / distributions and an equity-waterfall distribution scenario (pref β†’ return of capital β†’ promote, allocated per investor), and mints a signed, no-login link to each investor's statement.
πŸ’‘ The listing is RESO-aligned: export the listing or, with the optional WPRealWise / MLS syndication bridge configured, push it to your MLS/portal directly β€” no re-keying for your broker.

Glossary β€” plain English

IFCThe open file format for building models. The platform's "source of truth" β€” every record points at an element's permanent IFC ID.
BIMBuilding Information Modeling β€” a 3D model that also carries data (materials, costs, properties), not just shapes.
FARFloor Area Ratio β€” how much building floor area zoning allows per unit of land. FAR 3 on a 10,000 sf lot β‰ˆ 30,000 sf of building.
SetbackHow far a building must sit back from the property lines.
MassingThe basic size/shape of a building before detailed design β€” what "generate from zoning" produces.
ProformaThe financial model of a development β€” costs in, rent/sale out, returns calculated.
Hard / soft costsHard = physical construction. Soft = design, fees, permits, financing. Roughly 70–80% / 20–30%.
Sources & UsesWhere the money comes from (debt + equity) vs where it goes (land + construction + soft costs).
NOINet Operating Income β€” rent minus operating expenses. The basis for value.
Cap rateNOI Γ· value. Lower cap = higher value. Used to estimate sale price at exit.
IRR / Equity multipleIRR = annualized return %. EM = total cash back Γ· cash in (e.g. 1.9Γ—).
Yield on costStabilized NOI Γ· total project cost β€” the developer's "did this pencil?" number.
RFIRequest for Information β€” a formal question to the design team during construction.
Pay app (G702/G703)The standard monthly billing forms a contractor submits for payment.
GMPGuaranteed Maximum Price β€” the capped contract sum: cost of the work + the GC's fee. The platform builds it up from cost codes, buyout and staffing, plus markups.
Cost code / SOVCost code = a budget bucket (often by CSI division). Schedule of Values = the billing breakdown the pay app draws from β€” here it's seeded straight from the budget.
BuyoutAwarding subcontracts against the budget. The difference between the budget and what you actually commit is buyout savings (or overrun).
EAC / forecastEstimate At Completion β€” what a line will ultimately cost given progress and committed amounts. Drives the over/under variance.
5DThe 3D model + time (4D) + cost. Click an element to see its cost, or color the model by spend or % complete.
Loan drawA scheduled withdrawal from the construction loan to pay for work in place β€” modeled equity-first, with interest accruing on the balance.
Takt / Line of BalanceScheduling where each trade moves floor-to-floor at a steady pace β€” the "assembly line" approach.
4DThe 3D model + time β€” scrub a slider to see what's built on any day.
COBieThe standard spreadsheet handed to the building's operator at turnover (assets, warranties, manuals).
Clash / IDSClash = two elements overlapping. IDS = a checklist your model must satisfy (data quality).
AppraisalA defensible estimate of a property's value β€” here done three ways (cost, income, sales-comparison) and reconciled into a final number.
RESOReal Estate Standards Organization β€” the common data dictionary MLS systems use, so a listing's fields export cleanly for an MLS push.
Listing / days-on-marketThe marketing record for a property offered for sale. Days-on-market = how long it's been listed.
Comp (sales comparable)A recently sold, similar property used to estimate value by comparison in the sales-comparison approach.

FAQ

Do I need Revit or any paid software?

No. The platform is open and IFC-native. You can bring Revit models in three ways: (1) the free Massing for Revit pyRevit add-in β€” one click Massing β–Έ Publish to Massing (uses the API, so it needs a Commercial licence); (2) Revit's built-in File β–Έ Export β–Έ IFC then Open IFC… (free on any plan); or (3) the paid Autodesk bridge to drop a raw .rvt directly. IFC and Fragments load free and offline.

Is my data private?

On the desktop app, everything stays on your machine. The server stack is self-hosted β€” you run it.

Can I use just one part β€” say, only the proforma or only the GC portal?

Yes. Create a blank project (οΌ‹ New) and use the Finance or Construction workspace on its own β€” no model required.

Can a team work on the same project?

Yes (on the connected/server stack). Invite members and give each a capability role (viewer β†’ admin) and a party role (GC, Owner, Owner's Rep, Consultant, Subcontractor). The party role tailors their view and controls who can advance a workflow; the capability role gates what they can edit.

What does it cost?

The single-project desktop app is free with no per-seat license. A paid connected/cloud tier is planned.

Can I list or appraise the building?

Yes. The Finance workspace auto-fills a RESO-aligned Listing from the model + proforma, generates a marketing fact sheet PDF and a signed public link/QR (even off-plan), and the Valuation tab appraises the building three ways (cost, income, sales-comparison) into a reconciled final value with a downloadable report.

How do I get help?

Re-open the in-app tour with the ? button, or file an issue on GitHub.