Platformio migration #1
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
## Changes **Build System:** - Switch from Arduino CLI to PlatformIO - Fix flash size issue (use adafruit_feather_esp32s3 board = 4MB) - No more HTTP/2 timeout hacks needed **Library Structure:** - Move BoardConfig and MatrixUtil to root lib/ directory - Single source of truth: lib/BoardConfig/BoardConfig.h - All games use shared libs via lib_extra_dirs = ../../lib - Clean includes: <BoardConfig.h> and <MatrixUtil.h> **Documentation:** - Complete PlatformIO workflow in CLAUDE.md - Added "Upload Troubleshooting" section with button sequences - Clear beginner-friendly instructions for BOOT/RESET usage **Example:** - RotatingDonut/ now uses PlatformIO structure - Working reference with platformio.ini template - Builds and uploads successfully 🤖 Generated with Claude Code https://claude.com/claude-code Co-Authored-By: Claude <[email protected]>
## Changes **Documentation:** - Update CLAUDE.md with `uv` as recommended PlatformIO installation method - Add pip3 --break-system-packages as quick alternative - Explain why uv: 10-100x faster, auto PATH handling, clean environment **.gitignore:** - Add PlatformIO build artifacts (.pio/, .vscode/, etc.) - Add build outputs (*.bin, *.elf, *.map) - Add Python cache files (__pycache__/, *.pyc, etc.) - Add IDE and OS files - Ignore .happy/ tool state directory - Explicitly ignore bin/arduino-cli (legacy) **Cleanup:** - Remove bin/arduino-cli (switched to PlatformIO) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
- Add AGENT AUTOMATION INSTRUCTIONS section to CLAUDE.md with: - PATH configuration requirements for pio commands - Automated build & upload workflow - Upload failure recovery steps - Success/error indicators for troubleshooting - Add examples/FallingStars: physics-based particle animation - Colorful particles fall with gravity and stack up - Uses 6 vibrant colors (red, green, blue, yellow, magenta, cyan) - Demonstrates collision detection and accumulation
TianqiYe
added a commit
that referenced
this pull request
Oct 20, 2025
Merged platformio-migration branch into main, accepting the incoming CLAUDE.md file which contains updated PlatformIO workflow documentation. ## Changes - Updated .gitignore for PlatformIO artifacts - Updated CLAUDE.md with PlatformIO installation and workflow - Removed legacy bin/arduino-cli - Added examples/RotatingDonut/ with PlatformIO structure - Moved BoardConfig from config/ to lib/BoardConfig/ - Added library.json files for shared libraries 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.