docs: add prek installation and hook setup to every setup guide

List uv and prek as prerequisites (pinned in mise.toml) and add the
`uv sync --all-groups && prek install` step to the Docker and local setup
guides in README.md, CONTRIBUTING.md and DEVELOPMENT.md: the hooks run on
the host even when developing with Docker. README.md gets a Git Hooks
section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: matrixise

CONTRIBUTING.md

@@ -29,6 +29,7 @@ This project follows the [Python Community Code of Conduct](https://www.python.o
 - **Docker** and **docker-compose** (recommended)
 - **Git**
 - **Task** (optional, for running predefined commands)
+- **uv** and **prek** (git hooks), pinned in `mise.toml` (`mise install`), see [Git Hooks (prek)](#git-hooks-prek)
 
 ### Repository Structure
 
@@ -57,6 +58,11 @@ website/
 git clone <repository-url>
 cd website
 
+# Install the git hooks (requires uv and prek, see "Git Hooks (prek)" below;
+# the ruff and Django hooks run on the host through `uv run`)
+uv sync --all-groups
+prek install
+
 # Build Docker image
 task docker:build
 # or: make docker-build
@@ -195,6 +201,8 @@ uv tool install prek    # uv
 The ruff and Django hooks run through `uv run`, so they also need the project
 environment (`uv sync --all-groups`).
 
+Then enable the hooks, once per clone (whether you develop with Docker or not):
+
 ```bash
 # Install the git hook once per clone
 prek install

DEVELOPMENT.md

@@ -101,6 +101,7 @@ pythonie/
 - Docker + docker-compose
 - Task (or Make)
 - Git
+- uv and prek (git hooks), pinned in `mise.toml` (`mise install`); see CONTRIBUTING.md for other ways to install prek
 
 ### Initial Setup (Docker - Recommended)
 
@@ -109,6 +110,11 @@ pythonie/
 git clone <repo-url>
 cd website
 
+# Install the prek git hooks (they run on the host: the ruff and Django hooks
+# use `uv run`, so the host environment is needed too)
+uv sync --all-groups
+prek install
+
 # 2. Build Docker image
 task docker:build
 

README.md

@@ -4,49 +4,55 @@ Website for Python Ireland (python.ie / pycon.ie) community, built with Django 6
 
 ## Prerequisites
 
-- Python 3.13 (see `mise.toml`)
+- Python 3.13, [uv](https://docs.astral.sh/uv/) and [prek](https://github.com/j178/prek) (git hooks), all pinned in `mise.toml`: run `mise install`, or see [Git Hooks](#git-hooks-prek) for other ways to install prek
 - Docker & Docker Compose (for containerized development - recommended)
 - [Task](https://taskfile.dev/) (optional but recommended)
 - Redis (only for local non-Docker development)
 - Environment variables file as per [the instructions here](#environment-variables)
 
 ## Quick Start (Docker - Recommended)
 
-1. Build the Docker image:
+1. Install the git hooks (the ruff and Django hooks run on the host through `uv run`):
+   ```bash
+   uv sync --all-groups
+   prek install
+   ```
+
+2. Build the Docker image:
    ```bash
    task docker:build
    # or: make docker-build
    ```
 
-2. Start supporting services:
+3. Start supporting services:
    ```bash
    docker compose up -d postgres redis minio
    ```
 
-3. Run database migrations:
+4. Run database migrations:
    ```bash
    task django:migrate
    ```
 
-4. Generate sample data (creates pages, navigation, meetups):
+5. Generate sample data (creates pages, navigation, meetups):
    ```bash
    task django:generate-sample-data
    # or: docker compose run --rm web python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev
    ```
 
-5. Create a superuser:
+6. Create a superuser:
    ```bash
    docker compose run --rm web python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev
    ```
 
-6. Start the development server:
+7. Start the development server:
    ```bash
    task run
    # or: docker compose run --rm --service-ports web python pythonie/manage.py runserver 0.0.0.0:8000
    ```
 
-7. Visit http://127.0.0.1:8000/ to see the site with sample content
-8. Access Wagtail admin at http://127.0.0.1:8000/admin/
+8. Visit http://127.0.0.1:8000/ to see the site with sample content
+9. Access Wagtail admin at http://127.0.0.1:8000/admin/
 
 ## Local Setup (Without Docker)
 
@@ -56,14 +62,15 @@ If you prefer to develop without Docker:
 2. Clone your fork: `git clone git@github.com:YourGitHubName/website.git`
 3. Ensure you are running Python 3.13: `python -V` should output `Python 3.13.x`
 4. Install dependencies: `uv sync --all-groups` (creates and populates a `.venv` automatically)
-5. Set up the database: `uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev`
-6. Generate sample data: `task django:generate-sample-data` (or `uv run python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev`)
-7. Create a superuser: `uv run python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev`
-8. Install and run Redis server locally: `redis-server`
-9. Set Redis environment variable: `export REDISCLOUD_URL=127.0.0.1:6379`
-10. Run the server: `uv run python pythonie/manage.py runserver --settings=pythonie.settings.dev`
-11. Visit http://127.0.0.1:8000/ to see the site with sample content
-12. Visit http://127.0.0.1:8000/admin/ to log in to Wagtail admin
+5. Install the git hooks: `prek install` (see [Git Hooks](#git-hooks-prek))
+6. Set up the database: `uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev`
+7. Generate sample data: `task django:generate-sample-data` (or `uv run python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev`)
+8. Create a superuser: `uv run python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev`
+9. Install and run Redis server locally: `redis-server`
+10. Set Redis environment variable: `export REDISCLOUD_URL=127.0.0.1:6379`
+11. Run the server: `uv run python pythonie/manage.py runserver --settings=pythonie.settings.dev`
+12. Visit http://127.0.0.1:8000/ to see the site with sample content
+13. Visit http://127.0.0.1:8000/admin/ to log in to Wagtail admin
 
 ## Project Structure
 
@@ -185,6 +192,26 @@ task code:lint
 task code:check
 ```
 
+### Git Hooks (prek)
+
+The repository uses [prek](https://github.com/j178/prek), a fast drop-in replacement for pre-commit, to run ruff, django-upgrade, the Django system checks, the missing migrations check and generic file checks on every commit. Like uv, prek is not a project dependency: install it on your machine, then enable the hooks in your clone.
+
+```bash
+# 1. Install prek (once per machine), with one of:
+mise install            # installs the versions pinned in mise.toml
+brew install prek
+uv tool install prek
+
+# 2. Enable the git hooks (once per clone)
+uv sync --all-groups    # the ruff and Django hooks run through `uv run`
+prek install
+
+# Run every hook on the whole repository (same as CI)
+prek run --all-files
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md#git-hooks-prek) for the list of hooks and how to skip one in an emergency.
+
 ## Environment Variables
 
 For Docker development, create/edit `development.env`: