simplegals 0.1.0__tar.gz

simplegals-0.1.0/.claude/settings.local.json

@@ -0,0 +1,43 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git -C /Users/tbielawa/Projects/simpleGals log --oneline -10)",
+      "Bash(pip install *)",
+      "Bash(python -c \"import simplegals; print\\(simplegals.__version__\\)\")",
+      "Read(//usr/local/bin/**)",
+      "Read(//opt/homebrew/bin/**)",
+      "Bash(pyenv versions *)",
+      "Bash(python3.12 -m pip install -e \".[dev]\" -q)",
+      "Bash(python3.12 -c \"import simplegals; print\\(simplegals.__version__\\)\")",
+      "Bash(python3.12 -m venv /Users/tbielawa/Projects/simpleGals/.venv)",
+      "Bash(/Users/tbielawa/Projects/simpleGals/.venv/bin/pip install *)",
+      "Bash(.venv/bin/pytest *)",
+      "Bash(rm -rf /tmp/sg-smoke)",
+      "Bash(mkdir /tmp/sg-smoke)",
+      "Bash(cp /Users/tbielawa/Projects/simpleGals/tests/assets/TEST.jpg /tmp/sg-smoke/)",
+      "Read(//tmp/**)",
+      "Bash(/Users/tbielawa/Projects/simpleGals/.venv/bin/python -m simplegals.cli init)",
+      "mcp__plugin_context7_context7__resolve-library-id",
+      "mcp__plugin_context7_context7__query-docs",
+      "Bash(.venv/bin/python3 *)",
+      "Bash(git -C /Users/tbielawa/Projects/simpleGals log --oneline -3)",
+      "Bash(git -C /Users/tbielawa/Projects/simpleGals status --short)",
+      "Bash(.venv/bin/python *)",
+      "Bash(.venv/bin/pip install *)",
+      "Bash(.venv/bin/sgui *)",
+      "mcp__plugin_oh-my-claudecode_t__lsp_diagnostics",
+      "Read(//Users/tbielawa/Projects/nugals/nugalsenv/lib/**)",
+      "Bash(python3 -c \"import term_image; print\\(term_image.__version__\\)\")",
+      "Bash(pip show *)",
+      "Bash(python3 -c \"from term_image.image import AutoImage; help\\(AutoImage.__init__\\)\")",
+      "Bash(python3 -c ' *)",
+      "WebFetch(domain:bitmath.readthedocs.io)",
+      "Bash(python3 -c \"import bitmath; help\\(bitmath.getsize\\)\")",
+      "Bash(python3 -c \"import bitmath; help\\(bitmath.get_size\\)\")",
+      "Bash(python3 *)",
+      "Bash(python -m pytest tests/ -x -q)",
+      "Bash(/Users/tbielawa/Projects/simpleGals/.venv/bin/pytest tests/ -x -q)",
+      "Bash(/Users/tbielawa/Projects/simpleGals/.venv/bin/pytest tests/test_gallery.py::test_build_force_rebuilds_all -v -s)"
+    ]
+  }
+}

simplegals-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on: [push, pull_request]
+
+# NOTE: bitmath is installed from PyPI (bitmath>=2.0.0) in CI.
+# During local prototyping it installs from a local path — see pyproject.toml.
+# Do not push to GitHub until bitmath 2.0.0 is published to PyPI and
+# pyproject.toml has been updated to the official release.
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package and dev dependencies
+        run: pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest tests/ --cov=simplegals --cov-report=term-missing
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install package and docs dependencies
+        run: pip install -e ".[docs]"
+      - name: Build docs
+        run: cd docs && make html

simplegals-0.1.0/.gitignore

@@ -0,0 +1,148 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+eggs/
+parts/
+var/
+sdist/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+MANIFEST
+.installed.cfg
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+.env
+
+# Distribution / packaging
+.Python
+pip-log.txt
+pip-delete-this-directory.txt
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+pytestdebug.log
+
+# Type checkers
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+.pyre/
+
+# Linters / formatters
+.ruff_cache/
+
+# Jupyter
+.ipynb_checkpoints
+*.ipynb
+
+# pyenv
+.python-version
+
+# uv
+.uv/
+uv.lock
+
+# PDM
+.pdm.toml
+.pdm-python
+__pypackages__/
+
+# Hatch
+.hatch/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath
+*.sage.py
+
+# Spyder
+.spyderproject.db
+.spyproject
+
+# Rope
+.ropeproject
+
+# mkdocs
+/site
+
+# Editor trash
+*~
+*.swp
+*.swo
+*.swn
+*.bak
+*.orig
+.DS_Store
+Thumbs.db
+
+# VS Code
+.vscode/
+*.code-workspace
+
+# JetBrains (PyCharm, IDEA, etc.)
+.idea/
+*.iml
+*.iws
+*.ipr
+
+# Vim
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+Session.vim
+.netrwhist
+tags
+[._]*.un~
+
+# Emacs
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Logs
+*.log
+logs/
+
+# Secrets / local config
+.env.local
+.env.*.local
+*.pem
+*.key
+secrets.toml
+
+# Project-specific
+in/
+out/
+.meta/
+
+# oh-my-claudecode internal state
+.omc/

