Add Sphinx documentation site

- docs/conf.py: pydata-sphinx-theme, sphinx-autoapi, myst-parser, intersphinx
- docs/index.md: landing page with feature table and toctree
- docs/installation.md, quickstart.md, changelog.md
- docs/user_guide/: decision_geometry, latent_space, sensitivity_projection, configuration
- docs/tutorials/index.md: all 7 notebooks with Open-in-Colab badges
- docs/_static/custom.css: brand colours + layout tweaks
- .readthedocs.yaml: ReadTheDocs build config (Python 3.11, ubuntu-22.04)
- .github/workflows/docs.yml: CI build on every push/PR to main
- setup.cfg: added [docs] extras_require

Author: FirePheonix

.github/workflows/docs.yml

@@ -0,0 +1,34 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[umap]"
+          pip install -r docs/requirements.txt
+
+      - name: Build docs
+        run: sphinx-build -b html docs docs/_build/html -W --keep-going
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        if: github.ref == 'refs/heads/main'
+        with:
+          name: docs-html
+          path: docs/_build/html
+          retention-days: 7

.readthedocs.yaml

@@ -0,0 +1,18 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: false
+
+python:
+  install:
+    - requirements: docs/requirements.txt
+    - method: pip
+      path: .
+      extra_requirements:
+        - umap

docs/_static/custom.css

@@ -0,0 +1,28 @@
+/* GeoLatent docs custom styles */
+
+:root {
+    --pst-color-primary: #58a6ff;
+    --pst-color-secondary: #3fb950;
+}
+
+/* Wider content area */
+.bd-main .bd-content .bd-article-container {
+    max-width: 900px;
+}
+
+/* Code blocks */
+div.highlight pre {
+    border-left: 3px solid var(--pst-color-primary);
+}
+
+/* API parameter tables */
+.field-list dt {
+    font-family: var(--pst-font-family-monospace);
+    color: var(--pst-color-primary);
+}
+
+/* Badges in tutorials index */
+img[alt="Open In Colab"] {
+    vertical-align: middle;
+    margin-left: 8px;
+}

docs/changelog.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.0 (2026-02-25)
+
+Initial release.
+
+### Added
+
+- `visualize_decision_geometry()` — 3-D decision boundary isosurfaces via PCA / sensitivity inverse-transform
+- `inspect_latent_space()` — latent space visualisation with PCA / t-SNE / UMAP
+- Sensitivity projection — model-driven axes via finite-difference Jacobians, works with any callable
+- `feature_names` support — axis labels show top contributing features
+- Mahalanobis confidence ellipsoids at configurable probability levels
+- Convex hull overlays per class
+- Optimisation trajectory rendering
+- `DARK_SCIENTIFIC` theme — dark-scientific colour palette with fluent config helpers
+- Full type annotations and `py.typed` marker

docs/conf.py

@@ -0,0 +1,87 @@
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath(".."))
+
+project = "GeoLatent"
+author = "GeoLatent Contributors"
+copyright = "2026, GeoLatent Contributors"
+release = "0.1.0"
+
+extensions = [
+    "autoapi.extension",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.viewcode",
+    "sphinx.ext.intersphinx",
+    "myst_parser",
+    "sphinx_copybutton",
+]
+
+# Auto-generate API docs from source
+autoapi_dirs = ["../geolatent"]
+autoapi_type = "python"
+autoapi_options = [
+    "members",
+    "undoc-members",
+    "show-inheritance",
+    "show-module-summary",
+    "imported-members",
+]
+autoapi_keep_files = False
+autoapi_add_toctree_entry = True
+autoapi_python_class_content = "both"
+
+# Napoleon — numpy-style docstrings
+napoleon_google_docstring = False
+napoleon_numpy_docstring = True
+napoleon_use_param = True
+napoleon_use_rtype = True
+
+# Cross-package links
+intersphinx_mapping = {
+    "python":   ("https://docs.python.org/3", None),
+    "numpy":    ("https://numpy.org/doc/stable", None),
+    "sklearn":  ("https://scikit-learn.org/stable", None),
+    "plotly":   ("https://plotly.com/python-api-reference", None),
+}
+
+# MyST
+myst_enable_extensions = ["colon_fence", "deflist"]
+source_suffix = {".rst": "restructuredtext", ".md": "markdown"}
+
+html_theme = "pydata_sphinx_theme"
+html_title = "GeoLatent"
+
+html_theme_options = {
+    "logo": {
+        "text": "GeoLatent",
+    },
+    "github_url": "https://github.com/FirePheonix/geolatent",
+    "navbar_end": ["navbar-icon-links", "theme-switcher"],
+    "secondary_sidebar_items": ["page-toc", "edit-this-page"],
+    "footer_start": ["copyright"],
+    "footer_end": ["sphinx-version"],
+    "pygments_light_style": "friendly",
+    "pygments_dark_style": "monokai",
+    "navigation_with_keys": True,
+    "show_toc_level": 2,
+    "icon_links": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/FirePheonix/geolatent",
+            "icon": "fa-brands fa-github",
+        },
+        {
+            "name": "PyPI",
+            "url": "https://pypi.org/project/geolatent/",
+            "icon": "fa-brands fa-python",
+        },
+    ],
+}
+
+html_static_path = ["_static"]
+html_css_files = ["custom.css"]
+html_show_sourcelink = False
+
+templates_path = ["_templates"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]

