Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The interface

This chapter is a tour of the CivilKit CAD window: the top bar, the ribbon, the feature tree and other side panels, the viewport, the status bar, the bottom drawer, command search, the Display menu and document tabs. It describes the default layout; Units and settings shows how to rearrange it.

Layout at a glance

From top to bottom:

  1. The top bar: file buttons, the document tabs (one per open part), the Part / Drawing switch, command search and settings.
  2. The ribbon: tabs of command groups, directly under it.
  3. The working area: the left panel (feature tree and friends), and the viewport. When you open a feature, its editor appears as a floating card over the viewport. The raw inspector panel on the right is off by default.
  4. The drawer (hidden until you open it).
  5. The status bar.

The side areas can be resized by dragging the thin handle between them and the viewport. Double-click a handle to reset it. Drag a panel to nearly nothing and it folds away. See Units and settings for the layout presets and Reset layout.

On a phone or tablet

The same app adapts to the screen. It chooses a layout from the window width and the pointer: a phone (narrower than 700 px, or a touch device whose short side is under 500 px), a tablet (narrower than 1100 px, or any touch device) or a desktop. Change it in Settings > Layout > Screen layout if the automatic choice is wrong for you; the choice is remembered, and your panel settings are not changed by it.

  • Phone. The drawing takes the screen: one slim bar at the top and one bar at the bottom, nothing else. The top bar has the file menu (new, open, save, export, library …), the title of the document (a dot after it means unsaved changes; tap it for the list of open documents and New part), undo, redo and more (search commands, Part or Drawing, rename, settings). The bottom bar has Tools, Tree, Properties and Diagnostics. Tools opens the ribbon as one strip just above the bar: the tabs as chips, then the tools of the chosen tab in a single row with their names that you scroll sideways; picking a tool, or tapping the drawing, closes it again. The tree, the properties (or the editor while you edit a feature) and the diagnostics open as sheets that share the screen with the drawing: the drawing shrinks to the room above the sheet and keeps its framing, so the model stays in view and updates while you change a value. A sheet that edits something rises to about 60% of the screen at most; the tree and diagnostics lists can go higher. Drag the handle at the top of a sheet to move it between its heights, drag it down to close it, or use its close button. When the on-screen keyboard is up the bars give way, and the sheet and the field you are typing in stay visible above the keyboard. Dialogs such as Samples and Settings fill the screen, and the Settings tabs scroll sideways.
  • Numbers on a phone. Every number field opens the digit keypad with a Done key. Fields that take a formula or a variable have an ƒ key beside them that switches to the full keyboard (and 123 back), and a ± key where the keypad has no minus. The label on the drawing (for example “Depth 20 mm”) is a button too: tap it to type an exact value in place.
  • Sketching with a finger. While a sketch tool is active, one finger belongs to the tool: press the first point (a circle’s centre), drag to size the shape with a live preview and lift to place it, or tap, then tap, as before. Two fingers pan and pinch the sketch view. A circle dragged out this way is selected with its radius field focused, so you can type an exact size. A touch the system cancels, or a second finger that lands, drops whatever the first one began. The bar above the bottom bar has Done, Cancel shape, Undo and Delete, because a phone has no Enter, Escape or Delete key. Points are picked from twice as far as with a mouse.
  • Tablet. One top bar row, the ribbon compact (tabs, then its tools) and the tree and the properties docked at the sides, as on a desktop but narrower. A single open document has no tab strip.
  • Touch on the model. One finger orbits (or draws, with a sketch tool), two fingers pinch to zoom and pan, a tap selects. One finger dragging the view cube turns the model; a tap on a cube face, an edge or a corner snaps to that view. The arrow ring around the cube has finger-sized buttons (44 px): four arrows that turn the view a step (hold to keep turning), two roll arrows and Home. On a phone it is open by default, 160 px square in the top right corner so the middle of the drawing stays clear; its menu button (three dots) hides the arrows when you want the room, and sets the step size. See Moving around the model. Putting a second finger down cancels whatever the first one began, so a pinch never selects or moves anything. Buttons are at least 44 px; the hide and suppress buttons of tree rows are always visible, since a finger cannot hover.