simplegals-0.1.0/.readthedocs.yaml

@@ -0,0 +1,16 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

simplegals-0.1.0/.remember/.gitignore

@@ -0,0 +1 @@
+*

simplegals-0.1.0/.remember/archive.md

@@ -0,0 +1,3 @@
+# Archive
+
+```

simplegals-0.1.0/.remember/now.md

@@ -0,0 +1,13 @@
+
+## 04:01 | main
+Fixed TUI bugs in app.py/preview_panel.py + added dirty indicator, Tab cycling, centered preview, bitmath sizes, ctrl+c quit w/ save prompt, ctrl+w write.
+## 04:11 | main
+Fixed simpleGals rebuild bug: metadata.py check_staleness now verifies thumb/output files exist on disk, not just sidecar mtime/sha; updated test_metadata.py (140/140 tests passing).
+## 04:14 | main
+Fixed prev link (page 2→index.html) in page.html.j2, linked item imgs to fullsize, added 💾 dl link to meta in item.html.j2; 142/142 tests.
+## 04:21 | main
+Added --force flag to build cmd for forced out/ rebuild, restored CLI progress bars w/ _on_progress callback in gallery.py/cli.py, updated test_gallery.py; tests passing.
+## 04:28 | main
+Fixed --force test, 144/144 passing; discovered: deleted in/ imgs don't clean orphan out/ files (DSC_8297.jpg leaves _item.html).
+## 04:40 | main
+Impl `prune_removed_sources()` fn to clean orphans (.meta, thumbs, out/ imgs, item pages) on src deletion; 145/145 pass; 626c080.

simplegals-0.1.0/.remember/recent.md

@@ -0,0 +1,8 @@
+# Recent
+
+```
+
+# Recent
+
+## 2026-04-26
+Completed Plan 1 scaffold (53 core+CLI tests) with 6 TUI features, fixed staging↔widget dataflow, updated deps (bitmath 2.0.0, term-image). Pushed repo live; fixed 4 additional TUI bugs (quit key, preview API, mode-focus) reaching 103/103 tests. Plan 2 (sgui TUI) subagent-driven execution launched.

simplegals-0.1.0/.remember/tmp/last-ndc.ts

@@ -0,0 +1 @@
+1777168220

simplegals-0.1.0/.remember/tmp/last-save-ts

@@ -0,0 +1 @@
+1777171228

simplegals-0.1.0/.remember/tmp/last-save.json

@@ -0,0 +1 @@
+{"session": "381f1956-c5fc-401e-be9e-e6c9fd3341f1", "line": 923}

simplegals-0.1.0/.remember/tmp/save-session.pid

@@ -0,0 +1 @@
+90541

simplegals-0.1.0/.remember/today-2026-04-25.md

