ConstructCraft

The interface: ribbon, commands and palette

Versão em português: interface.pt-BR.md.

ConstructCraft’s window follows the layout desktop CAD and BIM users expect. The quick access toolbar sits at the top left. Below it is the ribbon, a row of tabs with groups of buttons. The options bar for the active tool comes next. The project browser and properties are docked on the left, the views fill the tabs in the middle, and the status bar is at the bottom. The project browser and properties start stacked on the left; drag a panel’s header to dock it on either side: onto the strip along the window’s left or right edge for a column of its own there, onto the top or bottom half of the other panel to stack it above or below, or onto its left or right half for a column of its own beside it. The area the panel will take is highlighted while dragging, and Esc cancels. Right-clicking a header offers the same choices (Dock on the left, Dock on the right, Stack with…, Separate from…) and Reset panel layout, also in Preferences → Interface. The layout is kept between sessions. When many views are open, Close Inactive Views (in the quick access toolbar and in View → Windows) closes every tab but the active one, and right-clicking a tab offers Close Other Views. The arrow at the right end of each tab bar (Open Views) lists the views open in that bar, grouped by view type as in the project browser, with the active one checked: picking one brings its tab to the front and scrolls it into view. Below the list, Close Other Views closes the bar’s other tabs and Close All Views all of them. The mouse wheel over a crowded tab bar scrolls its tabs. Closing the last open view closes the project and returns to the home screen, asking first when there are unsaved changes.

Opening a project and importing a file (IFC, DWG/DXF, SketchUp, OBJ, glTF, pictures and SVG, component files) read it in the background: a dialog shows the operation, the file’s name, folder and size and the time elapsed, with a spinner, and keeps the rest of the window from being used. The open project stays as it was until the file has been read; Cancel (or Esc) stops waiting and changes nothing.

A new project (New in the quick access toolbar and on the home screen, Ctrl+N) starts from a template: the New Project dialog offers the Metric System (meters, 1:50 and 1:100 scales, A sheets) and the Imperial System (feet and inches, 1/4” = 1’-0” scales, ANSI and ARCH sheets, ANSI B to start) as two cards. Click one and Create, or double-click it; the template picked last is picked first next time. With unsaved changes, the question about them comes after Create, and Cancel in either leaves the open project as it is. In an imperial project the scale pickers (view properties, view templates, the Callout tool) offer the architectural and engineering scales (1/4" = 1'-0", 1" = 20'-0"…) and views, sheets and the view’s toolbar write scales that way; a scale outside the list still shows as 1:N. Sizes on paper (dimension and level mark text sizes, dimension style marks and gaps, pen weights, text note widths, viewport positions, custom paper, drafting fill patterns) read and are typed in inches in an imperial project (3/32", pen weights as 0.010"); a bare number is inches, and mm or cm after it still give millimeters. Title block and detail component piece fields stay expressions in millimeters.