On an iPad

CivilKit CAD runs in Safari on an iPad, with a finger, the Apple Pencil, or both, and with or without a hardware keyboard.

  • Install it. Open the app in Safari, tap Share, then Add to Home Screen. It then opens full screen from its own icon and works offline once it has been opened online (see Install as an app and work offline).
  • Sketching with the Pencil. The Pencil works like a finger on the sketch tools: press the first point, drag to size the shape and lift to place it, or tap, then tap. A hand resting on the screen while the Pencil draws is ignored, and the Pencil hovering over (or lifting off) the drawing does not drop the shape you are in the middle of.
  • The value field opens after you lift. When a circle you dragged out is placed, its radius field opens on its own and the on-screen keyboard comes up with the number keys, so you can type an exact size at once; the same goes for the value of a dimension picked with the Dimension tool. For the other tools tap the field that appears next to the shape.
  • A minus sign. Where the number keys have no minus, a ± key appears above the keyboard (and next to formula fields) and changes the sign of what you have typed. Fields that take a formula or a variable have the ƒ key to switch to the full keyboard.
  • Updates. The installed app is mostly suspended rather than closed; when you open it again it checks for a newer version and, if nothing is unsaved or open for editing, reloads by itself and tells you “Updated to …”. With unsaved changes or an open edit you get a Reload note instead. Settings > General > Update automatically turns this off (see Updates).
  • Gestures. One finger orbits (or draws, with a sketch tool active), two fingers pinch and pan, and a long press does not select text or open a copy menu on the model. The page itself does not zoom when you pinch or double-tap.
  • Hardware keyboard. With a keyboard attached the desktop keys work: type a number while a sketch tool is waiting for a size and it goes into the first field (Tab moves to the next field, Enter confirms, Escape cancels, the arrow keys step the value), Enter and Escape finish and leave a sketch, Ctrl or Cmd with Z undoes, and the one-letter tool keys (L line, A arc, C circle, R rectangle, T trim; see Sketch tools) work as on a desktop.

The top bar

From left to right:

ControlWhat it does
New part (Ctrl+N, which a browser tab may keep for itself)Opens a blank part in a new tab, or in the current tab if that is still blank.
Open (Ctrl+O)Opens a part file.
Save (Ctrl+S)Saves the part.
Export (Ctrl+E)Opens the Export menu. See Exporting.
More file actionsA menu with Save as, Save geometry in file, Recover earlier versions…, Import STEP / STL / OBJ / GLB / 3MF / SolidWorks / SketchUp, Import SketchUp with hidden geometry and Rotate imported model.
LibraryOpens the Library picker: the sample parts and the libraries you added.
Part nameDouble-click to rename the part. A dot after the name means unsaved changes.
Part / DrawingSwitches the document between the model and its drawing. See Drawings.
Search commands (F)Opens command search.
SettingsOpens the settings dialog.

When a newer version of the application is available the bar shows a note with Refresh and Later. When your browser allows it, an Install button appears. See Install as an app and work offline.

Document tabs

On a desktop the open parts are tabs in the top bar, between the file buttons and the Part / Drawing switch. You can keep several parts open and switch between them without losing undo history.

  • + opens a new blank part after the current tab.
  • ×, or a middle click, closes a tab. A tab with unsaved changes asks Save, Don’t save or Cancel.
  • Double-click the active tab to rename the part. Right-click a tab for Rename, Close and Close the other tabs.
  • Drag a tab to reorder it. The ▾ button lists all open parts when the strip overflows.
  • Ctrl+Alt+1 to Ctrl+Alt+9 jump to a tab (9 is the last), Ctrl+Alt+T opens a new part and Ctrl+Alt+W closes the current one. Ctrl+Tab and Ctrl+Shift+Tab step through the tabs, but browsers reserve them and they may not reach the page in a normal tab; they work in the installed app.
  • Opening a file, a sample or an import uses the current tab if it is blank and a new tab otherwise.
  • You can have at most 32 tabs.
  • Switching tabs while a sketch is open finishes the sketch and keeps it.

Closing the browser page while any tab has unsaved changes makes the browser ask first.

The ribbon

