First Arduino Project Step by Step: A 4-Step Guide on Your Phone

If you want to build your first Arduino project step by step without knowing anything yet, there is a way to be guided on your phone: open a project page in BlueGrays and tap Build it step by step. The guided mode, called Let's build it together, splits the project into four steps: Get the parts ready, Build the circuit, Upload the code and Run and test. Each step shows only what you need right then, your phone screen stays on while you plug in wires, and if you stop halfway the button on the project page shows the step where you left off. All you need is an Arduino Uno, a few cheap parts and a computer to upload the code to the board.

In this post we don't just describe the mode, we use it on a real project from start to finish: we build the free Traffic Light project from the app in four steps. You will find the parts table, which wire goes to which pin, choosing the board and port in the Arduino IDE, the expected result, where to look when you get stuck, a 45–60 minute time plan and three small experiments for after your first project. If you want to know what each section of a project page does, we covered that in the project page guide; here we focus only on the flow of the guided mode.

What is the guided mode and where do you find it?

When you open a project, the main button of the page, Build it step by step, sits below the title, the rating and the short description; the small line under it sums up the four stops: Parts · Circuit · Code · Test. Tap it and, instead of the project page, a clean screen opens that shows one step at a time. At the top you see Screen stays on and a Step 1 / 4 counter, at the bottom the Back and Next step buttons. Your current step and the parts you ticked are saved; if you close the app and come back the next day, the button reads something like Continue · Step 2 / 4 and you pick up where you stopped. On free projects every step of the guide is open; on Premium projects the guide, like the project itself, opens with Premium.

Example project: why the Traffic Light?

Traffic Light is one of the free, Beginner-level projects in BlueGrays: the red LED stays on for two seconds, yellow flashes briefly, green stays on for two seconds, then it goes back to red via yellow and the loop never stops. It is a good first project because it is one step beyond blinking a single LED but needs no new concept: you repeat the same three commands (pinMode, digitalWrite, delay) for three pins. Everyone knows what a traffic light looks like, so you can tell right away whether it works, and the parts come in every starter kit. If you want an even simpler start, the LED Blink project goes through the same four steps with one LED and two wires. Versions with a pedestrian button, an intersection and millis() are in the Arduino traffic light post; that post uses different pins, so follow the connections here as they appear in the app's project.

Step 1: Get the parts ready

The first screen shows 1. Get the parts ready and the note "Tick what you have. Spot anything missing now." Below it the project's parts are listed with quantities; find each part on your desk, tap it in the list to tick it, and the bar at the top fills up, for example "3 / 5 parts ready". If you use Premium and have saved your parts in your Workshop, the parts you have in sufficient quantity come pre-ticked with an In your workshop label. Don't rush this step: finding out halfway through the build that the third resistor is missing is far more annoying than noticing it before you start.

If a part is missing you usually don't have to give up. You can use 220 Ω instead of 330 Ω resistors; the LED gets a bit brighter and both values are safe. If you don't know the value of a resistor, enter its color bands in the resistor color code tool: 330 Ω reads orange-orange-brown, 220 Ω reads red-red-brown, and a fourth gold band is the tolerance. For another LED you can find the right resistor with the LED resistor calculator. If your LED colors are different (three red ones, say) the project still works, you just lose the traffic light look. If you don't have a board yet, try the circuit first in a Tinkercad simulation, and check the Arduino starter kit guide before you go shopping.

Step 2: Build the circuit

If you have never used a breadboard, one rule is enough: the five holes in a numbered column (A–E or F–J) are connected inside, and the groove in the middle separates the two halves. The long rows along the edges are the power rails; the one with the red line is for plus, the one with the blue line is for minus (GND), and they run the full length, although on some long breadboards they are split in the middle. In the Traffic Light diagram both legs of each LED go into two neighboring columns, a resistor jumps across the groove and carries one LED leg to the lower half, and the wire to the Arduino pin goes into the column where the lower end of the resistor sits. The other LED legs each go to the blue rail with a wire, and the blue rail goes to the Arduino's GND pin with a single wire. More detail in the what is a breadboard post.

