Build From Source
Reproduce the Firmware v1.0.0 build environment before making code changes.
ESPFlight Docs · v1 • Validated v1 documentation path
# Pinned environment
| Dependency | Version |
|---|---|
| Target | LOLIN(WEMOS) D1 R2 & mini / ESP8266 |
| ESP8266 Arduino Core | 3.1.2 |
| CPU | 160 MHz |
| ArduinoJson | 6.21.6 |
| ESPAsyncTCP | 2.0.0 |
| ESPAsyncWebServer | 3.6.0 |
| Adafruit VL53L0X | 1.2.5 — optional assisted-flight variant |
# Developer workflow
- 1
Clone the firmware repository
Keep the official v1.0.0 tag available as the comparison baseline.
- 2
Install the pinned dependencies
Avoid silently substituting a different major library version.
- 3
Set private Wi-Fi credentials locally
Do not commit credentials.
- 4
Compile the unmodified baseline first
Prove your toolchain can reproduce a clean build.
- 5
Make one focused change
Keep the diff understandable and testable.
- 6
Run propeller-off validation
Then perform controlled flight validation if the change can affect flight behavior.