Initial release

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version =
+current_version = 0.1.0
 commit = False
 tag = False
 allow_dirty = True

.github/workflows/docker.yml

@@ -6,6 +6,8 @@ on:
       - main
     tags:
       - "v*.*.*"
+  repository_dispatch:
+    types: [new-tag-created]
   workflow_dispatch:
     inputs:
       variant:
@@ -39,7 +41,7 @@ jobs:
         uses: actions/checkout@v4
 
       # Only build on main if the merged PR has a "BUILD" label.
-      # Tag pushes and manual dispatch always build.
+      # Tag pushes, repository_dispatch, and manual dispatch always build.
       - name: Check for BUILD label on main branch
         id: check-build
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
@@ -97,7 +99,11 @@ jobs:
           github.event_name != 'push' ||
           steps.check-build.outputs.result == 'true'
         run: |
-          if [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+          if [[ "${{ github.event_name }}" == "repository_dispatch" ]]; then
+            VERSION="${{ github.event.client_payload.tag }}"
+            LATEST="latest"
+            VERSION_TAG=true
+          elif [[ "${{ github.ref }}" == refs/tags/v* ]]; then
             VERSION="${{ github.ref_name }}"
             LATEST="latest"
             VERSION_TAG=true

.github/workflows/docs.yml

@@ -0,0 +1,52 @@
+name: Documentation
+
+on:
+  push:
+    tags: ["v*.*.*"]
+  repository_dispatch:
+    types: [new-tag-created]
+  workflow_dispatch:
+
+# Builds the zensical docs and deploys them to GitHub Pages on release.
+# Requires Pages to be enabled in repo settings with Source = GitHub Actions.
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      # Sync the project (so generate-cli-docs can import cartoload) + docs group
+      - name: Install dependencies
+        run: uv sync --group docs
+
+      - name: Generate CLI docs
+        run: uv run python scripts/generate-cli-docs.py
+
+      - name: Build docs
+        run: uv run --group docs zensical build -f docs/zensical.toml
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/site
+
+      - name: Deploy to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4

.github/workflows/new-version.yml

@@ -0,0 +1,60 @@
+name: New Version
+
+# After CI passes on main, check whether the version in pyproject.toml has a
+# matching git tag. If not, a new version was merged: create + push the tag,
+# then dispatch 'new-tag-created' so the downstream publish/release/docker
+# workflows run (a tag pushed with GITHUB_TOKEN does not re-trigger them).
+on:
+  workflow_run:
+    workflows: ["CI"]
+    branches: [main]
+    types: [completed]
+
+jobs:
+  tag:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-tags: true
+
+      - name: Check if tag exists
+        id: check
+        run: |
+          VERSION=$(grep -E '^version\s*=' pyproject.toml | head -1 | cut -d'"' -f2)
+          TAG="v${VERSION}"
+          if git tag -l "$TAG" | grep -q .; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+            echo "Tag $TAG already exists, skipping."
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+            echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+            echo "New version detected: $TAG"
+          fi
+
+      - name: Create and push tag
+        if: steps.check.outputs.exists == 'false'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag "${{ steps.check.outputs.tag }}"
+          git push origin "${{ steps.check.outputs.tag }}"
+
+      - name: Trigger downstream workflows
+        if: steps.check.outputs.exists == 'false'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.repos.createDispatchEvent({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              event_type: 'new-tag-created',
+              client_payload: {
+                tag: '${{ steps.check.outputs.tag }}'
+              }
+            })

.github/workflows/publish.yml

@@ -4,6 +4,8 @@ on:
   push:
     tags:
       - "v*"
+  repository_dispatch:
+    types: [new-tag-created]
 
 jobs:
   publish:

.github/workflows/release.yml

@@ -4,6 +4,8 @@ on:
   push:
     tags:
       - "v*.*.*"
+  repository_dispatch:
+    types: [new-tag-created]
 
 jobs:
   create-release:
@@ -26,15 +28,24 @@ jobs:
       - name: Install dependencies
         run: uv sync --only-group dev
 
+      - name: Determine tag
+        id: tag
+        run: |
+          if [[ "${{ github.event_name }}" == "push" ]]; then
+            echo "name=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
+          else
+            echo "name=${{ github.event.client_payload.tag }}" >> "$GITHUB_OUTPUT"
+          fi
+
       - name: Get changelog for this version
         id: changelog
         run: |
-          VERSION="${{ github.ref_name }}"
-          echo "version=$VERSION" >> "$GITHUB_ENV"
+          TAG="${{ steps.tag.outputs.name }}"
+          echo "version=$TAG" >> "$GITHUB_ENV"
           echo "body<<EOF" >> "$GITHUB_ENV"
           # Extract changelog for this version from CHANGELOG.md
           if [ -f CHANGELOG.md ]; then
-            BODY=$(uv run git-cliff --tag "$VERSION" --strip all | tail -n +2 || true)
+            BODY=$(uv run git-cliff --tag "$TAG" --strip all | tail -n +2 || true)
           else
             BODY=""
           fi
@@ -44,7 +55,7 @@ jobs:
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          tag_name: ${{ env.version }}
+          tag_name: ${{ steps.tag.outputs.name }}
           name: ${{ env.version }}
           body: ${{ env.body }}
           draft: false

.gitignore

@@ -35,6 +35,8 @@ htmlcov/
 cache/
 output/
 docs/site/
+# Generated from src/cartoload/cli.py by scripts/generate-cli-docs.py
+docs/cli.md
 
 # IDE
 .idea/

CHANGELOG.md

@@ -0,0 +1,21 @@
+<!-- Auto generated. Run 'just release' in order to update -->
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-06-26
+
+- Initial release
+- Convert WMTS and GeoTIFF raster geodata into Garmin GPS raster maps (`*.img`)
+- Unified YAML configuration for sources, layers, and styles
+- WMTS tile downloading with on-disk caching and JPEG optimization (mozjpeg trellis quantization)
+- Custom Garmin IMG binary writer (GMP container with TRE/RGN/LBL sections and RGN2 raster records)
+- CLI (`cartoload build`, `cartoload analyze img`) and reusable Python library (`build_layer`, `SourceConfig`, `LayerConfig`)
+- `analyze img` tool for inspecting IMG files and exporting a GeoTIFF mosaic for validation
+- Docker image bundling GDAL, mozjpeg, and GMapTool (`gmt`)
+
+[0.1.0]: https://github.com/burgdev/cartoload/releases/tag/v0.1.0