diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..3b9e644
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,8 @@
+# The JavaScript under crates/pocket-pi/js/ is GENERATED by `node js/build.mjs`
+# from the TypeScript sources in js/src/ (plus the esbuild bundle of pi). It is
+# committed only so `cargo` builds Rust-only (the crate embeds it via
+# include_str!) — it is build output, not source. Mark it generated so GitHub's
+# language stats and diffs treat it as such; the real sources are the .ts.
+crates/pocket-pi/js/*.js linguist-generated=true
+crates/pocket-pi/js/node/*.js linguist-generated=true
+crates/pocket-pi/js/pi-full/*.js linguist-generated=true