diff --git a/.npmignore b/.npmignore
index 63ff007..770263c 100644
--- a/.npmignore
+++ b/.npmignore
@@ -1,7 +1,47 @@
+# .npmignore - Files and directories to exclude from the npm package
+
+# Node modules - Exclude installed dependencies
 node_modules/
+
+# Build directories - Exclude build and public output directories
 public/
+dist/
+
+# Build configuration files - Exclude build config files
 webpack.config.js
 webpack.config.ts
-.DS_Store
-*/.DS_Store
-dist/package.json
\ No newline at end of file
+
+# OS-specific files - Exclude system-specific files
+.DS_Store           # macOS Finder metadata
+*/.DS_Store         # .DS_Store in any subdirectory
+
+# Package metadata - Exclude unnecessary package metadata files
+dist/package.json
+
+# Logs and temporary files - Exclude log files and temporary directories
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+*.log
+*.tmp
+
+# IDE and editor configurations - Exclude IDE-specific settings and files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Test and documentation files - Exclude test files and documentation
+tests/
+*.spec.js
+*.spec.ts
+*.test.js
+*.test.ts
+coverage/
+docs/
+*.md
+
+# Ignore all dotfiles (except for specific ones needed)
+.*
+!.npmignore
+!.gitignore
\ No newline at end of file