VoxVera/AGENTS.md

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/nostr/
• Static deployment root: site
• Browser dependencies: vendored under site/nostr/vendor/
• 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.

Localization

• Use site/nostr/locales.js for flyer content defaults.
• Use NOSTR_UI in site/nostr/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/nostr-client.js
pytest -q

For visual or print changes, also run a local static server and inspect /nostr/ in a browser.