diff --git a/.gitignore b/.gitignore
index 75438657..e9c42cec 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,26 @@
-.idea/
+# Dependencies
+node_modules/
+
+# Antora build output and cache
+build/
+.cache/
+antora.log
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Lockfile — yarn.lock is the committed source of truth
+package-lock.json
+
+# OS
 .DS_Store
-node_modules
-build
+Thumbs.db
+
+# Editors / IDEs
+.idea/
+.vscode/
+*.swp
+*~