Initial commit

Open source release

Author: Tombarr

.devcontainer/devcontainer.json

@@ -0,0 +1,39 @@
+{
+  "name": "KaiOS.dev Hugo Development",
+  "image": "mcr.microsoft.com/devcontainers/base:trixie",
+
+  // Add Hugo feature with extended support
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/hugo:latest": {
+      "extended": true
+    }
+  },
+
+  // Configure tool-specific properties
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "git.alwaysSignOff": true
+      },
+      "extensions": [
+        "budparr.language-hugo-vscode",
+        "eliostruyf.vscode-hugo-themer",
+        "tamasfe.even-better-toml"
+      ]
+    }
+  },
+
+  "forwardPorts": [1313],
+
+  // Port attributes
+  "portsAttributes": {
+    "1313": {
+      "label": "Hugo Server",
+      "onAutoForward": "notify"
+    }
+  },
+
+  // After the container is created
+  "postCreateCommand": "git submodule update --init --recursive && bash .devcontainer/install-typos.sh"
+}

.devcontainer/install-typos.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Install typos-cli for spell checking
+
+set -e
+
+echo "Installing typos-cli..."
+
+# Check if cargo is installed
+if ! command -v cargo >/dev/null 2>&1; then
+    echo "Cargo not found. Installing Rust..."
+    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+    source "$HOME/.cargo/env"
+fi
+
+# Install typos-cli
+if ! command -v typos >/dev/null 2>&1; then
+    cargo install typos-cli
+    echo "✓ typos-cli installed successfully"
+else
+    echo "✓ typos-cli is already installed"
+fi
+
+# Verify installation
+typos --version

.github/workflows/deploy.yml

@@ -0,0 +1,46 @@
+name: Deploy to Cloudflare Pages
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      deployments: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive   # Fetch Hugo themes (if any)
+          fetch-depth: 0          # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Check for typos
+        uses: crate-ci/typos@master
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: 'latest'
+          extended: true
+
+      - name: Build Hugo site
+        env:
+          HUGO_ENV_GIT_COMMIT_HASH: ${{ github.sha }}
+        run: hugo --minify --gc --cleanDestinationDir --environment production
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+          command: |
+            pages deploy public --project-name=${{ secrets.CLOUDFLARE_PROJECT_NAME }} --branch=${{ github.head_ref || github.ref_name }} --commit-dirty=true

.gitignore

@@ -27,6 +27,20 @@ go.work.sum
 # env file
 .env
 
-# Editor/IDE
-# .idea/
-# .vscode/
+# Editor/IDE/macOS
+.idea/
+.DS_Store
+
+# Hugo
+.hugo_build.lock
+_gen/
+.scss_*
+public/
+
+# Claude/ OpenCode
+CLAUDE.md
+.opencode/
+.claude/
+
+# NPM
+node_modules/

.vscode/tasks.json

@@ -0,0 +1,87 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Start Hugo Server",
+      "type": "shell",
+      "command": "export HUGO_ENV_GIT_COMMIT_HASH=$(git rev-parse --verify HEAD) && hugo server --bind 0.0.0.0 --disableFastRender --noHTTPCache",
+      "isBackground": true,
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "runOptions": {
+        "runOn": "folderOpen"
+      },
+      "problemMatcher": {
+        "pattern": [
+          {
+            "regexp": ".",
+            "file": 1,
+            "location": 2,
+            "message": 3
+          }
+        ],
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "Web Server is available at",
+          "endsPattern": "Press Ctrl+C to stop"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      }
+    },
+    {
+      "label": "Typos: Check",
+      "type": "shell",
+      "command": "typos",
+      "problemMatcher": {
+        "owner": "typos",
+        "fileLocation": ["relative", "${workspaceFolder}"],
+        "pattern": [
+          {
+            "regexp": "^(.*):(\\d+):(\\d+):\\s+(.*)$",
+            "file": 1,
+            "line": 2,
+            "column": 3,
+            "message": 4
+          }
+        ]
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      }
+    },
+    {
+      "label": "Typos: Watch",
+      "type": "shell",
+      "command": "typos --watch",
+      "isBackground": true,
+      "problemMatcher": {
+        "owner": "typos",
+        "fileLocation": ["relative", "${workspaceFolder}"],
+        "pattern": [
+          {
+            "regexp": "^(.*):(\\d+):(\\d+):\\s+(.*)$",
+            "file": 1,
+            "line": 2,
+            "column": 3,
+            "message": 4
+          }
+        ],
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Watching",
+          "endsPattern": "^$"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      }
+    }
+  ]
+}