Demo projects

Self-contained PlatformIO projects that show how to use the engine on PC (SDL2) and ESP32-class boards. Each project has its own platformio.ini, src/ entry point, and README.md with build flags, supported environments, and documentation links.

They live in their own repository: PixelRoot32-Demo-Projects.

Typical workflow: open a project folder in PlatformIO (or run the CLI from that folder), pick an environment (native, esp32dev, etc.), then:

cd <category>/<demo>
pio run -e <environment>

On Windows, native builds may need local SDL2 include/lib paths in platformio.ini (see the comments in each project).

The engine revision a demo builds against is defined in lib_deps inside that demo's platformio.ini (registry tag vs Git branch).

Catalogue

31 demos across 8 categories.

Getting Started

• First Sprite — source code
• Hello World — source code

Graphics

• Depth Sort — source code
• Iso Dungeon — source code
• Iso Tilemap Export — source code
• Palette Swap — source code
• Particles — source code

Input

• Digital Buttons — source code
• Touch Controls — source code

Audio

• Music Sequencer — source code
• SFX Bank — source code

Gameplay

• Metroidvania — source code
• Object Pool — source code
• Room Screen — source code
• State Machine — source code

UI

• HUD Widgets — source code
• Menu Navigation — source code

Performance

• Dirty Regions — source code
• Memory Budget — source code

Games

• 2048 — source code
• Bomberbot — source code
• Brick Breaker — source code
• Chess — source code
• Flappy Bird — source code
• Legend Of Clone — source code
• Midway Clone — source code
• Pong — source code
• Snake — source code
• Space Invaders — source code
• Tic Tac Toe — source code
• Top Down City — source code