0 Fork 0

mirror of https://github.com/PR0M3TH3AN/VoxVera.git synced 2026-10-27 09:40:40 +00:00

Files

T

thePR0M3TH3ANandClaude Opus 4.8 98086a0ad4 Add bulletin board page listing recent flyers from the relays

A small screen-only link below the flyer preview (outside the printable
sheet, hidden in print) opens board.html: a spreadsheet-style list of the
most recent VoxVera flyers found on the default relays.

- Columns: title, link (the poster URL shown as "link"), posting npub,
  language, and posted date; every column is sortable (default date
  descending). Replaceable events are de-duplicated per author+d identifier,
  keeping the latest.
- board.js is independent of nostr-client.js (which exports nothing): its UI
  strings live in BOARD_UI for all 14 languages, and it reuses the vendored
  nostr-tools and locales.js (language names + RTL direction).
- The board has its own language selector that reads/writes the same
  voxvera_nostr_lang localStorage key as the main client, so the choice
  carries across pages; switching it re-localizes the chrome, headers,
  language labels, and date formatting and flips RTL.
- Untrusted relay content is escaped, and link URLs are rejected unless
  http(s) so javascript:/data: never render as a link.

Docs updated (README, spec, AGENTS). Playwright: add tests for the
out-of-sheet print-hidden link, the localized sortable columns, and the
board language selector (incl. RTL + persistence). 72 tests pass across
Chromium, Firefox, WebKit, and Android/iOS mobile emulations.

Co-Authored-By: Claude Opus 4.8 <[email protected]>

2026-06-09 16:28:32 -04:00

2.5 KiB

Raw Blame History

AI Agent Instructions For VoxVera

main is the Nostr static-client branch. The old Tor/OnionShare CLI application is preserved on legacy-tor.

Current Architecture

Active frontend: site/ (index.html, nostr-client.js, nostr-client.css, locales.js)
Bulletin board: site/board.html + site/board.js (standalone page listing recent flyers from the relays; escapes untrusted relay content and rejects non-http(s) link URLs)
Static deployment root: site
Browser dependencies: vendored under site/vendor/
Legacy path: site/nostr/index.html is a redirect stub forwarding old /nostr/ poster URLs and QR codes to the root
Python helper package: voxvera/nostr/
Design plan: docs/nostr-static-client-spec.md

Guardrails

Do not reintroduce the legacy Tor CLI, OnionShare runtime, installer, Electron manager, bundled Tor binaries, generated old flyer site, or packaging workflows on main.
Keep the Nostr client static and host-agnostic.
Do not load frontend dependencies from CDNs.
Treat Nostr event content as untrusted. Escape rendered content and reject unsafe schema input.
Preserve print behavior: app controls must not print or shift the flyer sheet in print output.
Preserve the old flyer visual language unless the user explicitly asks for a redesign.
Paper size (US Letter / A4) is a local print/view preference (localStorage), defaulted from the browser locale region. Never write it into the Nostr event — a flyer must reprint on either size without changing the source event.

Localization

Use site/locales.js for flyer content defaults.
Use NOSTR_UI in site/nostr-client.js for editor/viewer controls and Nostr-specific labels.
Add translations for every supported language when adding user-facing strings.
Check right-to-left languages when touching layout.

Verification

Run:

node --check site/nostr-client.js
pytest -q

For visual or print changes, also run a local static server and inspect the site root (/) in a browser.

Cross-browser end-to-end tests live in e2e/ (Playwright; Chromium, Firefox, WebKit, plus mobile emulations). Run them after changes that touch rendering, print, key generation, URL/redirect handling, or the loading state:

npm install && npx playwright install
npm run test:e2e

WebKit/Safari on Linux needs sudo npx playwright install-deps once. See e2e/README.md. Test tooling is a dev dependency only — it must not pull runtime frontend dependencies from CDNs or otherwise weaken the static, host-agnostic client.