feat: stable kaamiki release (14.2.2026) (#170)

* build: theme name is now official
* chore: add pause on hover
* refactor: doc-search is now fully deprecated
* refactor: remove deprecated code
* style: remove doc-search
* refactor(kaamiki): modernise styles

Signed-off-by: Akshay Mestry <xa@mes3.dev>

Author: xames3

.github/workflows/cd.yml

@@ -3,7 +3,7 @@
 #
 # Author: Akshay Mestry <xa@mes3.dev>
 # Created on: 26 August, 2025
-# Last updated on: 02 November, 2025
+# Last updated on: 15 February, 2026
 
 name: Continuous Deployment
 run-name: Started ${{ github.workflow }} (CD) workflow
@@ -17,13 +17,10 @@ on:
         default: "production"
 
 env:
-  ARTIFACT_NAME: xa-pages
+  ARTIFACT_NAME: webpages
   OUTPUT_DIR: docs/build/
   SOURCE_DIR: docs/source/
-  PYTHON_VERSION: "3.13.2"
-  DOCSEARCH_APP_ID: ${{ secrets.DOCSEARCH_APP_ID }}
-  DOCSEARCH_API_KEY: ${{ secrets.DOCSEARCH_API_KEY }}
-  DOCSEARCH_INDEX_NAME: ${{ secrets.DOCSEARCH_INDEX_NAME }}
+  PYTHON_VERSION: "3.13.7"
 
 permissions:
   contents: write

.github/workflows/ci.yml

@@ -3,7 +3,7 @@
 #
 # Author: Akshay Mestry <xa@mes3.dev>
 # Created on: 26 August, 2025
-# Last updated on: 02 November, 2025
+# Last updated on: 14 February, 2026
 
 name: Continuous Integration
 run-name: Started ${{ github.workflow }} (CI) workflow
@@ -21,10 +21,7 @@ on:
 env:
   OUTPUT_DIR: docs/build/
   SOURCE_DIR: docs/source/
-  PYTHON_VERSION: "3.13.2"
-  DOCSEARCH_APP_ID: ${{ secrets.DOCSEARCH_APP_ID }}
-  DOCSEARCH_API_KEY: ${{ secrets.DOCSEARCH_API_KEY }}
-  DOCSEARCH_INDEX_NAME: ${{ secrets.DOCSEARCH_INDEX_NAME }}
+  PYTHON_VERSION: "3.13.7"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}

README.rst

@@ -1,13 +1,14 @@
 .. Author: Akshay Mestry <xa@mes3.dev>
 .. Created on: 21 February, 2025
-.. Last updated on: 14 January, 2026
+.. Last updated on: 15 February, 2026
 
-Akshay's Corner (Website + Sphinx Theme)
+Akshay's Corner (Website + Kaamiki Sphinx Theme)
 ===============================================================================
 
-This repository holds the code (custom
-`Sphinx <https://www.sphinx-doc.org/en/master/index.html>`_ Theme) and content
-for my personal portfolio website, `Akshay's Corner <https://xa.mes3.dev>`_,
+This repository holds the code for custom
+`Sphinx <https://www.sphinx-doc.org/en/master/index.html>`_ Theme, Kaamiki and
+the content for my personal portfolio website,
+`Akshay's Corner <https://xa.mes3.dev>`_,
 which I intend to use as my primary source of teaching and sharing thoughts and
 experiments.
 
@@ -23,9 +24,9 @@ To learn more about this, visit `here <https://xa.mes3.dev>`_.
 Contributions
 -------------------------------------------------------------------------------
 
-Contributions and/or suggestions are welcome! If you find a bug, have a
-feature request, or want to contribute improvements, please open an issue or
-submit a pull request on GitHub.
+Contributions and/or suggestions for improving Kaamiki (theme) and content are
+welcomed! If you find a bug, or want to contribute/suggest improvements,
+please open an issue or submit a pull request on GitHub.
 
 License
 -------------------------------------------------------------------------------
@@ -35,6 +36,5 @@ This project is dual-licensed under:
 - `MIT License`_ for source code and the
 - `CC BY 4.0`_ for all the educational content and blog posts.
 
-.. _MIT License: https://github.com/xames3/xa/blob/main/LICENSE-CODE
-.. _CC BY 4.0: https://github.com/xames3/xa/blob/main/LICENSE
-
+.. _MIT License: https://github.com/xames3/website/blob/main/LICENSE-CODE
+.. _CC BY 4.0: https://github.com/xames3/website/blob/main/LICENSE

docs/Makefile

