Page Rework

.devcontainer/post-create.sh

@@ -6,8 +6,4 @@ if ! command -v jq >/dev/null 2>&1; then
 	sudo apt-get install -y jq
 fi
 
-if ! command -v nu >/dev/null 2>&1; then
-	npm install -g nushell
-fi
-
 npm ci

.github/ISSUE_TEMPLATE/theme-submission.yml

@@ -0,0 +1,75 @@
+name: Submit a theme
+description: Share a Firefox userChrome.css theme repository with the hub.
+title: "[Theme]: "
+labels:
+  - theme submission
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for sharing a Firefox CSS theme. This form opens a review issue; automation will turn it into a candidate pull request when possible.
+  - type: input
+    id: title
+    attributes:
+      label: Theme title
+      description: Use the public name of the theme.
+      placeholder: My Firefox Theme
+    validations:
+      required: true
+  - type: input
+    id: repository
+    attributes:
+      label: Original repository
+      description: Link to the source repository maintained by the author or project.
+      placeholder: https://github.com/owner/repository
+    validations:
+      required: true
+  - type: input
+    id: homepage
+    attributes:
+      label: Homepage
+      description: Optional project page, docs page, or website.
+      placeholder: https://example.com
+    validations:
+      required: false
+  - type: textarea
+    id: description
+    attributes:
+      label: Short description
+      description: Keep it concise. Mention the visual style, layout idea, or main browser customization.
+      placeholder: A compact dark Firefox theme with vertical tabs and rounded controls.
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshot URLs
+      description: Attach images here or paste direct image URLs. Use one screenshot per line when pasting links.
+      placeholder: Drag screenshots into this field, or paste image URLs.
+    validations:
+      required: true
+  - type: input
+    id: tags
+    attributes:
+      label: Tags
+      description: Use lowercase tags separated by commas, such as dark, compact, sidebery, oneline.
+      placeholder: dark, compact, sidebery
+    validations:
+      required: true
+  - type: dropdown
+    id: submitter_role
+    attributes:
+      label: Your relationship to the theme
+      options:
+        - Author
+        - Maintainer
+        - User or recommender
+    validations:
+      required: true
+  - type: textarea
+    id: notes
+    attributes:
+      label: Notes for reviewers
+      description: Optional compatibility notes, install caveats, or context for maintainers.
+    validations:
+      required: false

.github/dependabot.yml

@@ -10,3 +10,7 @@ updates:
    directory: "/"
    schedule:
      interval: weekly
+ - package-ecosystem: "npm"
+   directory: "/"
+   schedule:
+     interval: weekly

.github/workflows/audit-theme-repositories.yml

@@ -0,0 +1,84 @@
+name: Audit Theme Repositories
+
+on:
+  schedule:
+    - cron: '17 3 1 * *'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: audit-theme-repositories
+  cancel-in-progress: false
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm
+
+      - run: npm ci
+
+      - name: Audit published and archived theme repositories
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+          RETIREMENT_REPORT: theme-repository-audit.md
+        run: npm run audit:theme-repos
+
+      - run: npm test
+      - run: npm run build
+
+      - name: Open repository audit review PR
+        env:
+          GH_TOKEN: ${{ secrets.AUDIT_PR_TOKEN || github.token }}
+        shell: bash
+        run: |
+          if git diff --quiet -- src/content/themes; then
+            echo "No theme archive or removal changes proposed."
+            exit 0
+          fi
+
+          branch="automation/theme-repository-audit-$(date -u +%Y-%m)"
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git checkout -B "$branch"
+          git add src/content/themes
+          git commit -m "chore: propose theme repository audit changes"
+          git fetch --no-tags --depth=1 origin "$branch:refs/remotes/origin/$branch" || true
+          git push --force-with-lease origin "$branch"
+
+          manual_url="https://github.com/${GITHUB_REPOSITORY}/pull/new/${branch}"
+          title="Review archived or unavailable theme repositories"
+
+          if pr_url="$(gh pr view "$branch" --json url --jq .url 2>/dev/null)"; then
+            gh pr edit "$branch" \
+              --title "$title" \
+              --body-file theme-repository-audit.md
+            echo "Updated repository audit PR: ${pr_url}" >> "$GITHUB_STEP_SUMMARY"
+          else
+            if pr_url="$(gh pr create \
+              --base main \
+              --head "$branch" \
+              --title "$title" \
+              --body-file theme-repository-audit.md 2>pr-create-error.txt)"; then
+              echo "Created repository audit PR: ${pr_url}" >> "$GITHUB_STEP_SUMMARY"
+            else
+              echo "::warning::The audit branch was pushed, but GitHub refused to create the PR automatically."
+              cat pr-create-error.txt
+              {
+                echo "Repository audit changes were pushed to \`${branch}\`, but the workflow token could not create the PR automatically."
+                echo ""
+                echo "Open it manually: ${manual_url}"
+                echo ""
+                echo "To allow automatic PR creation, enable **Settings > Actions > General > Workflow permissions > Allow GitHub Actions to create and approve pull requests**, or add an \`AUDIT_PR_TOKEN\` secret with permission to create pull requests."
+              } >> "$GITHUB_STEP_SUMMARY"
+            fi
+          fi

