Skip to content

Commit ff1a2c4

Browse files
TianqiYeclaude
andcommitted
Add comprehensive .gitignore and update PlatformIO installation docs
## 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]>
1 parent 9fab64a commit ff1a2c4

File tree

3 files changed

+52
-2
lines changed

3 files changed

+52
-2
lines changed

.gitignore

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,36 @@
22
.claude/settings.backup
33
.claude/current_mode
44
.claude/agents/
5+
6+
# PlatformIO
7+
.pio/
8+
.vscode/
9+
.pioenvs/
10+
.piolibdeps/
11+
12+
# Build artifacts
13+
*.bin
14+
*.elf
15+
*.map
16+
17+
# Python
18+
__pycache__/
19+
*.pyc
20+
*.pyo
21+
.Python
22+
23+
# IDE
24+
.idea/
25+
*.swp
26+
*.swo
27+
*~
28+
29+
# OS
30+
.DS_Store
31+
Thumbs.db
32+
33+
# Tool state
34+
.happy/
35+
36+
# Arduino CLI (legacy)
37+
bin/arduino-cli

CLAUDE.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,11 +66,28 @@ void loop() {
6666

6767
4) Build / Flash (ESP32‑S3) **PLATFORMIO**
6868

69-
## Quick Start
69+
## Installing PlatformIO (CM5/Raspberry Pi)
70+
71+
**Recommended: Use `uv` (fast & clean)**
7072
```bash
71-
pip install platformio # One-time install
73+
# Install uv (modern Python package manager)
74+
curl -LsSf https://astral.sh/uv/install.sh | sh
75+
source ~/.bashrc # Or restart terminal
76+
77+
# Install PlatformIO
78+
uv tool install platformio
79+
80+
# Verify
81+
pio --version
7282
```
7383

84+
**Alternative: Quick install (works immediately)**
85+
```bash
86+
pip3 install platformio --break-system-packages
87+
```
88+
89+
**Why uv?** 10-100x faster than pip, handles PATH automatically, keeps Python environment clean. It's the modern standard for installing Python CLI tools.
90+
7491
## Create New Game
7592
```bash
7693
# Create project structure

bin/arduino-cli

-32.8 MB
Binary file not shown.

0 commit comments

Comments
 (0)