@@ -69,7 +69,7 @@ help: ## Show this help and list available targets.
 		sort | \
 		awk 'BEGIN {FS = ":.*## *"} {printf "  $(COLOUR_BLUE)%-$(TARGET_PADDING)s$(COLOUR_RESET) %s\n", $$1, $$2}'
 	@echo "\n$(COLOUR_DIM)For executing a particular target, run 'make <target>'.$(COLOUR_RESET)"
-	@echo "$(COLOUR_DIM)Read complete documentation at: https://github.com/xames3/xa.$(COLOUR_RESET)"
+	@echo "$(COLOUR_DIM)Read complete documentation at: https://github.com/xames3/website.$(COLOUR_RESET)"
 
 clean: ## Remove build artifacts and temporary directories.
 	@printf "$(COLOUR_YELLOW)[CLEAN]$(COLOUR_RESET) Removing $(OUTPUT_DIR) directory... "
@@ -78,7 +78,6 @@ clean: ## Remove build artifacts and temporary directories.
 		(printf "$(COLOUR_RED)FAILED!$(COLOUR_RESET)\n" && exit 1)
 
 check: ## Perform linting checks and report issues, if any.
-	@$(MAKE) loadenv --no-print-directory
 	@printf "$(COLOUR_ORANGE)[CHECK]$(COLOUR_RESET) Running linter... "
 	@$(SPHINX_LINT) $(SPHINX_LINT_FLAGS) $(SOURCE_DIR) >/dev/null && \
 		printf "$(COLOUR_GREEN)OK!$(COLOUR_RESET)\n" || \
@@ -121,11 +120,3 @@ devserver:
 		echo "Open $(PROTOCOL)://$(LOCALHOST):$(PORT) in your browser.") && \
 		printf "$(COLOUR_GREEN)OK!$(COLOUR_RESET)\n" || \
 		(printf "$(COLOUR_RED)FAILED!$(COLOUR_RESET)\n" && exit 1)
-
-loadenv:
-	@printf "$(COLOUR_DIM)[VALUE]$(COLOUR_RESET) Loading environment variables... " && \
-		printf "$(COLOUR_GREEN)OK!$(COLOUR_RESET)\n" || \
-		(printf "$(COLOUR_RED)FAILED!$(COLOUR_RESET)\n" && exit 1)
-  -include ../env.bak
-  export
-

docs/source/assets/html/contributed.html

@@ -152,8 +152,7 @@
         border: 0;
     }
 