An LED only works one way round and stays dark when it is reversed. The long leg is the anode (+), the short leg is the cathode (-), and the body has a slightly flat edge on the short-leg side. In this project the long leg goes to the Arduino pin through the resistor and the short leg goes to GND. The resistor limits the current: the pin supplies 5 V, a red LED drops about 2 V, and the remaining 3 V across 330 Ω gives about 9 mA (3 / 330). With 220 Ω this rises to about 14 mA; both values are comfortable for the LED and the Arduino pin. An LED without a resistor can fail quickly and strains the pin. If you want to go deeper, the what is an LED and what is a resistor posts cover it.

1. With the USB cable unplugged, start with GND: run a wire from the Arduino's GND pin to the breadboard rail with the blue line.
2. Place the three LEDs on the upper half of the breadboard, from left to right green, yellow, red; each LED's two legs in separate columns, with all the long legs on the same side.
3. From the column of each LED's long leg, add a 330 Ω resistor that crosses the groove to the lower half.
4. Run a wire from the column of each LED's short leg to the blue GND rail.
5. Run wires from the columns with the lower resistor ends to the Arduino: the red LED's resistor to pin 2, yellow's to pin 3, green's to pin 4.
6. When you are done, trace every path with your finger: pin, wire, resistor, long leg, LED, short leg, GND. There should be no gap and no two ends in the same column.
7. Tap the diagram in the guide to zoom in and compare it with your circuit; if everything matches, plug in the USB cable and go to Next step.

Step 3: Upload the code

This step shows the project's source code, the Show as blocks switch on projects that have blocks, and the Understand the code section that explains the code step by step. The computer, not the phone, uploads the code to the board, so first you need to install the Arduino IDE. In short: download the Arduino IDE 2 version for your operating system from the official Arduino website, install it and accept the driver prompts during installation; this usually takes about 10 minutes. The full walkthrough is in the Arduino IDE installation post. There are two ways to get the code onto your computer: use Copy and send it to yourself as a message, or use Copy Link to get a link that opens the code on your computer.

1. Open the Arduino IDE, start a new sketch from the File menu, delete everything in it and paste the project's code.
2. Connect the Arduino Uno to the computer with the USB cable; the board's ON light should be lit.
3. In Tools > Board, choose Arduino Uno under Arduino AVR Boards.
4. In Tools > Port, choose the port the board is connected to: on Windows something like COM3, on macOS a name starting with /dev/cu.usbmodem or /dev/cu.usbserial, on Linux something like /dev/ttyACM0.
5. First compile with the check mark icon on the left (Verify); if there are no errors, press the arrow icon next to it (Upload).
6. During the upload the small TX and RX lights on the board flicker; when the output panel at the bottom says the upload is done, go to Next step in the guide.

1// Trafik Lambası / Traffic Light
2void setup() {
3  pinMode(2, OUTPUT);   // Kırmızı LED / Red LED
4  pinMode(3, OUTPUT);   // Sarı LED / Yellow LED
5  pinMode(4, OUTPUT);   // Yeşil LED / Green LED
6}
7
8void loop() {
9  // Kırmızı yanar, 2 sn / Red on, 2 s
10  digitalWrite(2, HIGH);
11  digitalWrite(3, LOW);
12  digitalWrite(4, LOW);
13  delay(2000);
14  // Sarı yanar, 0,3 sn / Yellow on, 0.3 s
15  digitalWrite(2, LOW);
16  digitalWrite(3, HIGH);
17  digitalWrite(4, LOW);
18  delay(300);
19  // Yeşil yanar, 2 sn / Green on, 2 s
20  digitalWrite(2, LOW);
21  digitalWrite(3, LOW);
22  digitalWrite(4, HIGH);
23  delay(2000);
24  // Sarı yanar, sonra başa döner / Yellow on, then back to red
25  digitalWrite(2, LOW);
26  digitalWrite(3, HIGH);
27  digitalWrite(4, LOW);
28  delay(300);
29}
30

Step 4: Run and test

