Docs menu

Getting Started

Getting Started

Choose a supported board, design a screen, build in Hosted Studio and flash it from the browser.

Hosted path prerequisites

  • —A ForgeUI Hosted Studio account with current access
  • —A supported ESP32-P4 board
  • —A USB data connection
  • —A browser and operating system compatible with the connection flow shown by Hosted Studio

Optional local source workspace

bash
C:
cd \
mkdir ForgeUI
mkdir ForgeUI\Projects
cd ForgeUI\Projects
git clone https://github.com/RTechAI/esp32p4-ui-studio.git

Optional local Studio setup

The batch file delegates to the ForgeUI PowerShell preflight with repair enabled.

text
FIRST_TIME_FORGEUI_SETUP.bat

The supplied batch file launches tools/startup/forgeui-preflight.ps1 with repair enabled. It verifies the project structure, Node.js/npm, Python, ESP-IDF, optional OpenAI configuration and required ports, and can repair project packages plus Pillow, pypng and lz4.

First Hosted build and browser flash

  1. 01Open ForgeUI Hosted Studio and select a supported Waveshare or Guition ESP32-P4 profile.
  2. 02Create or open a project and design on the board-sized Canvas.
  3. 03Save, open LVGL Simulator and choose Simulate LVGL. Inspect and refine before connecting hardware.
  4. 04Generate the project firmware.
  5. 05Start the Hosted build and review its result when complete.
  6. 06Connect the ESP32-P4 board through the browser.
  7. 07Confirm the detected target matches the selected board before flashing.
  8. 08Flash the firmware, then verify the interface on the physical display.