Skip to content

Overhaul MeshCore Canada: task-first journeys, structured communities, and safer delivery#66

Draft
n30nex wants to merge 11 commits into
mainfrom
agent/ui-ux-overhaul
Draft

Overhaul MeshCore Canada: task-first journeys, structured communities, and safer delivery#66
n30nex wants to merge 11 commits into
mainfrom
agent/ui-ux-overhaul

Conversation

@n30nex

@n30nex n30nex commented Jul 19, 2026

Copy link
Copy Markdown
Member

Status

Draft — please do not merge yet.

PR #66 is the working overhaul branch. The exact branch head is live for review in English and French on Canadaverse. meshcore.ca remains unchanged.

The overhaul still needs maintainer review of RF and hardware facts, community freshness, region authority and naming, French wording, privacy language, and hands-on assistive-technology behaviour before it is ready to merge.

What this overhaul improves

  • organizes the site around six clear paths: Start, Communities, Devices & Builds, Network Tools, Learn, and Contribute
  • gives companion, repeater, room-server, and observer users a direct setup path with a practical working check
  • turns community information into structured data, a searchable directory, and province or territory pages that still work without JavaScript
  • gives region lookup, the map and editor, observer tools, submissions, privacy, hardware, and contribution pages one responsive design
  • searches the Canadian region list first, then automatically uses geocoding when needed
  • loads OpenStreetMap tiles automatically, without a consent checkbox, while keeping loading, retry, failure, and privacy information
  • aligns desktop search, highlights the Observer setup card, and keeps decorative effects out of assistive technology
  • makes community build guides easy to find from the hardware landing page, including the experimental 1 W solar repeater guide
  • adds deterministic builds, route-scoped assets, accessibility checks, browser tests, Lighthouse budgets, and a rollback-safe preview deployment
  • removes generated site/ output from source control

French version

This branch now includes a complete first French draft rather than a partial landing page:

  • 57 English Markdown pages and 57 French counterparts
  • a route-preserving English / Français switcher in the top header
  • French navigation, site search, community directory, regional labels, forms, analyzer, map controls, and configuration editor
  • French routes under /fr/, with matching English and French canonical/alternate links
  • localized visitor-facing labels while preserving radio values, region codes, data keys, URLs, and other machine-facing values
  • a short feedback invitation on French pages so francophone visitors can report wording that feels unclear or unnatural

This is ready for community language review, but it is not being presented as native editorial approval.

Language and content cleanup

  • removes stiff Outcome:, Expected result:, and similar template labels from visitor guides
  • replaces internal process language with direct wording such as “Make sure it works,” “What’s next,” and “What to share when asking for help”
  • removes stale old-site and migration commentary from visitor pages
  • removes duplicate role, firmware, hardware, and directory pages in favour of one current route for each task
  • keeps the important erase, recovery, private-key, credential, TLS, antenna, battery, electrical, and structural warnings
  • the main copy-pruning pass removed 4,338 words across 52 Markdown pages

PR #75 is included

PR #75 is closed because its work now lives in this overhaul branch:

  • Alberta MeshCore Networks, Airdrie, Calgary, Edmonton, and yegmesh.ca entries
  • refreshed YQLMesh web, regional, Discord, map, and social links
  • StoonMesh updated to the requested 3-byte path hash mode
  • all 26 submitted URLs retained
  • 21 total listings: 20 described by their sources as active and 1 as forming

The directory clearly says that all 21 listings still need a recent contact check instead of inventing verification dates.

Live Canadaverse test

  • English preview: canadaverse.org/meshcore-canada
  • French preview: /fr/
  • hardware landing: /hardware/
  • French hardware landing: /fr/hardware/
  • experimental guide: 1 W solar repeater DIY build
  • French region editor: /fr/config/editor/
  • manifest: site-manifest.json
  • exact branch head: 117c3f40bc6e744c5a64ef96b3a2fd3457faaed9
  • exact artifact SHA-256: ea4e28512cceab7e53f971cb8763f7dcb4e4d690f0c8f491dbec9ddbc16bd9e9
  • Pi container image: sha256:22869d17f5159a91cd1a0b8a4de7c843a90eefd5dd9decabbff9e57a67d505a0
  • 128 rendered pages: 70 English/static routes and 58 French routes
  • all 128 preview pages contain noindex, nofollow; the preview sitemap has zero indexed URLs
  • the Pi container is healthy, has zero restarts, has no runtime mounts, and serves the same manifest from source, the container, and public HTTPS
  • rollback image splashpage:rollback-pr66-pre-117c3f4-ebb335ceaa55 and source backup /opt/canadaverse/.deploy/meshcore-canada-pre-117c3f4-20260723T123425Z are retained
  • the Canadaverse root page and Caddy configuration stayed byte-identical during the cutover
  • Pi storage has 52 GB free and reports throttled=0x0

