From 5dd75e08d1d1ce4dbe1a641d70729e6a3af478ec Mon Sep 17 00:00:00 2001
From: drjones <indianaholmes1@icloud.com>
Date: Wed, 20 May 2026 10:05:17 -0700
Subject: [PATCH] chore: import local project into Gitea

---
 .gitignore | 35 +++++++++++++++++++++++++++++++++++
 README.md  | 14 ++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..373c38b
--- /dev/null
+++ b/.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
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c9c65ec
--- /dev/null
+++ b/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.