Initial scaffold: ArchyHCL, a community hardware compatibility list for Archipelago

Modeled on three researched precedents (see README): OpenWrt's Table of Hardware for the browsable sortable/filterable table UX, postmarketOS's working/community/testing tiers for the status field (collapsed to working/partial/broken here), and RaspiBlitz's scattered GitHub-issues approach as a negative example to avoid — hence structured YAML report files validated against a JSON Schema instead of free-text issue threads. - data/reports/*.yml + data/schema.json: one file per report, schema requires `issues` whenever status is partial/broken - scripts/build.py: validates every report and builds site/data.json, fails loudly on bad data (same idea as archy's own validate-app-manifest.sh) - site/: plain HTML/CSS/JS, no framework or build step, fetches data.json client-side — search, filter by status/form-factor, sortable columns, click a row for issues/notes detail - .github/ISSUE_TEMPLATE/hardware-report.yml: structured submission path for contributors who don't want to touch git directly - .gitea/workflows/ci.yml: runs the build/validate step on push and PRs Not yet deployed anywhere — see README's Deployment section. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-01 11:32:58 +00:00
commit a22a9c9826
14 changed files with 855 additions and 0 deletions
@@ -0,0 +1,116 @@
+name: Hardware report
+description: Report a device you've installed Archipelago on, working or not.
+title: "hw: <device model>"
+labels: ["hardware-report"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! A maintainer turns this into a data file under
+        `data/reports/` and it shows up on the site. If you're comfortable
+        with git, opening a PR directly is faster — see CONTRIBUTING.md.
+  - type: input
+    id: device_model
+    attributes:
+      label: Device model
+      placeholder: "Lenovo ThinkPad T430"
+    validations:
+      required: true
+  - type: dropdown
+    id: form_factor
+    attributes:
+      label: Form factor
+      options:
+        - laptop
+        - desktop
+        - mini-pc
+        - sbc
+        - server
+        - other
+    validations:
+      required: true
+  - type: input
+    id: cpu
+    attributes:
+      label: CPU
+      placeholder: "Intel Core i5-3320M"
+    validations:
+      required: true
+  - type: input
+    id: ram_gb
+    attributes:
+      label: RAM (GB)
+      placeholder: "8"
+    validations:
+      required: true
+  - type: input
+    id: storage
+    attributes:
+      label: Storage (type and size)
+      placeholder: "256GB SSD"
+    validations:
+      required: true
+  - type: input
+    id: wifi_chip
+    attributes:
+      label: WiFi chip
+      description: Exact chipset if you know it. Put "none" if wired-only.
+      placeholder: "Intel Centrino Advanced-N 6205"
+    validations:
+      required: true
+  - type: input
+    id: ethernet
+    attributes:
+      label: Ethernet chip (optional)
+      placeholder: "Intel 82579LM"
+  - type: input
+    id: archy_version
+    attributes:
+      label: Archipelago version tested
+      placeholder: "1.8.4-alpha"
+    validations:
+      required: true
+  - type: dropdown
+    id: install_method
+    attributes:
+      label: Install method
+      options:
+        - usb-iso
+        - netboot
+        - existing-os-script
+        - other
+    validations:
+      required: true
+  - type: dropdown
+    id: status
+    attributes:
+      label: Status
+      description: "working = no known issues. partial = runs with specific known issues (describe below). broken = does not install or run."
+      options:
+        - working
+        - partial
+        - broken
+    validations:
+      required: true
+  - type: input
+    id: tested_date
+    attributes:
+      label: Date tested
+      placeholder: "2026-08-21"
+    validations:
+      required: true
+  - type: textarea
+    id: issues
+    attributes:
+      label: Issues (required if status is partial or broken)
+      description: What broke, and any workaround you found.
+  - type: textarea
+    id: notes
+    attributes:
+      label: Other notes
+      description: BIOS/UEFI settings needed, quirks, links to a fuller writeup.
+  - type: input
+    id: submitted_by
+    attributes:
+      label: Attribution (optional)
+      description: Your npub, Gitea username, or leave blank to stay anonymous.