chore: add some additional hooks for checking formatting

Author: sburton84

.pre-commit-config.yaml

@@ -1,6 +1,34 @@
+default_install_hook_types:
+  - pre-commit
+  - commit-msg
+
 repos:
+  - repo: builtin
+    hooks:
+      - id: trailing-whitespace
+        exclude: '^sphinx-ui/demo/'
+      - id: end-of-file-fixer
+        exclude: '^sphinx-ui/demo/'
+      - id: check-yaml
+      - id: check-json
+        exclude: 'tsconfig.*\.json$'
+
   - repo: local
     hooks:
+      - id: no-tabs
+        name: No tabs in source files
+        language: pygrep
+        entry: '\t'
+        types_or: [ts, tsx, javascript, jsx, python, css]
+        exclude: '(node_modules|sphinx-ui/demo/build)'
+
+      - id: documentation-ui-format
+        name: Biome format check (documentation-ui)
+        language: system
+        entry: bash -c 'cd documentation-ui && npx biome format src stories'
+        pass_filenames: false
+        files: '^documentation-ui/(src|stories)/.*\.(ts|tsx|js|jsx|css|json)$'
+
       - id: commitlint
         name: commitlint
         language: system

README.md

@@ -0,0 +1,54 @@
+# documentation-ui
+
+Monorepo containing the Quantinuum documentation UI component library
+(`documentation-ui/`) and the Sphinx theme (`sphinx-ui/`).
+
+## Pre-commit hooks
+
+This repository uses [prek](https://prek.j178.dev/) to enforce formatting and
+commit message conventions before each commit. prek is a fast, dependency-free
+alternative to `pre-commit`, written in Rust.
+
+### Prerequisites
+
+- **Node.js / npm** — required by the Biome format check and commitlint hooks.
+
+No Python or other runtime is needed to run prek itself.
+
+### Installation
+
+1. Install prek using the standalone installer:
+
+   ```sh
+   curl -LsSf https://prek.j178.dev/install.sh | sh
+   ```
+
+   Or via pip / pipx if you prefer a Python-managed install:
+
+   ```sh
+   pipx install prek
+   ```
+
+2. Install the git hooks into the repository:
+
+   ```sh
+   prek install
+   ```
+
+   Because the config sets `default_install_hook_types`, this single command
+   installs both the `pre-commit` and `commit-msg` shims automatically.
+
+### Running hooks manually
+
+To run all hooks against every file (useful after initial setup or to check
+the full codebase):
+
+```sh
+prek run --all-files
+```
+
+To run a single hook by id:
+
+```sh
+prek run no-tabs --all-files
+```