In the last step the guide says "It should work like this:" and shows the project video. Your circuit starts as soon as the code is uploaded: red stays on for 2 seconds, yellow gives a short 0.3-second flash, green stays on for 2 seconds, then another short yellow and back to red. One full cycle takes about 4.6 seconds and two LEDs are never on at the same time. The very short yellow is not a bug, it comes from the delay(300) line in the code; if you keep missing it, watch the yellow LED for a few cycles. Compare your circuit with the video using three questions: are the colors in the right order, are the timings close to the video, is each LED bright enough? If the answer to all three is yes, the project works.

Then tap It works!. The project is marked as completed and after a short celebration the It works, congratulations! screen opens. There you can give the project 1 to 5 stars (Rate the project), move on through the WHAT TO BUILD NEXT card or go back with Back to project. If you use Premium and the project's parts are not saved in your Workshop, the app first asks Add the parts to your workshop?; choose Add and complete and the missing parts are added and the project is completed, so your Workshop shows correctly which projects you can build next time.

If you get stuck: I'm stuck, Understand the code and the forum

• I'm stuck: next to the It works! button in step 4, it opens the project's ready-made checks on the same screen. The Traffic Light has 10 checks covering power, port, pin numbers, breadboard, GND, LED direction and resistor value. On projects without ready tips it tells you that you can write to us from Profile › Support.
• Understand the code: below the code in step 3. It starts with a "What does this code do?" summary, explains the code step by step and ends with a small Try it yourself task. If the code works but you don't know why, continue here; how to use it is in the Understand the code guide.
• Forum: in Learn › Forum, start a new topic in the Question category, share a clear photo of your circuit (up to 5 images) and the code you uploaded with Add code. If you write in three sentences which project you built, what you expected and what happened, answers come more easily. Ohmi, the BlueGrays mascot, also answers questions in the forum.
• Before asking for help: unplug the USB cable, compare the circuit with the diagram one last time and upload the code again. Most problems in first projects come from one reversed LED or a single wire in the wrong column.

Time plan for your first Arduino project

For a complete beginner, the Traffic Light takes 45–60 minutes including the computer setup. There is no need to hurry; the longest part is building and checking the circuit. On your second project the Arduino IDE and the board and port settings are already done, so the same flow drops to 25–30 minutes.

A sequence for your first 5 projects

After the Traffic Light, adding one new concept per project is the calmest way to learn. All five projects below are free in BlueGrays, with the circuit diagram, parts list, code, blocks and Understand the code open. You build each one with the guided mode in the same four steps, and each adds at most one or two new parts to what you already have.

If you want to leave this path, the app's Project Finder suggests projects that suit you, plus a free warm-up project with the same parts, when you pick This will be my first project for the question "How much experience do you have?". If you want to plan day by day what comes after these five, the 30-day Arduino roadmap takes you into weeks two and three.

After your first project: 3 small experiments

1. Change the timings. Change red's delay(2000) to delay(5000), change both yellow delay(300) lines to delay(1000) and upload again. A cycle grows from 4.6 to 9 seconds and looks more like a real traffic light. This experiment shows that the number in the code is directly the behavior of the circuit.
2. Add a second green LED for pedestrians. Take one more LED, a 330 Ω resistor and two wires, build the same connection on the free pin 5 and add pinMode(5, OUTPUT) to setup(). Write digitalWrite(5, HIGH) in the section where red is on and digitalWrite(5, LOW) in the other three. Pedestrians see green while cars wait at red; seeing which lines change to add one LED reinforces the idea of pins and outputs.
3. Make yellow blink. Replace the yellow section after green with three repeats that turn yellow on for 300 ms and off for 300 ms. First copy the lines three times by hand, then do the same with a for (int i = 0; i < 3; i++) loop. This is a natural lead-in to the main idea of the next project, LED Police Lights.

The real gain of your first Arduino project is not three glowing LEDs but the four-step flow itself: knowing the parts, building the circuit from a diagram, uploading the code and comparing the result with the expected behavior. That flow is the same for the Traffic Light and for a sensor project you will build months from now. When you open BlueGrays on your phone and tap Build it step by step on the Traffic Light, every step in this post will be waiting for you on screen.