Project website and account frontend for VNOX (TypeScript, Bun, no runtime dependencies)
Find a file
loki5512344 d3a6dd316b
feat(web): rewrite site copy in plain language and split i18n dictionaries
Move RU/EN strings to src/i18n/{ru,en}.ts, add og/meta tags that follow the
selected language, remove the long dash from all text, add copy guidelines and
tests for key parity, HTML fallback text and dash-free sources and bundle.
2026-10-24 16:55:05 +02:00
docs feat(web): rewrite site copy in plain language and split i18n dictionaries 2026-10-24 16:55:05 +02:00
public feat(web): rewrite site copy in plain language and split i18n dictionaries 2026-10-24 16:55:05 +02:00
scripts refactor(web): migrate to Bun and TypeScript with README screenshots 2026-10-24 15:34:41 +02:00
src feat(web): rewrite site copy in plain language and split i18n dictionaries 2026-10-24 16:55:05 +02:00
tests feat(web): rewrite site copy in plain language and split i18n dictionaries 2026-10-24 16:55:05 +02:00
.bun-version refactor(web): migrate to Bun and TypeScript with README screenshots 2026-10-24 15:34:41 +02:00
.gitignore feat(web): add bilingual website and central account frontend 2026-10-24 15:08:49 +02:00
bun.lock refactor(web): migrate to Bun and TypeScript with README screenshots 2026-10-24 15:34:41 +02:00
LICENSE feat(web): add bilingual website and central account frontend 2026-10-24 15:08:49 +02:00
package.json refactor(web): migrate to Bun and TypeScript with README screenshots 2026-10-24 15:34:41 +02:00
README.md feat(web): rewrite site copy in plain language and split i18n dictionaries 2026-10-24 16:55:05 +02:00
tsconfig.json refactor(web): migrate to Bun and TypeScript with README screenshots 2026-10-24 15:34:41 +02:00

VNOX Web

Public project website and account frontend for VNOX Central.

License: GPL-3.0 Bun TypeScript


What is this?

A lightweight, self-hosted website for VNOX, a Rust voice and text communication platform. This is a separate repository from VNOX Client and VNOX Server.

The application is written in TypeScript, HTML and CSS. Bun installs dependencies, runs development previews and tests, formats source and bundles production assets. Strict types cover Hub responses, sessions, profiles, language keys and UI state; untrusted JSON is also validated at runtime.

Browsers execute JavaScript, so Bun compiles the TypeScript source into one static browser bundle. A frontend framework is unnecessary for the landing page and account flow. There are no browser runtime dependencies, third-party scripts, analytics or external fonts. Production serves static files through Nginx; neither Bun nor Node.js runs on the website server.

Screenshots

Actual screenshots of central.loki-code.dev, captured on 24 October 2026 in a fresh, anonymous browser context. No private account data or credentials appear in these images.

Project page

VNOX project page with a graphite palette, approved V mark and interactive client illustration

Central account

Anonymous VNOX Central account page offering GitHub sign-in

Mobile screenshot

Features

  • Responsive Russian/English project pages with the approved VNOX mark.
  • Interactive, clearly labelled layout illustration and a real native-client screenshot.
  • Account loading, signed-out, signed-in, unavailable and sign-out states.
  • GitHub sign-in through VNOX Hub, same-origin cookies and CSRF-protected sign-out.
  • Explicit early-development status; no invented releases, people or download links.

The website does not implement identity verification itself. The Rust Hub exchanges GitHub credentials and manages sessions. Central accounts are not yet linked to the desktop client's local cryptographic identity.

Development

Requires Bun 1.4.4 or newer. The verified version is pinned in packageManager and .bun-version; development package versions and integrity hashes are committed in bun.lock.

bun install --frozen-lockfile
bun run dev           # Local preview at http://127.0.0.1:4176
bun run check         # Strict TypeScript checking, without emitting files
bun test              # API, locale and Bun preview regression tests
bun run build         # Check types and create the static dist/ release
bun run preview       # Preview the built dist/ directory
bun run format:check  # Check formatting with Bun's built-in formatter
bun run format        # Format TypeScript, CSS, HTML and configuration

No Node.js installation is required. TypeScript and Bun type definitions are development-only dependencies; the browser bundle contains only this application's code. See the dependency audit for checked versions and licenses.

Set PORT=4180 to change the preview port. Reload the browser after editing source: the development preview compiles the current TypeScript when /src/app.js is requested. The preview intentionally returns HTTP 503 for API requests; it contains no fake backend or development credentials.

Optional browser QA: python3 tests/browser_qa.py uses an existing local Playwright installation and Chromium against the running preview. It does not add a JavaScript project dependency.

Structure

public/       HTML entry point and self-hosted assets
src/          Typed application, API helpers, CSS; src/i18n/ holds the ru.ts and en.ts string dictionaries
scripts/      Bun browser bundling, static build and loopback preview
tests/        Bun regression tests and optional browser QA
docs/         Design, deployment notes and repository-hosted screenshots

Hub integration

Serve dist/ at the same HTTPS origin as VNOX Hub. / and /account use index.html; preserve proxy routes /v1/, /health, /ready and /version. See the Nginx example.

Endpoint Frontend behaviour
GET /v1/info Enable sign-in only when capabilities.github_auth is enabled
GET /v1/auth/github/start Browser navigation to GitHub authorization
GET /v1/auth/session Load authenticated, public user and ephemeral csrf_token
POST /v1/auth/logout Send X-CSRF-Token; clear the account after success

The Hub sets Secure, HttpOnly cookies. Tokens are never stored in browser storage; only the preferred UI language is persisted. Keep OAuth callback query strings out of reverse-proxy access and error logs. Never place secrets or .env files in the static release.

Contributing

Keep RU/EN catalog keys aligned (src/i18n/ru.ts and en.ts; a test enforces it), follow the copy guidelines, never use the long dash character, render profile values as text and retain keyboard navigation and reduced-motion support. Use descriptive Conventional Commits such as fix(web): preserve account state when changing language. Run type checks, tests, formatting checks and a production build before submitting a focused PR; include screenshots for visual changes. See verification notes for browser QA and current limits.

License

GNU GPL version 3. See LICENSE.