ESP32 Partition Builder Web Application

The web application is here.

Youtube Tutorial

Troubleshooting

Do not forget to set the flash size correctly in the board options in the Arduino IDE or Arduino Workshop Extension for Visual Studio Code.

If you use Wi-Fi, BLE, or Preferences API an NVS partition is mandatory

If for some reason the flash size is not available in the board options you may need to adjust the maximum upload size in your boards definition.
The IDE has no way to read the custom partition, see this issue.

By default many of the custom partitions in boards definition have a 16MB max upload size, so if your board has less than 16MB flash memory, for example 4MB is typical, the compiler will report a wrong space occupied by your sketch.

To fix this, you have to edit the Espressif boards.txt file, which is normally located in
[your drive]\[your name]\AppData\Local\Arduino15\packages\esp32\hardware\esp32\[esp32 core version]

This is a very large file and you need to search for your specific board and change the line (here for the ESP32S3 Dev Module) :
esp32s3.menu.PartitionScheme.custom.upload.maximum_size=16777216
to
esp32s3.menu.PartitionScheme.custom.upload.maximum_size=4194304
for a microcontroller with 4MB flash memory.

When boards are updated by the IDE or you uninstall and reinstall it, you will have to redo your changes.

Partition table offset / large bootloaders

Use the “Partition Table Offset” control in the sidebar (0x8000 by default; 0x18000 for larger bootloaders). The app will realign partitions automatically—leave offsets blank in CSV files to have them adapt. Remember to build both bootloader and app with the same PARTITION_TABLE_OFFSET in sdkconfig, and keep the value a multiple of 0x1000.

Contributors

Contributors are welcomed! If you want to submit pull requests, here is how you can do it.

Recommended IDE Setup The recommended IDE setup is Visual Studio Code + Vue - Official extension.

Project Setup

npm install

Compile and Hot-Reload for Development

npm run dev