chore: import local project into Gitea

.gitignore

@@ -0,0 +1,35 @@
+# OS / tooling
+.DS_Store
+Thumbs.db
+
+# Editors
+.cursor/
+
+# Secrets
+.env
+.env.*
+!.env.example
+!.env.template
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+
+# Node / frontend
+node_modules/
+dist/
+
+# Typical embedded / tooling noise
+*.log
+
+# Builds (adjust per subtree if needed)
+**/build/.ninja_deps
+**/build/.ninja_log
+
+# Firmware binaries belong in Gitea releases with hashes, not Git history
+*.bin
+*.uf2
+*.elf
+*.map

README.md

@@ -0,0 +1,14 @@
+# s3-ai-friend firmware artifact
+
+Stores **`merged-binary.bin`** (~10 MB merged image dated Sep 2025 in this folder).
+
+### Flashing sanity
+
+Identify whether this corresponds to ESP32‑S3 (UF2/bootloader offsets) or another SOC before writing with `esptool` / `chrome` UF2 tooling / vendor flasher — misaligned writes brick boards.
+
+### Git hosting guidance
+
+Treat firmware blobs like release artifacts:
+
+- Prefer **`git-lfs track '*.bin'`** or forge **Releases**.
+- Ship checksums (`sha256`) in commits when you bump firmware.