Start here

Getting started

A breadboard, a parts bin and a code editor in one browser tab. Nothing to install, and no account needed.

What you need

Any up-to-date Chrome, Edge, Firefox or Safari, on a computer, a phone or a tablet. On Android there is also the Mokxi app, and the editor works with touch (on a phone).

The simulator and the compiler run on your own machine, so once the page is open it keeps working without the internet. You need a connection to load it and to save to your account.

1. Open the editor

Open the editor. The first time, it opens on a circuit that is already built: First blink, an Arduino Uno with a red LED and a 220 ohm resistor on pin 13. The note at the top of the sketch says what to try.

2. Press Run

Press Run, on the canvas toolbar or in the header. The LED blinks once a second. The readout in the header shows the simulated time and the speed; 1.00x means the circuit keeps pace with real time. Press Stop (the same button) to end the run.

3. Change the code

The right-hand pane is the board's code. Change both delay(500) lines to delay(100) and press Run again. Mokxi compiles your sketch in the tab with a real compiler and runs it on a simulated chip. The first build downloads the compiler once and caches it, so it takes a little longer; after that it is quick. See the code editor and compiling.

4. Add a part of your own

Press + on the canvas toolbar, or the A key, to open the part panel. Click a tile to drop the part in the middle of the view, or drag it where you want it. Drag from any pin or breadboard hole to another to draw a wire. Press R to rotate the selected part and Delete to remove it.

The breadboard works like a real one: five holes to a strip, the rails down each side, and a center channel a DIP chip can straddle. There is more in placing parts and wiring.

5. Keep your work

Everything is kept in this browser as you work, so closing the tab loses nothing. A free account adds cloud saving and a link you can share. The Free plan saves 10 projects, and every new project starts public. Every account can also try Pro free for 7 days. Make one from the sign-in page, or keep going without one. Save, share, and come back has the short version.

  1. The screen, part by part: what every button does.
  2. Your first project in five minutes: build First blink yourself from an empty canvas.
  3. Save, share, and come back.
  4. Import a project from another tool, if you have one in Wokwi, Tinkercad, Fritzing or the Arduino IDE.

Also useful: what Mokxi simulates, every part, and the boards. Working with others? See live rooms. Teaching? Start with the twelve week course and what a class needs; locking a starter circuit for students is in assignments and submissions.

Questions

Do I need an account to follow this?

No. Everything on this page works signed out, and your work is kept in the browser as you go.

Where is my work saved?

In the browser, on every change. An account adds a copy in the cloud so it follows you between machines.

Can I open a circuit somebody sent me?

Yes. A public project link opens in the editor and runs, with no sign-up.