The ribbon is a row of tabs; each tab holds groups of buttons. On the Home tab many buttons stand for a family of commands (the Surfaces tab and most of the Features tab show every command as its own button): the button shows the one you used last, and a small arrow, a long press or a right click opens the others. For example the Extrude button also holds Extruded cut.

TabGroups
HomeSketch, Create, Modify, Pattern, Edit
FeaturesReference, Create, Modify, Bodies (the commands in Reference, Modify and Bodies are plain buttons)
FrameFrame (Frame and Cut list)
Sheet metalRules, Create, Flatten, Export
SurfacesCreate, Edit (one plain button per command)
ViewViews, Display style, Appearance (lighting, background and Show), Workspace
SelectPick, Expand, Position
EvaluateMeasure, Surface analysis
AssemblyComponents, Review

The Frame tab is where the structural Frame tool lives: Frame builds a frame from a sketch of lines and a stock profile, and Cut list opens a drawing of it with the numbered pieces, the cut list and the bill of materials. On a phone the same tab is in the tool sheet.

The Assembly tab appears when the part contains inserted components, and opens by itself when you open an assembly.

Three things change the ribbon:

  • While a sketch is open the ribbon shows one tab, named Editing followed by the sketch name. Its groups are Select, Finish, Import, Make, Draw, Dimension, Constrain, Modify, Reference and Status. Select and Finish stay pinned at the left while the other groups scroll. See Starting a sketch.
  • While a feature editor is open the commands that create or change geometry are greyed out. Undo, Redo, view, selection and inspection commands stay available. Confirm or cancel the editor first.
  • A command that cannot run is greyed, and its tooltip says why: for example Fillet says “Select edges, or two or more faces, to round”.

The ribbon has two sizes, Full and Compact, and can be turned off, in which case you reach every command through command search. File commands are in the top bar, not on a ribbon tab.

The tool rail

The tool rail is a column of tools down the left edge of the view: the modelling commands without the ribbon. It is off on a first visit. Turn it on with Tool rail in Settings > Layout (the presets set it: Plasticity-style has it on, Classic ribbon and Minimal leave it off).

The rail sits directly against the left panel (the tabbed outliner, features and editor) and follows it: when the panel opens, folds or is resized, the rail moves with it. With a floating panel it sits beside the panel.

Folding the left panel

