Add optional pre-commit hook for code formatting

.githooks/pre-commit

@@ -0,0 +1,27 @@
+#!/bin/bash
+set -e
+
+echo "🔍 Checking code formatting..."
+
+# Run dotnet format in verify mode (check only, don't modify)
+# This matches the CI command exactly
+if dotnet format Sentry.slnx --verify-no-changes --no-restore \
+  --exclude ./modules ./**/*OptionsSetup.cs ./test/Sentry.Tests/AttributeReaderTests.cs 2>&1 | grep -q "formatted"; then
+
+  echo ""
+  echo "❌ Code formatting issues found!"
+  echo ""
+  echo "Please run the following command to fix formatting:"
+  echo ""
+  echo "  dotnet format Sentry.slnx --no-restore --exclude ./modules ./**/*OptionsSetup.cs ./test/Sentry.Tests/AttributeReaderTests.cs"
+  echo ""
+  echo "Then stage the changes and commit again:"
+  echo ""
+  echo "  git add -u"
+  echo "  git commit"
+  echo ""
+  exit 1
+fi
+
+echo "✅ Code formatting looks good!"
+exit 0

CONTRIBUTING.md

@@ -22,6 +22,24 @@ For a big feature it's advised to raise an issue to discuss it first.
 * To quickly get up and running, you can just run `dotnet build SentryNoMobile.slnf` (you're skipping the mobile targets)
 * To run a full build in Release mode and test, before pushing, run `./build.sh` or `./build.cmd`
 
+## Git Hooks (Optional but Recommended)
+
+To automatically verify code formatting before committing, you can set up a pre-commit hook:
+
+```bash
+./scripts/setup-hooks.sh
+```
+
+This configures git to run `dotnet format --verify-no-changes` before each commit. If formatting issues are found, the commit will be prevented and you'll need to run:
+
+```bash
+dotnet format Sentry.slnx --no-restore --exclude ./modules ./**/*OptionsSetup.cs ./test/Sentry.Tests/AttributeReaderTests.cs
+```
+
+Then stage the formatting changes and commit again. This helps catch formatting issues early and reduces CI failures.
+
+**Note:** You can bypass the hook for a specific commit using `git commit --no-verify` if needed.
+
 ## Minimal Dependencies
 
 * The latest versions of the following .NET SDKs:

scripts/setup-hooks.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -e
+
+echo "Setting up git hooks..."
+
+# Configure git to use .githooks directory for hooks
+git config core.hooksPath .githooks
+
+echo ""
+echo "✅ Git hooks configured successfully!"
+echo ""
+echo "The pre-commit hook will now verify code formatting before each commit."
+echo "To bypass the hook for a specific commit, use: git commit --no-verify"
+echo ""