diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..253473c
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,41 @@
+# Git and repo metadata
+.git
+.gitignore
+.gitattributes
+
+# Dependencies and lockfiles (not needed in image; we only COPY src/)
+node_modules
+.pnpm-store
+.npm
+package-lock.json
+pnpm-lock.yaml
+yarn.lock
+bun.lockb
+package.json
+
+# Dev and CI config (image only needs src/ + Dockerfile)
+.devcontainer
+.vscode
+.woodpecker
+*.md
+README*
+.dockerignore
+eslint.config.js
+.prettierrc
+.prettierignore
+.stylelintrc.json
+.stylelintignore
+
+# Local env and logs
+.env
+.env.*
+*.log
+
+# OS and IDE
+.DS_Store
+Thumbs.db
+.idea
+
+# Optional: uncomment if you add a build step that writes to dist/
+# dist
+# build