Measurement systems. Everything measured follows the project’s units (Manage → Project Units), so switching them between metric and imperial (the Imperial (US) button there) changes every display at once. In an imperial project lengths read in feet and inches (12'-6 1/2"), while small sizes — layer and slab thicknesses, section sides, diameters, risers and treads, tray sections, profile dimensions — read in inches without feet (3/4", 1 1/4", 16") and a bare number typed in those fields is inches; areas and volumes read in square and cubic feet, slopes as the rise per 12 of run (6:12, typed as 6:12, 6/12 or 6; Rise per 12 is also offered to metric projects), masses in pounds (lb, lb/ft for profiles, lb/ft² for roof coverings), densities in lb/ft³, strengths in ksi, pipe flows in gpm, section properties in in², in⁴, in³ and in, the site map’s scale in feet and miles. Schedule headers name no unit there (Length, not Length (m)), since the values carry their own marks. Things made on demand get round imperial sizes and names without metric units: the baseboard (4”), ramp (4’-0”, with 1:12 slope, 30” rise and 60” landing rules), cable tray (8” × 4”), lightning conductor (Ø3/8”), curtain wall (5’-0” grid, 2” × 6” mullions) and door types (2’-8” × 6’-8”), and the devices; new walls are 10’-0” tall, pipes and devices sit at round heights, drains fall 1/4” per foot up to 3” and 1/8” above, and free points snap to 1/2” to 20’-0” steps by zoom. The imperial template’s stair follows the customary limits (risers up to 7 3/4”, treads of 10” or more, 2R + T between 24” and 25”), its dimension style uses round inches, and its library components are sized in whole inches. What stays metric: conductor cross-sections (mm²), materials’ thermal properties, model fill patterns, the profile catalog’s designations (W150x13), and expressions (component, title block and profile sketches keep the units they are written in).

Dialogs open in the middle of the window and can be moved by dragging their title; a dialog opens centered again the next time. A dialog is as wide as its buttons and its contents need.

Commands and their tooltips

Every button in the ribbon and the quick access toolbar runs an interface command. So does every two-letter shortcut and every entry of the command palette. Each command defines, in one place:

Hover over a button to see its tooltip:

Move  [MV]
Moves the selected elements from a base point to a target.
Unavailable: Select the elements before using the tool
Engine command: elements_move

Buttons that cannot run are greyed out, and their tooltip gives the reason. Typical reasons are “nothing to undo”, “select the elements first”, “open a sheet to export it”, “select one text note” and “copy elements first”. A shortcut typed when its command cannot run shows the same reason in the status bar.

Icons and badges

Icons are drawn in two tones: the strokes in the text color and the soft fills in the theme’s accent tint. A small badge in the bottom-right corner marks what kind of action a command is:

Badge Meaning Examples
green + creates something new new floor or ceiling plan, 3D view, legend, drafting view, schedule, sheet, new component
blue arrow down brings data in from a file Import IFC, Import CAD, Load component
blue arrow up writes data out to a file Export PDF, Export SVG, Export Image, Export DXF
red − removes something Delete

The selected tool is highlighted in the accent color. Unavailable commands are greyed out, badges included.

Collapsing the ribbon

To give the views more room, collapse the ribbon to its tab titles. Any of these collapses it or expands it again:

While the ribbon is collapsed, a click on a tab shows that tab’s panel over the views. The panel closes when a command runs, when you press Esc or click elsewhere, or when you click the same tab again. Whether the ribbon starts collapsed is set in Preferences → Interface.

Narrow windows

When the window is narrower than a tab’s groups, the groups scroll sideways instead of being cut off. Arrows appear at both ends of the row: click them to scroll, or use the mouse wheel. Each arrow is greyed out once that end is reached.

Command palette

Ctrl+Shift+P opens the command palette, as does the magnifier at the right end of the tab row. Type part of what you are looking for. The search ignores case and accents (“niveis” finds “Níveis”), and every word you type must match. The palette finds:

Use ↑ and ↓ to choose and Enter to run, or click an entry. Esc closes the palette. An unavailable command stays in the list, greyed out, with its reason in place of the description.

Running engine commands

Choosing an engine command opens a form with its description and its arguments in JSON, already filled with the required fields:

{
  "elevation": 9.0,
  "name": "Roof deck"
}

Run (or Ctrl+Enter) executes the command in the open project and shows its result or error message. An edit is one undo step and is recorded while a macro is recording, like any other change. Back (or Esc) returns to the search. The arguments are the same as in scripts and in the command reference. Lengths are in meters, angles in degrees, points are [x, y], and levels, types, views and materials can be named by id or by name.

The engine’s file commands (project_open, project_save, ifc_import, ifc_export, sheet_export, view_export…) are not offered here. Their interface commands in the File and Insert tabs and the palette handle files through the usual dialogs.

Keyboard

Key Action
Ctrl+Shift+P Command palette
Ctrl+F1 Collapse / expand the ribbon
Ctrl+, Preferences
Ctrl+N / Ctrl+O / Ctrl+S / Ctrl+Shift+S / Ctrl+W New / Open / Save / Save as / Close project
Ctrl+Z / Ctrl+Y Undo / Redo
Ctrl+X / Ctrl+C / Ctrl+V Cut / Copy / Paste
Delete Delete the selection
Esc Cancel the operation, leave the tool, clear the selection
Backspace While drawing a chain of walls, beams, pipes, conduits, cable trays or lightning conductors: take back the last segment and go on from its start (Ctrl+Z too; Ctrl+Y puts it back); a railing’s last point
Space Rotate or flip the selection or the element being placed; with walls selected, flip them (swap their exterior and interior sides); while drawing a wall, flip the side of the walls drawn next

Two-letter keys work while a view has the focus and no text field is being edited. The README lists them all. Each tooltip shows its own shortcut as well.

In 2D and 3D views the mouse wheel zooms around the cursor and a middle (or, in 3D views, right) drag pans; a middle double-click fits the view. On a trackpad, two fingers pan and a pinch zooms; on a Mac, Cmd and two fingers zoom too. The views tell a trackpad from a wheel by the scroll it reports (points, not lines); Preferences → Interface → Trackpad scrolling pans turns this off, so that any scrolling zooms (for a mouse that reports its wheel like a trackpad). The component, profile and title block editors, the visual programming editor and the site map work the same way.

Selecting in 2D views

A click picks the element under the pointer (Ctrl adds or removes it). A drag that starts on empty paper, or inside a floor, a hatch or another fill, draws a selection box: dragged to the right it is a window and takes the elements wholly inside it (their lines, fills and texts); dragged to the left it is a crossing, dashed and green, and also takes those it cuts or lies in: a wall crossed between its ends, a floor around the box, a text anchored in it. Room areas and imported drawings are not taken by a crossing (a window around them takes them). Ctrl keeps the current selection and adds to it. A drag that starts on an element’s line, or on an element already selected, moves it instead (Ctrl+drag copies).

The element under the pointer is highlighted before the click, and the status bar names it (Category : Type). Where elements overlap, Tab steps to the next one under the pointer and Shift+Tab back, wrapping round: first what a click takes, then the other lines by distance, then the fills topmost first, then imported drawings. Over a wall, the chain of walls joined end to end with it (stopping where three or more walls meet) comes right after it. The status bar shows the place in the list, such as (2/4), and a click selects the highlighted candidate, a chain with all its walls (Ctrl adds or removes it). Moving the pointer more than a few pixels, leaving the view or changing the model starts over.

Tags of doors, windows, beams, columns and footings can be dragged to another spot with the Select tool (the pointer turns into a hand over them). The tag keeps its text and gets a leader back to its element; each plan keeps its own tag positions (a duplicated plan starts with those of the original). Reset Tag, in the element’s properties, puts it back where it sits by default.

What is drawn in a view (detail lines, filled and masking regions, text notes, dimensions, level marks, detail components, imported drawings) belongs to it. Copied (Ctrl+C) and pasted (Ctrl+V) with another plan, elevation, section, legend or drafting view active, it goes into that view at the same coordinates, so a plot boundary or a buildable area drawn in the site plan can be reused in another plan; dimensions pasted into another plan keep measuring the same elements. From a 3D view or a schedule it goes back into its own view. In the project browser, Duplicate with Detailing copies a view together with what is drawn in it (Duplicate copies only the view).

Annotate → Levels places level marks. Level in Plan (in a floor or ceiling plan) draws a circle with two filled quarters on the clicked point and writes the finished level of the floor under it above a shelf line and the raw level of its structure (the top of the layers below its finish) under it; off any floor it writes the plan’s level. Level in Section (in a section or elevation) draws a triangle pointing down to the point and writes its height, with the raw level when the point lies on the top of a cut floor; in a section the tool snaps to the view’s lines, so a click on a floor’s top line lands on it. The values follow the model; in the properties palette a mark can set either level by hand, hide the raw one or put the values on the left. The type holds the text size, the datum (the value written for the project’s zero, e.g. 100.00) and the suffixes, (N.A.) and (N.O.) by default in Portuguese.

Editing several elements

With several elements of one category selected, the properties palette shows their Type and Level (Base Constraint for walls, columns, stairs, ramps and shafts) and the parameters they share: the walls’ Location Line, the base offset, the Top Constraint (unconnected, or up to a level; walls made unconnected keep their height) with its offset or the Unconnected Height, sill height, overhang, rotation, Structural, Room Bounding, the walls’ joins at their ends, flips, and the identity data (Mark and Comments). A value that differs among them shows ‹varies› (an indeterminate box for on/off ones); choosing or typing one sets it on all of them in one undo step (the command elements_set; types through elements_set_type). A mixed selection shows how many of each category and Delete.

Selecting in 3D views

With the Select tool, a click picks the element under the pointer (Ctrl adds or removes it). Shift+drag draws a selection box, as in plans: dragged to the right it is a window and takes the elements wholly inside it; dragged to the left it is a crossing and also takes those it touches. Elements behind others count too; hidden ones do not. Ctrl keeps the current selection and adds to it. With Dragging in 3D views selects on in Preferences → Interface, a plain left drag draws the box and Shift+drag orbits instead.

Modifying in 3D views

Move, Copy, Array, Rotate, Mirror (pick or draw the axis), Align and Join Geometry/Unjoin Geometry also work in 3D views; left-drag still orbits (or Shift+drag, see above), middle or right drag pans.

View graphics

View → Graphics holds Visibility/Graphics (VG), Filters and View Templates (also under Manage).

Textures and painted faces

Sun settings

View → Graphics → Sun Settings (or the Sun button in a view’s properties) gives the active plan, ceiling plan, 3D view, elevation or section a sun; a view without one gets the default sun when the dialog opens (an elevation or a section the conventional sun, casting shadows), and Cancel takes it away again.

Render

View → Graphics → Render path traces the active 3D view in a window of its own: the picture on the left, the view’s render settings on the right. It takes the camera the viewport shows when it opens (a camera still fitted to the model is fitted again for the render’s size and field of view). Render starts it; the picture refines while it renders, and the line under it gives the samples done, the time taken and the scene’s triangles; Stop keeps what is rendered so far. The wheel zooms about the pointer, a drag pans and a double click fits the picture again.

Sketching outlines

Floors, ceilings, roofs, foundation slabs and masses are sketched in a plan. Their tool opens a sketch: the ribbon shows Create Boundary with the drawing tools until Finish or Cancel.

Roof coverings and framing

A roof type sets its covering and its framing, in the type dialog’s Covering and Framing section.

Conceptual masses

Massing & Site → Massing → Mass (MS) sketches an outline in a plan, like a floor, and extrudes it up to the level above. Masses are for massing studies before walls and floors exist: see-through bodies in 3D views, elevations and sections, cut in the plans they cross.

Terrain

Massing & Site → Site → Terrain (TS) sketches the terrain’s boundary in a plan, like a floor’s outline, and places its measured points: Points → Point clicks a point at the elevation set in the options bar (above the level), and undo takes points back like curves. Finish triangulates the points with the boundary; the boundary takes the elevations the points give it, points beyond it included, and the earth closes down to a flat base. A project without a terrain type gets one, cut in an Earth material (a woven hatch).

Massing & Site → Site → Building Pad (PD) sketches a pad’s outline on the terrain of the plan’s level, at the Elevation of the options bar; without a terrain there the button says so. Finish grades the terrain: flat inside the outline, a cut slope where the ground stands above the pad and a fill slope where it lies below, out to where they meet the existing ground (the daylight line).

Railings and their hosts

Curtain walls are walls of a curtain type (a project without one gets one from the wall tool’s type list: + Curtain Wall). Their type properties set the vertical and horizontal grids (layout, spacing or number, justification), the panel (glass, solid, empty, or a door, window or other component) and the vertical, horizontal and border mullions. Architecture → Build → Curtain Grid edits one wall’s grid by clicking it in a plan, elevation or section: Add Line (vertical or horizontal; plans add vertical ones), Remove Line (the nearest), Merge/Split Segment (the piece of a line between two others: the cells on both sides become one panel, or two again) and Swap Panel (the panel chosen in the options bar, or the type’s again); hovering shows what a click does. A selected curtain wall’s properties show its cells, panel count, glazed area and mullion length, and Reset puts back the type’s lines or panels.

Architecture → Circulation → Railing (RA) draws a railing along the points you click, at its level plus the base offset. A railing can also follow a stair or ramp (its host): it runs along the host’s side at the pitch of the nosings or of the slope, turns at its landings, and moves, changes and is deleted with it.

Niches

Architecture → Build → Niche places a niche: a recess in one face of a wall, hosted like a door or a window but not opening the wall through. Click a wall in a plan (or in a 3D view) and the niche goes in the face on the side clicked. New projects carry a niche type, 60 × 60 cm and 10 cm deep with its bottom 90 cm above the wall’s base (2’-0” × 2’-0” × 4” at 3’-0” in imperial projects); in an older project without one, the first niche brings that type. The Sill Height field of the options bar shows the type’s sill and sets the height of the niches placed next, as for windows.

Shafts

Architecture → Floors & Roofs → Shaft (SF) sketches the outline of a vertical opening (a duct chase, a lift or stair shaft, a light well) in a plan, like a floor’s outline; it rises from its level to the highest level above (or a level or height set in its properties). A project without a shaft type gets one the first time.

Swept profiles

Architecture → Model → Sweep (SW) carries a profile along a path drawn in a plan: baseboards, crown moldings, fascia boards, gutters, copings. A project without a sweep type gets one the first time (a baseboard 1.5 × 10 cm).

Wall profiles

A straight wall’s face can be drawn in its own elevation, so its base and top need not be level: a top that follows sloping ground, a stepped base, a gable end, an arched top.

Spline walls

The wall tool (Architecture → Build → Wall, WA) has three modes in the options bar: Line chains straight walls, Arc takes the start, the end and then a point on the arc (or a typed radius + Enter), and Spline draws one wall along a smooth curve through the points clicked.

Strip footings and ground beams

Structure → Foundation → Ground Beams Under Walls places a strip footing under each selected wall (or every wall of the plan’s level) along the wall’s body centerline, its top at the wall’s base; walls that already have one are skipped. An arc wall gets an arc strip that follows its curve (concentric with the wall), not a chain of straight pieces, so the foundation plan shows the curve and its radius and the concrete volume is exact.

Arc beams

The Beam tool has two modes in the options bar, as the wall tool has: Line draws straight beams, Arc takes the start, the end and then a point on the arc, or a typed radius + Enter. An arc beam is level (it has no end elevation offset).

Beam reinforcement

Typical Reinforcement in a beam’s or column’s properties gives it bottom and top bars and stirrups. Further sets are made with rebar_create (command palette), and each set’s count or spacing is edited in the Reinforcement section. Stirrups are closed by two hooks at one corner (135° with straight ends of 10 bar diameters, counted in their length); a selected stirrup set’s properties show Stirrup Hooks (none, 90° or 135°) and Hook Tail (bar diameters).

Column sections and their reinforcement

A column type’s section is a structural profile. Besides the standard shapes, the Profile Manager (Structure → Profiles) has Annular sector: the piece of a ring between an inner radius and an outer radius turning by an angle, as the columns that continue a cylindrical wall have (an inner radius of 0 makes a circular sector). The section is drawn symmetric about its vertical axis with the outer face up, and placed by the middle of its bounding box; turn each column on the circle with its rotation. Its area and the column’s volume are the ring’s, not those of the chords it is drawn with. L, T, U and other polygonal columns are sketched profiles (a new profile of the Sketch shape).

rebar_create (command palette) reinforces a column of any section:

Wall reinforcement

A structural wall (the Structural checkbox of its properties) shows a Reinforcement section. Typical Reinforcement gives it horizontal and vertical bars every 15 cm near both faces; each set is then listed with its spacing, which can be edited, and a Remove button. wall_rebar_create (command palette) sets everything else, for the given walls or every structural wall of a level:

Slab reinforcement

A structural floor (the Structural checkbox of its properties) or a foundation slab shows a Reinforcement section. Typical Reinforcement gives it a mesh every 15 cm in its top and bottom layers, and trimming bars around its openings; each set is then listed with its spacing and a Remove button. slab_rebar_create (command palette) sets everything else, for the given slabs or the structural floors and foundation slabs of a level:

Pile cap and pile reinforcement

A pile cap’s and a pile’s properties show a Reinforcement section. Typical Reinforcement gives a cap bottom bars over its piles, a top mesh and side bars (and, in a cap of two piles or of a line, stirrups), and a pile bars around its section projecting into the cap and a spiral (round piles) or ties (square piles); each set is then listed with its count or spacing and a Remove button. Structure → Reinforcement → Pile Cap Reinforcement and Pile Reinforcement do the same for the selected caps and piles (a selected cap’s piles too), or for those of the active level that have none. pile_cap_rebar_create and pile_rebar_create (command palette) set everything else:

Structure by material

The Structure tab starts with a Material group: Concrete, Steel and Timber buttons (one is always on; the choice is kept between sessions). The material swaps the groups made for it: concrete shows Structure (Column, Beam, Floor) and Reinforcement; steel shows Structure (Column, Beam, Bracing), the Framing grid group (Columns at Grids, Beams on Grids, Beams Between Columns, Grid Frame, Truss, Steel Building, Light Steel Frame) and Connections (Base Plate, End Plate, Fin Plate); timber shows Structure (Column, Beam, Bracing), the same grid group with Wood Frame in place of Steel Building and Light Steel Frame, and Connections (Bolted Joint, Hanger). Profiles, Foundation, Analytical, Documentation, Datum and Selection show for every material.

The Column and Beam buttons start their tools on a type of the chosen material, and the options bar’s type list shows only those types. When the project has none, one is created from the catalog in one undo step: a W200x26,6 for steel, an MLC 9x32 glulam for timber, a 20x40 concrete rectangle for concrete (structural_type_for). The grid commands of the tab use the chosen material’s type as well. A type’s material comes from its profile (steel and cold-formed profiles are steel).

Grid Frame (Structure → Framing, available with two or more grids) opens a dialog that places columns on every storey and beams on every level of a range, in one undo step: Base level and Top level, the Column type and Beam type (of the chosen material), and Secondary beams with the grid they run parallel to and their Spacing. It frames the selected grids, or all of them when none is selected. Columns are attached to the level above, and spans and columns already modeled are skipped. Secondary beams fill each bay (four grid intersections) at most one spacing apart and end on the crossing beams; bays that are not such quadrilaterals are skipped. A run of more than 2000 members is refused. The status bar reports what was placed and skipped.

Steel Building (Structure → Framing) opens a dialog that makes a portal-frame shed in one undo step: the Span between column axes, the Eave height, the roof Slope and shape (gable or mono), the number of Bays and the Bay spacing, the Column type and Rafter type (of the steel material; Catalog default creates one), and Purlins and Girts with their type and spacing (each can be turned off). The members are ordinary columns and beams, so they get tags, schedules, 3D views and IFC export like any other; the building itself shows in plans as a dashed footprint. Selecting it shows its parameters in the properties palette (Span, Eave height, Bays, Bay spacing, the types, Purlins, Girts, Members and Detached members); changing one regenerates the members in place, keeping their ids, marks and comments. A member you edit by hand (moved, retyped or deleted) is detached and is not regenerated; Reset Members in the palette makes the building manage every member again. Deleting the building deletes its members, and copying it makes a new building with its own members.

Bracing (Structure, steel and timber) braces one bay of a frame, storey by storey. With two columns selected it braces the bay between them, taking their base and their common height (divided by the Storeys); otherwise it is a tool: click the axes of the bay’s two columns. The options bar sets the Pattern (X, diagonal, V, chevron or inverted V, and K, whose four braces run from the mid-height of each column to the middle of the bay at the top and bottom of the storey), the Storey height and the Storeys; a diagonal also has Flip diagonal and Alternate diagonals (a zigzag up the storeys). The braces are ordinary beams of a catalog type of the tab’s material (an SHS 100x100x4 tube for steel, a 6x12 piece for timber), so they get tags, schedules, 3D views and IFC export; the bracing itself shows in plans as a dashed bay line. Selecting it shows its parameters and the Brace type in the properties palette; changing one regenerates the braces in place, keeping their ids. A brace you edit by hand is detached and is not regenerated; Reset Members makes the bracing manage every brace again. Deleting the bracing deletes its braces, and copying it makes a new bracing with its own.

Truss (Structure → Framing, steel and timber) is a tool: click the two ends of the span line. The options bar sets the Shape (flat, mono-pitch or gable), the Pattern (Pratt, Howe, Warren, and for gables king post, queen post and Fink), the Height (chord to chord, or the rise), the Panels (auto aims at one per 1.5 m; a gable takes an even count), the Copies and their Spacing to the left of the span line. Its types come from the tab’s material (a catalog chord and web for steel or timber). Each chord is one continuous beam (two top chords on a gable); the posts are cut to stand between the chords, or inside them when the chords are channels open toward the web, as the steel defaults are; and a truss that ends on a post has its chords run on over it and that post turned to close the end. The chords, diagonals and posts are ordinary beams and columns, so they get tags, schedules, 3D views and IFC export; the truss itself shows in plans as a dashed span line per copy. Selecting it shows its parameters and the four member types in the properties palette; changing one regenerates the members in place, keeping their ids, marks and comments. A member you edit by hand (moved, retyped or deleted) is detached and is not regenerated; Reset Members in the palette makes the truss manage every member again. Deleting the truss deletes its members, and copying it makes a new truss with its own members.

Light Steel Frame (Structure → Framing, steel) and Wood Frame (timber) open a dialog that frames walls: the System, the stud Spacing (0.4 m for light steel, 0.6 m for wood), the types of the studs, of the tracks or plates and of the headers and sills (the system’s catalog types by default), a Double top plate (wood only) and Blocking at mid-height. OK frames the selected walls, or every wall of the active level when none is selected; curved walls and walls already framed are left out. Studs stand at the ends of the wall and every spacing along it, with king and jack studs, a header, a sill under windows and cripples at each door and window. The studs, tracks, headers and sills are ordinary columns and beams, so they get tags, schedules, 3D views and IFC export; the framing itself draws nothing in plans. Selecting a framing shows its system, spacing, double top plate, blocking and the three member types in the properties palette; changing one regenerates the members in place, keeping their ids, marks and comments, and they follow the wall and its doors and windows when those move or change. A member you edit by hand (moved, retyped or deleted) is detached and is not regenerated; Reset Members in the palette makes the framing manage every member again. A member of a framing shows a Framing row in the palette whose Select button selects the framing. Deleting the wall deletes its framing and members.

Structure → Connections (steel and timber) places connections with default sizes on the selected columns (base plates) or beams, else on the active level’s, at the ends that suit the kind: end plates and bolted joints where a beam stops at a column, fin plates at a column or a beam, hangers where a beam meets a beam. Ends that already have one are skipped, and the status bar reports how many were placed. Plates and bolts follow their member, go with it when it is deleted and are not copied with it. Selecting a connection shows its kind, the member and its end, the plate thickness, width and length (auto: from the section), the bolt diameter, rows, columns, spacing, edge distance and (base plates) anchor length, with the plate mass and bolt count; a connection whose end no longer suits it draws nothing and says so.

Structural profiles

Structure → Profiles (also Manage → Profiles) opens the Profile Manager: the project’s structural profiles, which column and beam types are drawn and built with, grouped by material (steel, cold-formed steel, timber, concrete) under a search box.

In Type Properties, column and beam types have a Profile row in place of the old section fields: a list of the project’s profiles grouped by material with a search box, and Manage…, which opens the Profile Manager on the type’s profile. Below it, the profile’s rotation (degrees) and Mirrored turn and flip it in the type, and a read-only row gives the profile’s d × bf. A type with no profile shows “—” and keeps its own section until one is picked. Changes go through type_set, and OK/Cancel keep or undo them with the dialog’s other changes.

Cable trays and valves

MEP → Electrical → Cable Tray (TY) draws cable tray runs like conduits: click the ends of each run, one after the other; a new elevation while drawing adds a vertical run, and Backspace takes back the last segment. The options bar sets the circuit the trays carry and their elevation (by default 30 cm under the level above, or the height of the tray a run starts on). A project without a cable tray type gets one the first time (200 × 100 mm, ladder).

MEP → Plumbing → Valve (VL) places a valve on the pipe clicked, where it was clicked. A project without valve types gets one per kind the first time: gate, ball, check and globe valves.

Lightning protection

The MEP → Lightning Protection group draws a lightning protection system. Its elements belong to a lightning protection system, made with the first of them, and show in the level’s lightning protection plan (MEP → Documentation → Lightning Protection Plan), which the tools open when another view is active.

Structured cabling

The MEP → Communications group places racks and data outlets. They show in the level’s communications plan (MEP → Documentation → Communications Plan), with the cable trays and the conduits that carry the cabling.

Drafting views

Callouts and detail views

Detail lines

Line styles, filled and masking regions

Tags, grid bubbles and view marks

Fill patterns

Detail components

Imported CAD drawings

Construction phases

Design options

Sheets and title blocks

A sheet’s properties set its number, its title block (a title block type of the project, or None for blank paper), its paper size (A0 to A4, ANSI A to ANSI E, ARCH A to ARCH E1 and ARCH E, the project’s own listed first; or Custom with a width × height between 50 and 5000 mm, in inches in imperial projects) with Portrait to put the long side up, and its issue date (typed as YYYY-MM-DD; Today fills it in). Sheet Fields lists the title block’s per-sheet fields: type a value for this sheet, or leave the row empty to use the title block’s own text, shown greyed. When a piece of the active sheet’s title block cannot be drawn (an expression that does not resolve), the status bar names it.

Schedules go on sheets like any view: drag one from the project browser onto an open sheet, or right-click it in the browser and choose Place on active sheet (sheet_place_view). It is drawn as a ruled table at its printed size, with its name in the first row, its headers, a row per element its phase shows and the totals; it follows the model, and the sheet’s PDF, SVG, PNG and DXF carry it. Export Image, Export DXF and view_export also write a schedule alone as its table.

Manage → Project → Project Information has a Project fields table: your own values, such as the engineer or the permit number, each with a name and a value. + Add field adds one, a name is changed by typing over it (Enter), × removes it. Title blocks show them as {project:Name}.

Manage → Project → Site Location places the project on an OpenStreetMap map. Search an address, place or coordinates (Enter or Search; pick one of several results), or drag the map: the red marker in the middle is the project origin, the arrow is project north and the red square is the area of map data to bring in, turned with True north. Elevation → Get reads the height above sea level from an open elevation model (accurate to meters; type a surveyed value over it), and Address of this point fills the address of the marker. OK stores the latitude, longitude, elevation, true north and address (the project address is rewritten from the parts, for title blocks and IFC). Import Surroundings downloads the map data of the square into the chosen floor plan: a pinned drawing with layers for buildings, streets, paths, railways, water, green areas, trees and street names, and, with Buildings as masses, a context mass per building (the map’s height or storeys, else two storeys of 3 m). Cancel undoes all of it. Map data © OpenStreetMap contributors (ODbL); the map, search and elevation need an internet connection. A title block draws the whole sheet: border, margins, the block itself, logos. It is a component (category Title Blocks), so it is saved to and loaded from .ccomp files and the component library. Modify → Title Block → Edit Title Block (or Edit Title Block in a sheet’s right-click menu, in the view or the project browser) opens the active sheet’s title block in the editor; View → Documentation → New Title Block makes one from the standard layout and opens it; loading a title block from the library opens it too.

Component modeling environment

Edit Component (Architecture → Model, or Edit Component… in a component type’s properties) opens a workspace of its own for the selected component, or the one the Component tool places. New Component (Architecture → Model) asks for a name and the kind of the component (furniture, casework, plumbing fixture, lighting, electrical, generic, door or window) and shows the parameters that kind starts with: width, depth and height for most, a diameter for lighting, the opening’s width, height and sill for doors and windows; a generic component starts with none, and its parameters are yours to add. Create makes the component and opens it here; Cancel Editing removes it again, and Finish picks the tool that places it.

Preferences

File → Preferences (Ctrl+,, also at the bottom of the home screen) holds the settings of the app itself; they are not part of any project and are kept between sessions. Pick a page on the left. Changes show at once; OK keeps them and Cancel (or Esc) brings back the values the window opened with. Restore defaults (bottom left) resets the settings of the page shown; the language and the folders stay as they are.

Visual programming

Manage → Macros → Visual Programming opens the graph editor in a panel under the views, so the model and the graph are seen together (constructcraft project.ccad --graph file.ccgraph opens one at startup). A graph is a set of nodes joined by wires (see Visual programming graphs for what the nodes do and how running again updates the model).

Macro editor

Manage → Macros → Macro Editor opens a panel under the views, in the graph editor’s place (one of the two shows at a time, and each keeps its contents when the other opens), where a macro is written, checked and run a step at a time while the views above show each step’s change. A macro is one {"command": …, "args": {…}} per line, with // comment lines (see Macros in the app).

Plugins

Plugins add commands to ConstructCraft (see Plugins in the automation guide). Manage → Plugins holds two buttons: Plugins… opens the Plugins window, and Plugin Commands is a menu of the installed plugins’ commands, by plugin; choosing one opens its form in the command palette, where Run executes it as one undo step and shows what the plugin printed. The palette also finds plugin commands by name.

The Plugins window has two tabs:

Only this tab reaches the network: it reads the index and the archives it lists, over HTTPS, when you ask. Reload Plugins reads the folder again, after you add or edit a plugin by hand. Plugins are loaded when the app starts and stay loaded when you open another project.

Update notice

ConstructCraft tells you when a newer version is published; it never downloads or installs anything by itself, only when you choose Update Now.

Autosave and recovery

A minute after a project gets unsaved changes (a new project that was never saved too; Preferences → Saving sets another interval or turns autosave off), ConstructCraft writes a copy of it, in the background, to the recovery folder of its data folder (%APPDATA%\ConstructCraft\data on Windows, ~/Library/Application Support/ConstructCraft on macOS, ~/.local/share/constructcraft on Linux). It writes again only after the model changes, and never over your project file. Saving, closing the project or quitting removes the copy.

If ConstructCraft crashes or is killed, the next start shows Recover Unsaved Work with the copies left behind: Restore opens the chosen project with its unsaved changes (saving it writes to its original file, or asks where for a project that was never saved), Discard deletes the copy, and Cancel keeps the copies for the next start. A crash in the interface also writes a last copy before the app closes, and every crash is appended to crash.log in the data folder; attach it when you report a crash.

Graphics start-up

ConstructCraft draws with the system’s native graphics API (DirectX 12 or Vulkan on Windows, Metal on macOS, Vulkan on Linux) and falls back to OpenGL by itself when that fails, which some older or small integrated GPUs need:

Accessibility

The ribbon buttons, tab titles, scroll arrows, palette entries, browser rows, home screen cards, dialog close buttons, property sections and the view cube’s home button are drawn by ConstructCraft itself. They report their role (button, selectable item, collapsible header), their name and their state (enabled, selected, expanded) to the operating system’s accessibility interface, so screen readers can announce them.

For developers

Adding a command to the interface

  1. Make the change an engine command first (see For developers in the automation guide).
  2. Add a variant to UiCommand in crates/cc_app/src/commands.rs. Then fill in its icon, label, description (an i18n key cmd-desc-… in every .ftl file), shortcut (if any), engine (the engine command’s name), badge, unavailable (a localized reason for each state in which it cannot run), selected (for tools) and run. Add it to UiCommand::all.
  3. Place it in a ribbon group with command_button (large) or in a family of small buttons with stacks (crates/cc_app/src/ribbon.rs).

The tooltip, enabling, the palette entry and a two-letter shortcut all follow from the command. Tests check that each engine name exists in the catalog, that shortcuts are unique, and that every command appears in the ribbon with an accessible name.

Icons

Icons are SVG files in assets/icons/ui on a 24-unit grid. They use white strokes (stroke-width 1.75, round caps and joins) and soft fills written as fill="#fff" fill-opacity=".2". icons.rs splits each icon into two layers by those attributes: the strokes and solid marks form the ink, and the soft fills form the tint. Each layer is rasterized with resvg at the exact pixel size and painted in the theme’s colors (icons::Tones). Add the new icon to Icon, Icon::ALL and Icon::source. ICON_SHEET=sheet.png cargo nextest run -p cc_app icon_sheet writes every icon at several sizes for review.

Theme

Colors are tokens of theme::Palette: PALETTE (light) and DARK, with a test of their contrast. Paint with theme::palette(ctx) so a dark theme can be switched on later.

Interface tests

crates/cc_app/src/ui_tests.rs runs the ribbon and the palette headlessly with egui_kittest. The tests click and type through the accessibility tree, so custom widgets must call Response::widget_info. Screenshot references live in crates/cc_app/tests/snapshots. They cover each ribbon tab, the narrow and collapsed ribbon, a rich tooltip, the palette, each page of the Preferences window, and an icon gallery in both themes. GPUs render slightly differently, so the screenshot comparisons run on request:

CC_UI_SNAPSHOTS=1 cargo nextest run -p cc_app snapshots     # compare with the references
UPDATE_SNAPSHOTS=1 cargo nextest run -p cc_app snapshots    # rewrite them after an intended change

Review the new images before committing them. On a mismatch, kittest writes *.new.png and *.diff.png next to the references; Git ignores those files.