mirror of
https://github.com/PR0M3TH3AN/VoxVera.git
synced 2026-10-27 09:40:40 +00:00
thePR0M3TH3ANandClaude Opus 4.8
98086a0ad4
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]>
51 lines
2.5 KiB
Markdown
51 lines
2.5 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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.
|