-    .contributed-at-scroller[data-animated="true"]
-    .contributed-at-scroller__list:hover {
+    .contributed-at-scroller[data-animated="true"] .contributed-at-scroller__list:hover {
         animation-play-state: paused;
     }
 

docs/source/conf.py

@@ -4,7 +4,7 @@
 
 Author: Akshay Mestry <xa@mes3.dev>
 Created on: 22 February, 2025
-Last updated on: 10 February, 2026
+Last updated on: 14 February, 2026
 
 This file contains the configuration settings for building my static
 website using Sphinx, a popular Python documentation tool. Sphinx is a
@@ -76,14 +76,13 @@
 
 from theme import version as theme_version
 
-
 if t.TYPE_CHECKING:
     from collections.abc import Sequence
 
 project: t.Final[str] = "Akshay's Corner"
 author: t.Final[str] = "Akshay Mestry"
 project_copyright: str = f"© 2025-{dt.now().year} {author}."
-source: t.Final[str] = "https://github.com/xames3/xa"
+source: t.Final[str] = "https://github.com/xames3/website"
 email: t.Final[str] = "xa@mes3.dev"
 version: str = theme_version
 
@@ -104,7 +103,7 @@
 exclude_patterns: Sequence[str] = ["_build"]
 smartquotes: bool = False
 
-html_theme: t.Final[str] = "theme"
+html_theme: t.Final[str] = "kaamiki"
 html_title: str = "amestry"
 html_baseurl: t.Final[str] = "https://xa.mes3.dev/"
 html_context: dict[str, t.Any] = {
@@ -143,7 +142,6 @@
     },
     "secondary_toctree_title": "On this page",
     "show_breadcrumbs": True,
-    "show_docsearch": True,
     "show_feedback": True,
     "show_last_updated_on": True,
     "show_previous_next_pages": True,
@@ -153,7 +151,7 @@
     "sidebar_buttons": {
         "Check my availability": {
             "link": "#",
-            "icon": Markup('<i class="fas far fa-video"></i>'),
+            "icon": Markup('<i class="far fa-video"></i>'),
             "extras": Markup(
                 'data-cal-link="xames3/quick-chat"'
                 'data-cal-namespace="quick-chat" '
@@ -162,7 +160,7 @@
         },
         "Sponsor on GitHub": {
             "link": "https://github.com/sponsors/xames3",
-            "icon": Markup('<i class="fas far fa-heart"></i>'),
+            "icon": Markup('<i class="far fa-heart"></i>'),
         },
     },
 }

pyproject.toml

@@ -3,7 +3,7 @@ requires = [ "setuptools", "setuptools-scm" ]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "theme"
+name = "kaamiki"
 dynamic = [ "dependencies", "version" ]
 authors = [
     { name = "Akshay Mestry", email = "xa@mes3.dev" }
@@ -21,18 +21,19 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Documentation",
     "Topic :: Software Development :: Documentation"
 ]
 
 [project.urls]
-homepage = "https://github.com/xames3/xa/"
-documentation = "https://github.com/xames3/xa/"
-repository = "https://github.com/xames3/xa"
-issues = "https://github.com/xames3/xa/issues"
+homepage = "https://github.com/xames3/website/"
+documentation = "https://github.com/xames3/website/"
+repository = "https://github.com/xames3/website"
+issues = "https://github.com/xames3/website/issues"
 
 [project.entry-points."sphinx.html_themes"]
-theme = "theme"
+kaamiki = "theme"
 
 [tool.setuptools]
 packages = ["theme"]
@@ -189,13 +190,10 @@ ban-relative-imports = "all"
 case-sensitive = true
 combine-as-imports = true
 force-single-line = true
-force-sort-within-sections = false
 known-first-party = ["theme"]
-lines-after-imports = 2
 order-by-type = true
 relative-imports-order = "closest-to-furthest"
 required-imports = ["from __future__ import annotations"]
-single-line-exclusions = ["typing", "collections.abc"]
 split-on-trailing-comma = true
 
 [tool.ruff.lint.mccabe]
@@ -259,10 +257,15 @@ warn_unreachable = true
 warn_unused_configs = true
 warn_unused_ignores = true
 disable_error_code = [
+  "arg-type",
   "assignment",
   "attr-defined",
+  "call-overload",
+  "index",
   "method-assign",
+  "misc",
   "name-defined",
+  "no-any-return",
   "operator",
   "override",
   "union-attr",

theme/__init__.py

@@ -4,7 +4,7 @@
 
 Author: Akshay Mestry <xa@mes3.dev>
 Created on: 21 February, 2025
-Last updated on: 13 February, 2026
+Last updated on: 14 February, 2026
 
 This module serves as the primary entry point for the Akshay's Corner
 Sphinx Theme. It is responsible for initialising the theme, configuring
@@ -27,7 +27,7 @@
     [1] Override styles for `sphinx_design` extension by using a
         custom CSS.
     [2] Override styles for `sphinx_docsearch` extension by using a
-        custom CSS.
+        custom CSS (deprecated, removed in February 2026).
 
 .. versionchanged:: 27.8.2025
 
@@ -51,6 +51,10 @@
         instead of `base`, like before. This allows to make the
         development simple and easy to follow by keeping the templates
         (html/jinja2 templates) separate then the styling components.
+.. versionchanged:: 14.2.2026
+
+    [1] This theme now has a name, `Kaamiki`.
+    [2] Officially dropped support for `DocSearch`.
 """
 
 from __future__ import annotations
@@ -74,7 +78,6 @@
 from theme.extensions.utils import env_before_read_docs
 from theme.extensions.utils import last_updated_date
 
-
 if t.TYPE_CHECKING:
     import types
 
@@ -83,16 +86,15 @@
 
 logger = logging.getLogger(__name__)
 
-version: str = "14.01.2026"
-theme_name: t.Final[str] = "theme"
+version: str = "14.02.2026"
+theme_name: t.Final[str] = "kaamiki"
 theme_path = p.join(p.abspath(p.dirname(__file__)), "base", "templates")
 supported_extensions: t.Sequence[str] = (
     "sphinx_carousel.carousel",
     "sphinx_design",
     "sphinxext.opengraph",
 )
 
-
 unmodified = StandaloneHTMLBuilder.copy_theme_static_files
 
 
@@ -180,7 +182,6 @@ def setup(app: Sphinx) -> dict[str, str | bool]:
         app.setup_extension(extension)
     app.add_html_theme(theme_name, theme_path)
     app.add_css_file("sphinx-design.css", priority=800)
-    app.add_css_file("doc-search.css", priority=800)
     app.add_js_file("base.js", loading_method="defer")
     app.add_js_file("theme.js", loading_method="defer")
     for role in inspect.getmembers(roles, inspect.isfunction):