Start here

The screen, part by part

The editor is a sidebar, a header, a canvas, a code pane and a serial monitor. This is what every control on it does.

The sidebar

Down the left: the Mokxi wordmark, New project, Editor, and the editor's pages (Home, My projects, Import, AI Builder, Examples, Learn, Classes, Parts and Docs), with Customize, Settings and your plan card at the foot. Each opens in the main area and the project waits behind it. See the sidebar and the editor's pages.

The header

Left to right, on a wide screen:

  • Save, a split button. The wide half saves the project, and its label says where things stand: Save, Saving… or Saved. The â–¾ opens the rest: Save a copy, History, Download JSON, Download SPICE, Open JSON or SPICE, Import a project, Run a SPICE deck, New, and Built-in projects. Signed out, it also has Save to my account.
  • Share opens the share sheet: who has access, the access level, the link, and the embed code. See sharing a project.
  • Export downloads the project in other forms: pictures (PNG and SVG), an Arduino IDE or PlatformIO project, a Wokwi project, and a printable build guide. See export.
  • Send to board, when the project has a board that runs code: the steps to put the sketch on a real one. See send to a board.
  • The heart marks the project as a favorite.
  • The project title, with a pencil beside it to rename it.
  • SPICE, a badge you can press. It says in five paragraphs what the engine does and does not do; what Mokxi simulates says the same at length.
  • The engine badge reads engine: loading until the simulator is up, then says which engine is running.
  • The readout: simulated seconds, and speed against real time. 1.00x means the circuit keeps up with the clock on the wall.
  • Run, which starts the simulation and turns into Stop while it runs.
  • The language menu, the theme toggle, Docs, and your account (or Sign in).

On a phone the header keeps the wordmark, Save, Run and a share button that opens a menu with the rest of the row. Signed out, a phone also shows Sign up.

The canvas

The left pane, where the breadboard, the parts and the wires live. In its top-left corner is a row of round buttons:

  • Run, Undo and Redo.
  • Add (+, or the A key) opens the part panel.
  • Draw (D) opens the drawing tools.
  • Tidy the wires (T), see tidying up.
  • Layers (L), the layers panel.
  • DC operating point (Shift+O), see analysis.
  • Checkup, which looks over the wiring and the code and shows a count when it finds something.
  • More, a menu with everything else: copy, paste, zoom, fit, rotate, delete, frames, comments, chips and blocks, the Schematic and PCB views, levels, the grid, version history and the circuit as text. Each item names its key, and keyboard shortcuts lists them all.

On a phone, Tidy, the operating point and Checkup move into More.

Select a part or a wire and its properties open beside it: resistance, LED color, wire color, a wire label, rotate and delete. See the properties panel.

The code pane

The right pane holds one project per board: a file strip with tabs, a board picker when the diagram has more than one board, and the editor. A diagram with no board still has a sketch, so you can write code first. While a build runs, a line across the top of the code says what the compiler is doing; an error stays there, and pressing it takes you to the line. The chevron at its end opens the full log. See the code editor and compiling.

The serial monitor

The strip along the bottom. Anything a board writes to its UART appears there, and the input line sends text back. When two boards are talking, each line starts with the name of the board it came from. The log keeps the last 2,000 lines.

Its header has buttons for the other bottom panels: Checkup (the circuit check), Plot, Scope, Logic, Notes (the lab notebook), Web and Cloud for a board on the simulated network, Bluetooth, and Mokxi AI. See run and serial and the serial plotter.

Moving the walls

The bar between the canvas and the code pane, and the bar above the serial monitor, can both be dragged. Where you leave them is remembered in this browser. Out of the box the canvas takes 58 percent of the width and the serial monitor is 180 pixels tall.

Mokxi AI

Bottom right, on every page and in the editor: a round blue button with Mokxi AI's head on it. It opens Mokxi AI, Mokxi's helper, with these help articles, a way to ask about your circuit and code, and a message form that reaches a person if the answer is not here.

Next: your first project in five minutes.