Validation

Exact-head GitHub Actions run: Validate site qualitygreen

  • validate, browser, and Lighthouse jobs all passed on 117c3f4
  • 65/65 Node content tests passed
  • 65/65 editor and submission tests passed
  • 8/8 Python content-schema tests passed
  • JavaScript syntax checks passed for 40 files
  • strict preview build and link audit passed for 128 pages and 12,877 local references
  • public desktop Chromium: 55 passed, 3 intentional mobile-only skips
  • public mobile Chromium: 56 passed, 2 intentional desktop-only skips
  • public checks covered the exact manifest, all critical English and French routes, same-page language switching, French search, French editor assets and controls, automatic map tiles, aligned desktop search, mobile overflow, keyboard controls, and axe accessibility scans
  • HTTPS responses include CSP, HSTS, nosniff, frame denial, referrer policy, and permissions policy
  • 21 community listings and all submitted links validate; the expected missing-verification-date warnings remain visible

Review still needed before ready

  • validate hardware and RF recommendations with maintainers
  • confirm community contacts and settings, then add honest verification dates
  • have francophone community members review the first French draft for natural wording
  • review region labels, authority, and cross-province policy
  • review privacy and retention language plus production submission behaviour
  • perform a human screen-reader and keyboard review on representative devices
  • configure an edge-level HTTP-to-HTTPS redirect for first-time Canadaverse visitors; HTTPS is configured correctly, but the preview host currently still serves cleartext HTTP

Closes #67
Closes #68
Closes #69
Closes #70
Closes #72
Closes #73
Closes #74

Supersedes #75.

@n30nex
n30nex requested a review from MrAlders0n July 19, 2026 23:16
@n30nex
n30nex force-pushed the agent/ui-ux-overhaul branch 2 times, most recently from cbdb6a3 to ee0c27c Compare July 19, 2026 23:51
@n30nex
n30nex force-pushed the agent/ui-ux-overhaul branch from ee0c27c to 0688fb1 Compare July 19, 2026 23:57
@wykweb

wykweb commented Jul 20, 2026

Copy link
Copy Markdown

excellent news

@n30nex n30nex changed the title Overhaul MeshCore Canada site journeys and quality gates Overhaul MeshCore Canada: task-first journeys, structured communities, and safer delivery Jul 22, 2026

n30nex commented Jul 22, 2026

Copy link
Copy Markdown
Member Author

Public preview deployment verified

The Canadaverse test route is now serving this PR's exact head:

  • preview: https://canadaverse.org/meshcore-canada/
  • revision: 953e4cd82be426ec7cf2b2e9a040dd4c501b19f8
  • artifact SHA-256: 49dfb3f609a8e41895b66c97be6b4a23e36041f72a15d5dc35b7a3d57fa768e4
  • Pi container image: sha256:f14b20c7de9d93c39c9912ea9d955d7f37967685ee42af97445edf952928753a
  • exact-head Actions run: https://github.com/MeshCore-ca/MeshCore-Canada/actions/runs/29914246869 — green
  • public HTTPS browser test: 70 passed, 4 expected project-specific skips, 0 failed
  • public Lighthouse budgets: passed
  • desktop/mobile visual review: passed; no Canadaverse-origin console errors or CSP violations
  • unrelated Canadaverse root: unchanged on the Pi

PR #66 remains draft and should not be merged until the review gates in the updated description are complete.

@n30nex

n30nex commented Jul 22, 2026

Copy link
Copy Markdown
Member Author

Browser feedback and automatic map loading are live

The Canadaverse preview now serves the exact updated PR head:

  • revision: fadb94afae7fe37b8120540ed225bde34c06d71c
  • artifact SHA-256: 63e617c2fd63b6e3f50ab53ef37a59712e3c80eba63e3ad86a5083dce2852c32
  • Pi image: sha256:23dffbbdfdaed9bd70dd5a810a8e802e55e858fd54e181b6b4d31ac691e91e78
  • exact-head Actions run: https://github.com/MeshCore-ca/MeshCore-Canada/actions/runs/29917468239 — green
  • public HTTPS critical journeys: 50 passed, 4 expected project-specific skips, 0 failed

This update applies the nine homepage comments, fixes the header-search geometry, highlights the Observer path accessibly, removes place-search consent controls, and automatically loads OpenStreetMap tiles on the region map. Public browser verification observed nine loaded tiles and no remaining search/tile consent gate. The unrelated Canadaverse root is unchanged, and the prior validated image remains pinned for rollback.

PR #66 remains draft and should not be merged until its remaining human-review gates are complete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants