Quick Start
Generate your first Nordic nRF firmware project with FirmwareMaestro in under five minutes.
This guide walks you from "I have an idea" to a downloadable Zephyr project bundle in about five minutes.
1. Create a project
Sign in to the dashboard, then click New Project. You'll be prompted for a few details:
- Project name — a short identifier for your build
- Target hardware — pick a Nordic kit (e.g.
nRF52840 DK,nRF5340 DK,nRF9160 DK) - Use case — e.g. BLE peripheral, Matter accessory, cellular IoT, Thread mesh node
FirmwareMaestro auto-detects the right Zephyr project type based on your hardware and use case selection. You can override any of this later.
2. Generate documents
From the project view, you can generate any of the 12 supported document types. We recommend starting with:
PRD (Product Requirements Document)
Captures goals, constraints, target users, success metrics, and scope. This becomes the context for every downstream generator.
Hardware Abstraction Layer
Maps Nordic peripherals (GPIO, SPI, I2C, UART, ADC, PWM, BLE, NFC, USB) to your project requirements.
Firmware Architecture
Defines tasks/threads, queues, ISR boundaries, and module structure following Zephyr best practices.
Code Scaffold
Produces the actual project files — main.c, CMakeLists.txt, prj.conf,
Kconfig fragments, and Device Tree overlays.
3. Download and build
Click Download ZIP to get a structured archive:
my-project/
├── docs/ # All generated technical documents
│ ├── prd.md
│ ├── hardware-abstraction.md
│ └── firmware-architecture.md
├── src/
│ └── main.c
├── boards/
│ └── nrf52840dk_nrf52840.overlay
├── CMakeLists.txt
├── prj.conf
└── .cursorrulesOpen it in your nRF Connect SDK environment, then build and flash:
west build -b nrf52840dk_nrf52840
west flashWhat's next
- Learn how the fwm CLI agent brings the same workflow into your terminal
- Read the 6-phase Dev Guide for the full development workflow
- Browse Best Practices for embedded firmware quality guidance