Docs menu

Getting Started

Getting Started

Prepare Windows, launch Studio, preview a screen and flash the reference ESP32-P4 target.

Prerequisites

  • —Windows 11
  • —GitHub Desktop or Git for Windows
  • —Visual Studio Code recommended
  • —ESP-IDF 5.5.x; the documented baseline is 5.5.4

Create the workspace

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

Run first-time 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 preview and flash

  1. 01Launch ForgeUI Studio from the prepared source workspace.
  2. 02Select the Waveshare ESP32-P4-WiFi6-Touch-LCD-7B target.
  3. 03Create or open a project and place components on the 1024 × 600 Canvas.
  4. 04Open Browser Preview and verify geometry and interaction states.
  5. 05Connect the board over USB and confirm its serial port is available.
  6. 06Use Build & Flash and review the Flash Console through completion.
  7. 07Verify the same interface on the physical display.