A handle on the edge of the panel and rail (a chevron, at least 44 px high on a touch screen), the panel button at the left of the top bar, and the [ key all fold and unfold the left panel; Side panel on the ribbon’s View tab does the same. The canvas takes the freed width. The choice is remembered on this device, and the fold animates unless your system asks for reduced motion.

When the panel is folded the tool rail shrinks to one narrow column of icons if it is your only tool surface (the ribbon is off, as in Plasticity-style); if the ribbon is on, the rail folds away with the panel. The handle always stays on the screen to bring the panel back.

Getting your tools back

The tools can never all disappear. A stored layout with the ribbon and the tool rail both off (other than Minimal, which shows a Show tools button in the top bar) gets the compact ribbon back when the app starts, turning one of them off in Settings while the other is off turns the other on, and Reset layout (in Settings > Layout, in the … menus and on the ribbon’s View tab) unfolds the left panel, restores the default sizes and brings the tools back. On a tablet the ribbon is never fully off while the tool rail is off too.

Undo and Redo on a tablet

On a tablet Undo and Redo are always on the screen as a pair of 44 px buttons at the top left of the canvas, above the tool rail, whatever panels are open or folded and also while a sketch is open; they grey out when there is nothing to undo or redo. A phone keeps them in its top bar.

Overlays do not overlap

Everything that floats over the model (messages, the new-version note, the busy indicator, hints, the start card, the selection modes, the sketch bar, the readouts) lives in one layer with named regions: notices stack downward from the top, between the tool column and the view controls; messages stack upward from the bottom, above the keyboard and any strip along the bottom; the view controls stay at the right edge. Items stack instead of covering each other, at most three messages show at once (the rest wait their turn, identical ones merge into one with a count, errors go first), each disappears by itself after a few seconds, and the layer respects the screen’s safe area and the on-screen keyboard.

  • Sections run down the rail: Edit, Sketch, Create, Modify, Frame, Surfaces, Pattern, Inspect, Assembly and Select. A section that would be empty in this build is skipped.
  • One cell per family. A cell shows the tool you used last from that family (the Extrude cell is fixed and always shows Extrude); the rest open from it with a long press, a flick to the right, a right click, or the triangle in its corner. The last tool is remembered per family and shared with the ribbon.
  • For selection sits at the top while something is selected: the commands that apply to what is selected, most relevant first, in the order of the right-click menu among the commands that can run now; commands that cannot run move to the end. Its memory is per kind of selection, so the tools you used on a face come back when you pick another face.
  • Button labels (Settings > Layout) switches the rail between Icons and text and Icons only (label on hover), as it does the ribbon.

While a sketch is open the rail keeps Edit and, when the ribbon is off, gains the sketch sections (Select, Draw, Dimension, Constrain, Modify, Reference); with the ribbon on the sketch tools stay on the ribbon. See Starting a sketch.

File, export, camera and display commands have no cell on the rail: they stay in the top bar, on the View tab and in command search.

Common problems

SymptomFix
There is no railIt is off by default. Settings > Layout > Tool rail
A family opens a tool you did not wantThe cell opens on the last tool of that family. Long press, right click or press the corner triangle to pick another
The rail is missing while sketchingWith the ribbon on, only Edit is shown there; the sketch tools are on the ribbon. Turn the ribbon off to carry them on the rail
A command you look for is not on the railFile, export, view, layer and display commands are not on it by design. Use the top bar, the View tab or command search (F)

The left panel

The left panel can be docked, floating over the viewport, or hidden. Press [ to show or hide it. When tabs are on (the default) it has these tabs. They are icon buttons in a row at the top of the panel, in the order below; the name of each is its tooltip, and the active tab also shows its name.

TabContents
OutlinerThe parts, mates and patterns of an assembly.
FeaturesThe feature tree, described below. While a feature editor is open it takes this place.
EditorThe editor of the selected feature.
CatalogShapes and library parts to drop onto the model. See Catalog parts.
VariablesNamed values and configurations. See Equations and variables.
ScriptA script box. See Scripting.
BodiesThe bodies of the part, with colour, opacity and finish. See Bodies and combining.

The feature tree

The tree lists the history of the part in build order. At the top are fixed rows: Material, Front Plane, Top Plane, Right Plane and Origin. Below them is one row per feature. A sketch that a feature uses is tucked under that feature.

  • Click a row to select it, Ctrl-click to add to the selection, Shift-click to select a range.
  • Double-click a row to open its editor. Double-clicking a sketch reopens it for editing.
  • Hover a row to see its buttons: Select in viewport, Edit, Roll back to here, the eye (Hide (view only) / Show), the pause button (Suppress (rebuilds) / Unsuppress (rebuilds)) and Remove.
  • A failed feature is red with its reason underneath. Features that fail only because an earlier one failed are muted and say “blocked by” the cause.
  • Drag the model is here marker to roll the model back to an earlier step. See The feature tree and history.
  • Use the search box to find a feature by name, type or id.
  • F2 renames the selected feature, Delete removes it, Ctrl+Shift+U suppresses or unsuppresses it, and Ctrl+G groups several neighbouring features into a folder.

The inspector panel

Opening a feature (double-click it in the tree, or use its pencil button) shows its editor as a floating card over the viewport, with labelled fields, drop-downs and sections. The left panel keeps the feature tree, so the Editor tab is not shown on a desktop screen. A phone and a narrow tablet keep their single panel or sheet for the editor.

The inspector is a separate column on the right that lists the selected feature’s properties as plain fields. It is Off by default. A layout saved by an earlier version had it docked; it is switched off once when you first open this version. To bring it back, set Inspector panel to Docked right or Floating in Settings > Layout. The Classic ribbon preset docks it. It shows only while a feature is selected.

The viewport

The viewport shows the model. Over it you find:

  • The view cube in the top right corner, with its arrow ring (turn, roll, home) and the Fit and projection buttons under it. See Moving around the model.
  • The Display button (an eye icon), described below.
  • The selection list at the bottom right when something is selected. See Selecting things.
  • On-canvas handles: arrows and dots you can drag to change a depth, a fillet radius, a shell thickness or a hole diameter. They can be turned off in the settings.
  • Notices and a busy indicator with a Cancel button when a rebuild takes long.

Right-click the viewport for a menu of the commands that apply to what is selected. With nothing selected it offers the three New sketch commands, Extrude, Extruded cut, selection commands and Fit.

If you turn on the Selection mode bar in the settings, a small bar appears at the top of the viewport with Auto, Face, Edge, Corner, Body, a Box select button and a filter button.

The status bar

The status bar runs along the bottom.

ItemMeaning
Ready / BusyWhether the kernel is working.
Hover nameWhat is under the pointer.
NoticesThe latest message, for a few seconds.
SelectedA summary of the selection, such as 3 faces, 12.4 cm².
Features, Faces, TrianglesSize of the part.
Cached viewShown while the stored view of a part is on screen during a rebuild.
Design check chipThe result of the last design check. See Design checks.
KernelShown only when you use the local kernel service. Click it to open the kernel settings.
Last rebuildHow long the last rebuild took.
ErrorsThe number of failed features, in red when not zero.
DrawerOpens and closes the drawer.
Licences, DocumentationLinks to the licence list and to this guide, at the right end of the bar.

In a sketch the bar also shows the pointer position on the sketch plane, the active snap, the Snap and Grid switches, the Zoom and the grid Spacing. Click Spacing to type a grid spacing; 0 or empty means automatic.

The drawer

Press \ or click Drawer in the status bar to open the drawer at the bottom of the window. It has five tabs:

TabWhat it shows
HistoryEvery edit as a step, with filters All, You, Agent and Failed. Click a step to go back to it.
DiagnosticsWhy a failed feature failed and what to try. See Checks and diagnostics.
InspectMeasure, mass properties, section view and interference. See Measure and inspect.
CheckDesign rule checks. See Design checks.
ConsoleRecent messages.

Badges on the tab names count entries; red means problems.

Press F, or click Search commands, to search every command by name, group or tab. Type a few letters, move with the arrow keys, press Enter to run the highlighted command and Esc to close. Greyed commands cannot run in the current state. Before you type, the search offers a short list of pinned commands: Iso, Fit, Undo, Redo, Samples and Workspace settings.

Command search is the one place that lists everything. If you cannot find a button, search for it. Commands and shortcuts lists the commands and their keys.

The Display menu

The Display button in the viewport opens a panel with these sections:

  • Style: Shaded, Shaded with edges (the default), Wireframe, Hidden lines removed and Ghost, with an opacity slider for Ghost.
  • Appearance: a colour and a material finish for the part, or for the selected component of an assembly.
  • Scene: lighting presets Studio, Flat, High contrast and Technical, Light strength, and Reflections.
  • Edge width and Silhouette outline, and the Background.
  • Surface analysis options. See Surfaces.
  • Show: switches for Edges, Sketches, Curves, Planes, Axes, Grid, Relations, Overall size, Threads and Design issues.
  • While a sketch is open, a Sketch section with Dimensions, Relation glyphs, Reference dimensions, Colour by definition and Constraints panel.

These settings change only how the part looks. They are never written into the part’s geometry.

Getting help

A round ? button is next to the name of whatever you are working with, so help is one tap away and matches the tool you chose.

  • In an editor or wizard. The ? sits in the header of the panel (Extrude, Fillet, Hole, Gear, Spring, Case, 3D Sketch and the rest), next to the name.
  • While you sketch. The ? sits in the Status group of the sketch ribbon (and on the sketch bar on a phone). It explains the tool you have active; with no tool active it opens the sketch overview.
  • Anywhere. The ? in the status bar, at the right, opens the contents of this guide.
  • From the keyboard. Press F1, or ? when no text box has the focus, for the tool or editor you are in.

The button opens a small card with the name, one sentence, and Open the guide. That link opens the matching page of this guide, at the right section, in a new browser tab (in the desktop app it opens in your default browser). Press Esc or tap outside the card to close it. Each button is at least 44 px square on a touch screen.

Next