From bd868d461325e162e6e468a99a17df7dfbe49ab7 Mon Sep 17 00:00:00 2001
From: onyx-and-iris <code@onyxandiris.online>
Date: Tue, 10 Mar 2026 01:15:13 +0000
Subject: [PATCH] add .gitkeep files to show the expected dir structure for
 spec and theme files.

---
 .gitignore              | 114 +++++++++++++++++++++++++++++++++++-----
 spec/azure/.gitkeep     |   0
 spec/forest/.gitkeep    |   0
 spec/sunvalley/.gitkeep |   0
 theme/azure/.gitkeep    |   0
 theme/forest/.gitkeep   |   0
 6 files changed, 102 insertions(+), 12 deletions(-)
 create mode 100644 spec/azure/.gitkeep
 create mode 100644 spec/forest/.gitkeep
 create mode 100644 spec/sunvalley/.gitkeep
 create mode 100644 theme/azure/.gitkeep
 create mode 100644 theme/forest/.gitkeep

diff --git a/.gitignore b/.gitignore
index 57b6ca6..801c156 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,9 +1,9 @@
-# quick test
-quick.py
+# Generated by ignr: github.com/onyx-and-iris/ignr
 
+## Python ##
 # Byte-compiled / optimized / DLL files
 __pycache__/
-*.py[cod]
+*.py[codz]
 *$py.class
 
 # C extensions
@@ -23,7 +23,6 @@ parts/
 sdist/
 var/
 wheels/
-pip-wheel-metadata/
 share/python-wheels/
 *.egg-info/
 .installed.cfg
@@ -50,9 +49,10 @@ htmlcov/
 nosetests.xml
 coverage.xml
 *.cover
-*.py,cover
+*.py.cover
 .hypothesis/
 .pytest_cache/
+cover/
 
 # Translations
 *.mo
@@ -75,6 +75,7 @@ instance/
 docs/_build/
 
 # PyBuilder
+.pybuilder/
 target/
 
 # Jupyter Notebook
@@ -85,7 +86,9 @@ profile_default/
 ipython_config.py
 
 # pyenv
-.python-version
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
 
 # pipenv
 #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
@@ -94,7 +97,37 @@ ipython_config.py
 #   install all needed dependencies.
 #Pipfile.lock
 
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/
 
 # Celery stuff
@@ -106,13 +139,13 @@ celerybeat.pid
 
 # Environments
 .env
+.envrc
 .venv
 env/
 venv/
 ENV/
 env.bak/
 venv.bak/
-venv_vmcompact/
 
 # Spyder project settings
 .spyderproject
@@ -132,8 +165,65 @@ dmypy.json
 # Pyre type checker
 .pyre/
 
-# build
-theme/
-spec/
+# pytype static type analyzer
+.pytype/
 
-.vscode/
\ No newline at end of file
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+.vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# End of ignr
+
+# Test files
+test-*.py
+
+# Forest/Azure theme files
+theme/**/*
+!theme/*/
+!theme/**/.gitkeep
+
+# Spec files
+spec/**/*
+!spec/*/
+!spec/**/.gitkeep
+
+# Taskfile build files
+Taskfile.unified.yml
+SPEC_CONSOLIDATION.md
diff --git a/spec/azure/.gitkeep b/spec/azure/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/spec/forest/.gitkeep b/spec/forest/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/spec/sunvalley/.gitkeep b/spec/sunvalley/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/theme/azure/.gitkeep b/theme/azure/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/theme/forest/.gitkeep b/theme/forest/.gitkeep
new file mode 100644
index 0000000..e69de29