feat: add fast pre-commit hooks with prek and CI workflow

.github/workflows/test.yml

@@ -0,0 +1,51 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, github-links ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup pixi
+      uses: prefix-dev/[email protected]
+      with:
+        pixi-version: v0.55.0
+        environments: test
+
+    - name: Run tests with coverage
+      run: pixi run -e test test
+
+    - name: Upload coverage reports to Codecov
+      if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup pixi
+      uses: prefix-dev/[email protected]
+      with:
+        pixi-version: v0.55.0
+        environments: dev
+
+    - name: Run CI pipeline (lint + type-check + test)
+      run: pixi run -e dev ci

.pre-commit-config.yaml

@@ -0,0 +1,53 @@
+# Pre-commit configuration for conda-sphinx-theme
+# Using prec (Rust-based pre-commit) for fast execution
+repos:
+  # Ruff for fast Python linting and formatting
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.1
+    hooks:
+      - id: ruff
+        args: [--fix]
+        files: ^(conda_sphinx_theme|tests)/.*\.py$
+      - id: ruff-format
+        files: ^(conda_sphinx_theme|tests)/.*\.py$
+
+  # Type checking with ty (Astral's fast type checker)
+  - repo: local
+    hooks:
+      - id: ty-check
+        name: Type check with ty
+        entry: pixi run -e dev ty check conda_sphinx_theme/
+        language: system
+        files: ^conda_sphinx_theme/.*\.py$
+        pass_filenames: false
+        always_run: false
+
+  # Built-in hooks for general file hygiene
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: ^docs/.*$
+      - id: end-of-file-fixer
+        exclude: ^docs/.*$
+      - id: check-yaml
+        args: [--unsafe]  # Allow custom YAML tags
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: [--maxkb=1000]
+
+  # Additional Python-specific checks
+  - repo: https://github.com/pre-commit/pygrep-hooks
+    rev: v1.10.0
+    hooks:
+      - id: python-check-blanket-noqa
+        exclude: ^docs/.*$  # Sphinx configs often have blanket noqa
+      - id: python-check-blanket-type-ignore
+      - id: python-no-log-warn
+      - id: python-use-type-annotations
+
+
+# disable autofixing PRs, commenting "pre-commit.ci autofix" on a pull request triggers a autofix
+ci:
+  autofix_prs: false

docs/changelog.rst

@@ -0,0 +1,27 @@
+==========
+Changelog
+==========
+
+Version 1.2.0
+==============
+
+New Features
+------------
+
+* Added GitHub links extension to automatically convert issue references to links
+* Fixed issue with header styling (#123)
+* Resolved navigation problem (conda-incubator/conda-sphinx-theme#456)
+* Added new icon support (#789)
+
+Bug Fixes
+---------
+
+* Fixed CSS overflow issue (#101)
+* Resolved theme compatibility with Sphinx 7.x (#202)
+* Fixed mobile responsive layout (conda/conda#303)
+
+Version 1.1.0
+==============
+
+* Initial release with basic theming (#001)
+* Added conda branding elements (#002)