Board Ports

Port ForgeUI to another board.

Waveshare 7B and the tested Guition JC8012P4A1C P4 v1.x/pre-v3 target are currently verified. Proposed ports must not be presented as official support before hardware evidence and review.

Support levels

RTech maintained

Waveshare 7B

Waveshare ESP32-P4-WiFi6-Touch-LCD-7B — 1024×600 landscape with GT911 and an ESP32-C6 companion. Physically proven and supported.

RTech maintained

Guition 10.1-inch

JC8012P4A1C 800×1280 portrait. Physically proven and supported for tested P4 v1.x/pre-v3 hardware only.

Community maintained

Community Port

No verified entries yet. Requires a named maintainer, hardware proof and documented limitations.

Proposal only

Planned or Requested

No implementation claim. Track proposals through GitHub Issues.

Review supported hardware →

Required port evidence

  • Project builds and flashes
  • Display initialises
  • Touch works where applicable
  • Generated UI renders
  • At least one interactive component works
  • Preview-to-hardware proof supplied
  • Setup documentation and limitations included
  • Maintainer identified

Board integration checklist

A credible port normally documents display initialisation, resolution, colour format, touch, backlight, storage, wireless capability, BSP dependencies, sdkconfig defaults, partitions, target and flash instructions.

Proposed format

Board definition manifest

ForgeUI does not currently claim a plugin-based board registry. This is a proposed contribution format for consistent review.

type ForgeUIBoardDefinition = {
  id: string;
  name: string;
  vendor: string;
  chip: string;
  resolution: { width: number; height: number };
  colorFormat: string;
  displayDriver: string;
  touchDriver?: string;
  capabilities: string[];
  supportLevel: "official" | "community" | "experimental";
  maintainer?: string;
  docsUrl?: string;
};