@@ -0,0 +1,4 @@
+## 22:10 | main
+Created Python .gitignore (editor trash); amended commit email timbielawa@gmail.com→tim@lnx.cx; updated CLAUDE.md
+## 22:29-23:45 | main
+simplegals: architected sgui (shared core lib, CLI/TUI, Jinja2, XDG config, .meta/sidecars/*.json metadata, parallel workers+progress viz, urwid TUI (term-image compat), Pillow); finalized design (Approach A (layered), JSON conf (simpleGal.json CWD, -c override), RFC 3339 sidecars (.meta/<filename>.json), quality+copyright outputs, ProcessPoolExecutor workers, urwid 2-panel TUI, staged batch changes (Ctrl+|), nav spec); finalized 2026-04-25-architecture-design.md (self-review 3 fixes, reviewed user updates (JSON/deps/pagination), added single-page-html view).

simplegals-0.1.0/.remember/today-2026-04-26.done.md

@@ -0,0 +1,11 @@
+## 01:27-01:58 | main
+Finished 6 TUI features (0bd5e37); replaced _fmt_size→bitmath.Byte().best_prefix() (fee7c2b); getsize() (6690f0b) stat().st_size; preview centered; ^S flow-ctrl blocked IXON; file panel text clipping + marquee scroll on focus; preview_delay 75→125ms; 139/139 tests; pending ^C quit-prompt, ^W write-out; gh repo push incomplete
+
+## 02:30 | main
+Plan 1 (core+CLI, 53 tests) + Plan 2 sgui (7 tasks, subagent-driven); 103/103 passing; staging ↔ widget dataflow fixed; .omc/→.gitignore
+
+## 03:50 | main
+Pushed repo live; pyproject.toml: bitmath→2.0.0, term-image std pypi; rm allow-direct-refs flag
+
+## 14:45 | main
+Fixed 4 TUI bugs (quit key, preview API, mode-focus) app.py/preview_panel.py; 103/103 tests; started dirty indicator, tab cycling, preview scaling

simplegals-0.1.0/CLAUDE.md

@@ -0,0 +1,32 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`simpleGals` is a command-line static HTML image gallery generator. It takes directories of images and produces simple HTML files with thumbnails. There are two entry points:
+
+- `simpleGals` — batch-mode CLI
+- `sgui` — interactive TUI setup utility
+
+Both commands operate in the current working directory, auto-creating `in/` (input images), `out/` (generated HTML), and `.meta/` (image metadata/cache).
+
+## Tech Stack
+
+- Python >= 3.12
+- [`term-image`](https://github.com/AnonymouX47/term-image) for terminal image rendering (requires Kitty graphics protocol, iTerm2 inline image protocol, or Unicode truecolor support)
+
+## Planned Architecture
+
+- **`sgui`**: TUI with a split layout — scrollable file tree (left, ~20% width) and settings/preview panel (right). Navigation via arrow keys and Tab to switch focus. Escape toggles between image selection mode and general gallery settings.
+- **Template system**: A default HTML template ships with the tool; users can fork it and point to a custom template via `--template/-t <TEMPLATE_DIR>` or the `sgui` settings panel.
+- **Thumbnail caching**: `.meta/` stores image metadata and cached thumbnails. On repeat runs, thumbnails are regenerated only when the input file's last-modified time has changed.
+- **Preview behavior**: A configurable delay (`preview_delay`, default 75ms) prevents rapid thumbnail generation while paging through files. First-load generates and caches; subsequent views are instant if unchanged.
+
+## Key Configuration Settings (in `sgui`)
+
+| Setting | Type | Default | Description |
+|---|---|---|---|
+| `file_panel_width` | `int` or `int%` | `30` | Width of the file tree panel |
+| `scroll_rate` | `float` | `2.0` | Marquee scroll rate (chars/sec) for truncated filenames |
+| `preview_delay` | `int` (ms) | `75` | Delay before generating a thumbnail for the first time |

simplegals-0.1.0/Makefile

@@ -0,0 +1,20 @@
+.PHONY: build publish publish-test clean-dist test
+
+VENV := .venv
+PYTHON := $(VENV)/bin/python
+TWINE := $(VENV)/bin/twine
+
+build: clean-dist
+	$(PYTHON) -m build
+
+publish-test: build
+	$(TWINE) upload --verbose --repository TEST dist/*
+
+publish: build
+	$(TWINE) upload --verbose --repository simplegalsprod dist/*
+
+test:
+	$(VENV)/bin/pytest tests/
+
+clean-dist:
+	rm -rf dist/

simplegals-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: simplegals
+Version: 0.1.0
+Summary: A simple command-line static HTML image gallery generator with a TUI setup utility
+Project-URL: Repository, https://github.com/timlnx/simpleGals
+Author-email: Tim Case <tim@lnx.cx>
+License: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Presentation
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: bitmath>=2.0.0
+Requires-Dist: jinja2
+Requires-Dist: piexif
+Requires-Dist: pillow
+Requires-Dist: term-image
+Requires-Dist: urwid
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser; extra == 'docs'
+Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinx-autobuild; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# README.md
+
+`simpleGals` is trying to be a very simple command-line driven static HTML image
+gallery generating tool. simpleGals just like to have fun, it doesn't want you
+getting bogged down with all the tedious overhead associated with fancy gals,
+running software that has to get patched, or paying another subscription.
+simpleGals ain't like that.
+
+simpleGals isn't for album management. You feed simpleGals directories of images
+and in return you get some simple HTML files with thumbnails.
+
+
+# Tech Stack
+
+- [Python](https://www.python.org/) >= 3.12
+- [term-image](git+https://github.com/AnonymouX47/term-image.git)
+- A terminal emulator with **any** of the following:
+
+  - support for the [Kitty graphics protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol/)
+  - support for the [iTerm2 inline image protocol](https://iterm2.com/documentation-images.html)
+  - Unicode and direct-color (truecolor) support
+- My [bitmath](git+https://github.com/timlnx/bitmath.git) library for file size printing and math
+
+(I told you, it's simple)
+
+
+# Experience
+
+The fanciest part of simpleGals is the tui setup utility. Launching `sgui` opens
+the application in the current working directory, `sgui` (and the batch-mode
+`simpleGals` interface) will create a directory called `out` and expects to find
+a directory called `in`, these directories will be created if they do not
+already exist. Image metadata and caching files are saved in a `.meta`
+directory.
+
+A basic template ships with simpleGals. Your can fork this template and instruct
+simpleGals to use your template instead with the `--template,-t <TEMPLATE_DIR>`
+option flag, or in the setup panel of `sgui`.
+
+
+# `sgui`
+
+The sgui launches with a scrollable file tree ('file panel') of discovered
+images in the `in` directory listed on the left, just the file names, about 20%
+of the screen up to a max width of ~=30 characters
+
+* setting: `file_panel_width`
+* desc: width in characters or percent of horizontal area
+* types:
+    - `int` for absolute character value (e.g., `30` = 30 characters)
+    - `int%` for max width percent (e.g., `30%` = 30% of horizontal space)
+* default: `30`
+
+Move the selection cursor with with the up/down arrow keys, pausing or stopping
+on a file name will marquee scroll the file name if it was truncated. The ctrl+n
+and ctrl+p shortcuts also work for next and previous if you are in the file panel.
+
+* setting: `scroll_rate`
+* desc: scroll rate in chars/second
+* type: `float`
+* default: `2.0`
+
+On the right using the remainder of the visible space is the general gallery
+settings input panel. This panel is also where previewing and editing properties
+of individual images takes place.
+
+Pressing escape at any time shifts focus to the general gallery settings where
+parameters like max columns/rows/per page/description information can be
+provided. Press escape again to go back to the selection mode.
+
+When moving the selection cursor between images in the file panel there is a
+brief delay before the thumbnail is loaded the first time so you can page
+through several in a row without attempting to generate thumbnails of each image
+rapidly. Once a thumbnail is generated the delay is `0` if the last-modified
+metadata has not changed for the input/thumbnail files
+
+* setting: `preview_delay`
+* description: delay before generating image metadata thumbnail the first time
+* type: `int`
+* default: `75ms`
+
+Image thumbnails are displayed in the console using the `term-image` library. A
+preview will take up no more than 55% of the available horizontal/vertical space
+on the panel on the right.
+
+Pressing tab switches cursor focus between the file panel and the main usage window.
+
+# Settings
+
+Settings are saved in JSON format.
+
+Gallery metadata in the `.meta` directory includes a `cache/` directory with thumbnail images for the sgui browser. The file names are simply mapped back to the source images based on sha checksum (TODO: OR SOME OTHER FAST AND RELIABLE SIGNATURE METHOD). A simple YAML file records source image names (relative to the `in/` directory) and original image checksums, modification times, and preview generation times.
+
+
+
+
+
+# Reference Material
+
+* base library: https://github.com/AnonymouX47/term-image
+* example usage: https://github.com/AnonymouX47/termvisage 

simplegals-0.1.0/README.md

@@ -0,0 +1,101 @@
+# README.md
+
+`simpleGals` is trying to be a very simple command-line driven static HTML image
+gallery generating tool. simpleGals just like to have fun, it doesn't want you
+getting bogged down with all the tedious overhead associated with fancy gals,
+running software that has to get patched, or paying another subscription.
+simpleGals ain't like that.
+
+simpleGals isn't for album management. You feed simpleGals directories of images
+and in return you get some simple HTML files with thumbnails.
+
+
+# Tech Stack
+
+- [Python](https://www.python.org/) >= 3.12
+- [term-image](git+https://github.com/AnonymouX47/term-image.git)
+- A terminal emulator with **any** of the following:
+
+  - support for the [Kitty graphics protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol/)
+  - support for the [iTerm2 inline image protocol](https://iterm2.com/documentation-images.html)
+  - Unicode and direct-color (truecolor) support
+- My [bitmath](git+https://github.com/timlnx/bitmath.git) library for file size printing and math
+
+(I told you, it's simple)
+
+
+# Experience
+
+The fanciest part of simpleGals is the tui setup utility. Launching `sgui` opens
+the application in the current working directory, `sgui` (and the batch-mode
+`simpleGals` interface) will create a directory called `out` and expects to find
+a directory called `in`, these directories will be created if they do not
+already exist. Image metadata and caching files are saved in a `.meta`
+directory.
+
+A basic template ships with simpleGals. Your can fork this template and instruct
+simpleGals to use your template instead with the `--template,-t <TEMPLATE_DIR>`
+option flag, or in the setup panel of `sgui`.
+
+
+# `sgui`
+
+The sgui launches with a scrollable file tree ('file panel') of discovered
+images in the `in` directory listed on the left, just the file names, about 20%
+of the screen up to a max width of ~=30 characters
+
+* setting: `file_panel_width`
+* desc: width in characters or percent of horizontal area
+* types:
+    - `int` for absolute character value (e.g., `30` = 30 characters)
+    - `int%` for max width percent (e.g., `30%` = 30% of horizontal space)
+* default: `30`
+
+Move the selection cursor with with the up/down arrow keys, pausing or stopping
+on a file name will marquee scroll the file name if it was truncated. The ctrl+n
+and ctrl+p shortcuts also work for next and previous if you are in the file panel.
+
+* setting: `scroll_rate`
+* desc: scroll rate in chars/second
+* type: `float`
+* default: `2.0`
+
+On the right using the remainder of the visible space is the general gallery
+settings input panel. This panel is also where previewing and editing properties
+of individual images takes place.
+
+Pressing escape at any time shifts focus to the general gallery settings where
+parameters like max columns/rows/per page/description information can be
+provided. Press escape again to go back to the selection mode.
+
+When moving the selection cursor between images in the file panel there is a
+brief delay before the thumbnail is loaded the first time so you can page
+through several in a row without attempting to generate thumbnails of each image
+rapidly. Once a thumbnail is generated the delay is `0` if the last-modified
+metadata has not changed for the input/thumbnail files
+
+* setting: `preview_delay`
+* description: delay before generating image metadata thumbnail the first time
+* type: `int`
+* default: `75ms`
+
+Image thumbnails are displayed in the console using the `term-image` library. A
+preview will take up no more than 55% of the available horizontal/vertical space
+on the panel on the right.
+
+Pressing tab switches cursor focus between the file panel and the main usage window.
+
+# Settings
+
+Settings are saved in JSON format.
+
+Gallery metadata in the `.meta` directory includes a `cache/` directory with thumbnail images for the sgui browser. The file names are simply mapped back to the source images based on sha checksum (TODO: OR SOME OTHER FAST AND RELIABLE SIGNATURE METHOD). A simple YAML file records source image names (relative to the `in/` directory) and original image checksums, modification times, and preview generation times.
+
+
+
+
+
+# Reference Material
+
+* base library: https://github.com/AnonymouX47/term-image
+* example usage: https://github.com/AnonymouX47/termvisage 

simplegals-0.1.0/docs/Makefile

@@ -0,0 +1,16 @@
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+.PHONY: help Makefile live
+
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+# live-reload local dev server: http://127.0.0.1:8000
+live:
+	sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS)
+
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

simplegals-0.1.0/docs/conf.py

@@ -0,0 +1,20 @@
+project = "simpleGals"
+copyright = "2026, timlnx"
+author = "timlnx"
+release = "0.1.0"
+
+extensions = [
+    "myst_parser",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.viewcode",
+]
+
+html_theme = "sphinx_rtd_theme"
+
+source_suffix = {
+    ".rst": "restructuredtext",
+    ".md": "markdown",
+}
+
+# exclude design specs and internal planning docs from the built docs
+exclude_patterns = ["_build", "superpowers/**"]

simplegals-0.1.0/docs/index.md

@@ -0,0 +1,16 @@
+# simpleGals
+
+simpleGals is a command-line static HTML image gallery generator. Feed it a directory of
+images; get back simple HTML files with thumbnails. No subscriptions, no album management,
+no fuss.
+
+```{toctree}
+:maxdepth: 2
+:caption: Contents
+
+installation
+usage
+sgui
+templates
+configuration
+```