.github/workflows/build.yml

@@ -1,28 +1,27 @@
-name: Build And Publish Docs
+name: Build And Deploy
 
 on:
   push:
     branches:
       - main
     paths:
-      - 'dev/**'
-      - 'images/**'
-      - 'themes.json'
-      - 'gulpfile.js'
-      - 'gulpconfig.js'
+      - 'src/**'
+      - 'public/**'
+      - 'scripts/**'
+      - 'astro.config.mjs'
+      - 'tsconfig.json'
       - 'package.json'
       - 'package-lock.json'
-      - 'dev/config/**'
+      - '.github/workflows/**'
   workflow_dispatch:
 
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
-
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
 
 concurrency:
-  group: build-and-publish-${{ github.ref }}
+  group: pages-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
@@ -42,16 +41,8 @@ jobs:
       - run: npm test
       - run: npm run build
 
-      - name: Commit generated docs
-        shell: bash
-        run: |
-          if git diff --quiet -- docs; then
-            echo "No generated docs changes to commit."
-            exit 0
-          fi
-
-          git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
-          git add docs
-          git commit -m "ci(build): compile and deploy"
-          git push
+      - uses: actions/configure-pages@v6
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: dist
+      - uses: actions/deploy-pages@v5

.github/workflows/check-themes.yml

@@ -4,19 +4,15 @@ on:
   pull_request:
     branches: [ main ]
     paths:
-      - 'dev/**'
-      - 'images/**'
-      - 'themes.json'
-      - 'gulpfile.js'
-      - 'gulpconfig.js'
+      - 'src/**'
+      - 'public/**'
+      - 'scripts/**'
+      - 'astro.config.mjs'
+      - 'tsconfig.json'
       - 'package.json'
       - 'package-lock.json'
-      - 'dev/config/**'
       - '.github/workflows/**'
 
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
-
 jobs:
   validate_pull_requests:
     runs-on: ubuntu-latest

.github/workflows/close-merged-theme-submission.yml

@@ -0,0 +1,31 @@
+name: Close Merged Theme Submission Issue
+
+on:
+  pull_request:
+    types: [closed]
+
+permissions:
+  issues: write
+  pull-requests: read
+
+jobs:
+  close_issue:
+    if: ${{ github.event.pull_request.merged == true && startsWith(github.event.pull_request.head.ref, 'submissions/theme-') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Close source issue
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR_BODY: ${{ github.event.pull_request.body }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+        shell: bash
+        run: |
+          issue_number="$(printf '%s' "$PR_BODY" | sed -nE 's/^Generated from #([0-9]+)\.$/\1/p' | head -n 1)"
+
+          if [ -z "$issue_number" ]; then
+            echo "No source issue number found in PR #${PR_NUMBER}."
+            exit 0
+          fi
+
+          gh issue close "$issue_number" \
+            --comment "Theme submission was merged in #${PR_NUMBER}. Thanks for sharing it."