docs/index.md

@@ -0,0 +1,85 @@
+# GeoLatent
+
+**Geometry-aware, model-intelligent 3-D visualisations for machine learning workflows.**
+
+[![PyPI](https://img.shields.io/pypi/v/geolatent.svg)](https://pypi.org/project/geolatent/)
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/FirePheonix/geolatent/blob/main/LICENSE)
+
+---
+
+GeoLatent renders the true 3-D decision boundary of any classifier and the geometric
+structure of any embedding space — in a single function call.
+
+```python
+from geolatent import visualize_decision_geometry
+from sklearn.svm import SVC
+
+model = SVC(kernel="rbf", probability=True).fit(X, y)
+fig = visualize_decision_geometry(model, X, y, projection_method="sensitivity")
+fig.show()
+```
+
+## Why GeoLatent?
+
+| | Standard wrappers | GeoLatent |
+|---|---|---|
+| Projection | Fixed 2-D PCA | PCA · t-SNE · UMAP · Sensitivity |
+| Decision surfaces | Axis-aligned slices | True 3-D isosurfaces via inverse-transform |
+| Confidence regions | None | Nested probability shells + Mahalanobis ellipsoids |
+| Model interface | sklearn only | Any `predict` / `predict_proba` callable |
+| Projection axes | Data-driven | **Model-driven** via finite-difference Jacobians |
+
+The sensitivity projection is GeoLatent's key differentiator: it computes
+finite-difference Jacobians of any model to find the three directions in feature
+space where the decision function changes fastest — axes that are task-relevant
+regardless of input dimensionality.
+
+---
+
+## Install
+
+```bash
+pip install geolatent
+```
+
+With UMAP support:
+
+```bash
+pip install "geolatent[umap]"
+```
+
+---
+
+```{toctree}
+:maxdepth: 1
+:caption: Getting Started
+
+installation
+quickstart
+```
+
+```{toctree}
+:maxdepth: 2
+:caption: User Guide
+
+user_guide/decision_geometry
+user_guide/latent_space
+user_guide/sensitivity_projection
+user_guide/configuration
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Tutorials
+
+tutorials/index
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Reference
+
+autoapi/index
+changelog
+```

docs/installation.md

@@ -0,0 +1,59 @@
+# Installation
+
+## Requirements
+
+| Package | Version |
+|---|---|
+| Python | ≥ 3.9 |
+| NumPy | ≥ 1.23 |
+| SciPy | ≥ 1.9 |
+| scikit-learn | ≥ 1.1 |
+| Plotly | ≥ 5.13 |
+
+## pip
+
+```bash
+pip install geolatent
+```
+
+## Optional dependencies
+
+UMAP projection requires `umap-learn`:
+
+```bash
+pip install "geolatent[umap]"
+```
+
+Static image export (PNG, SVG) requires `kaleido`:
+
+```bash
+pip install "geolatent[export]"
+```
+
+Install everything at once:
+
+```bash
+pip install "geolatent[umap,export]"
+```
+
+## Google Colab
+
+```python
+!pip install -q geolatent
+# Restart runtime after installation, then import normally
+```
+
+## Verify
+
+```python
+import geolatent
+print(geolatent.__version__)
+```
+
+## Development install
+
+```bash
+git clone https://github.com/FirePheonix/geolatent.git
+cd geolatent
+pip install -e ".[dev]"
+```