New pre commit hooks + updated contributing guide

Author: stefan-ernst

.gitignore

@@ -139,5 +139,6 @@ releases/v0.3.2.md
 .crush
 .jscpd-frontend-report
 .jscpd-report
-scripts
+scripts/*
+!scripts/pre-commit
 .golangci-report.json

CONTRIBUTING.md

@@ -2,6 +2,8 @@
 
 Thanks for your interest in contributing! See the [README](README.md) for a project overview.
 
+> **Note:** The GitHub repository is a read-only push mirror. All development and contributions happen on [Codeberg](https://codeberg.org/realigned/windshift-core). Please fork, clone, and open pull requests there.
+
 ## Prerequisites
 
 - **Go** 1.25+
@@ -12,17 +14,30 @@ Thanks for your interest in contributing! See the [README](README.md) for a proj
 
 ```bash
 # Clone the repo
-git clone <repo-url> && cd core
+git clone https://codeberg.org/realigned/windshift-core.git && cd windshift-core/core
 
 # Install frontend dependencies
 cd frontend && npm install && cd ..
 
+# Install git hooks
+make hooks
+
 # Start PostgreSQL + dev server (SQLite for main app, PostgreSQL for logbook)
 ./dev.sh
 ```
 
 The dev server runs on `localhost:7777`.
 
+### Git Hooks
+
+The project includes a pre-commit hook that runs `golangci-lint` and `biome check` before each commit. Install it with:
+
+```bash
+make hooks
+```
+
+To bypass the hook for a quick commit, use `git commit --no-verify`.
+
 For frontend-only development with hot reload:
 
 ```bash
@@ -53,7 +68,6 @@ make dev-build
 │   └── database/      # Database setup and migrations
 ├── frontend/          # Svelte 5 / Vite / Tailwind CSS
 ├── cmd/ws/            # CLI client
-├── tests/             # Integration tests
 └── .github/workflows/ # CI pipelines
 ```
 
@@ -81,40 +95,9 @@ cd frontend
 npm run lint        # check
 npm run format      # auto-format
 ```
-
-## Testing
-
-### Go unit tests
-
-```bash
-make test           # runs with -tags="test" -race
-```
-
-### Go integration tests
-
-Requires a running server (start with `./dev.sh` first):
-
-```bash
-make integration-test
-```
-
-### Frontend unit tests
-
-```bash
-cd frontend && npm test
-```
-
-### Frontend E2E (Playwright)
-
-```bash
-cd frontend && npx playwright test
-```
-
-Production builds exclude test code via build tags (`-tags="!test"`).
-
 ## Submitting a Pull Request
 
-**Important**: Pull Requests will not be accepted on Github to prevent Spam. Please submit all PRs via https://codeberg.org/realigned/windshift-core
+Please open all pull requests on [Codeberg](https://codeberg.org/realigned/windshift-core).
 
 1. Push your branch and open a PR against `main`.
 2. CI will run automatically:

Makefile

@@ -19,7 +19,7 @@ BUILD_TAGS=-tags="!test"
 # Directories
 FRONTEND_DIR=frontend
 
-.PHONY: all build build-linux build-windows clean deps frontend help lint dev-build release test-setup
+.PHONY: all build build-linux build-windows clean deps frontend help hooks lint dev-build release
 
 # Default target
 all: clean frontend build
@@ -73,6 +73,14 @@ lint:
 		echo "golangci-lint not installed, run 'make dev-tools' first"; \
 	fi
 
+# Install git hooks
+hooks:
+	@echo "Installing git hooks..."
+	@mkdir -p .git/hooks
+	@cp scripts/pre-commit .git/hooks/pre-commit
+	@chmod +x .git/hooks/pre-commit
+	@echo "Pre-commit hook installed."
+
 # Quick development build
 dev-build:
 	@echo "Building development binary..."
@@ -84,15 +92,6 @@ release: clean deps frontend build
 	@echo "Binary: $(BINARY_NAME)"
 	@ls -lh $(BINARY_NAME)
 
-# Clone test repo and run tests locally
-test-setup:
-	@echo "Tests live in the private Windshiftapp/core-tests repo."
-	@echo ""
-	@echo "To run tests locally:"
-	@echo "  git clone git@github.com:Windshiftapp/core-tests.git /tmp/core-tests"
-	@echo "  /tmp/core-tests/overlay.sh ."
-	@echo "  go test -tags=\"test\" -race -timeout=15m ./..."
-
 # Show help
 help:
 	@echo "Windshift Build System"
@@ -109,11 +108,9 @@ help:
 	@echo "  make lint           - Run static analysis"
 	@echo "  make deps           - Update dependencies"
 	@echo ""
-	@echo "Testing:"
-	@echo "  make test-setup     - Instructions for running tests (separate repo)"
-	@echo ""
 	@echo "Utilities:"
 	@echo "  make frontend       - Build frontend only"
 	@echo "  make clean          - Clean build artifacts"
 	@echo "  make dev-tools      - Install development tools"
+	@echo "  make hooks          - Install git pre-commit hook"
 	@echo "  make help           - Show this help message"

README.md

@@ -69,6 +69,7 @@ Windshift is built on a minimalist philosophy: Lean frontend and backend while m
 ## Documentation
 
 - [BUILD.md](BUILD.md) - Build instructions
+- [CONTRIBUTING.md](CONTRIBUTING.md) - Contributing guide
 - [LOGGING.md](LOGGING.md) - Logging configuration
 
 ## License

scripts/pre-commit

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Pre-commit hook: runs Go and frontend linting before allowing a commit.
+# Bypass with: git commit --no-verify
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+FAILED=0
+
+echo "Running pre-commit checks..."
+
+# --- Go linting ---
+if command -v golangci-lint >/dev/null 2>&1; then
+    echo "  Running golangci-lint..."
+    if ! (cd "$REPO_ROOT" && golangci-lint run --timeout=5m); then
+        echo "FAIL: golangci-lint found issues."
+        FAILED=1
+    fi
+else
+    echo "  WARNING: golangci-lint not installed, skipping Go lint (run 'make dev-tools' to install)"
+fi
+
+# --- Frontend linting ---
+if [ -d "$REPO_ROOT/frontend" ]; then
+    echo "  Running frontend checks..."
+    if ! (cd "$REPO_ROOT/frontend" && npm run check); then
+        echo "FAIL: frontend check found issues."
+        FAILED=1
+    fi
+else
+    echo "  WARNING: frontend/ directory not found, skipping frontend checks"
+fi
+
+if [ "$FAILED" -ne 0 ]; then
+    echo ""
+    echo "Pre-commit checks failed. Fix the issues above or use 'git commit --no-verify' to bypass."
+    exit 1
+fi
+
+echo "All pre-commit checks passed."