Skip to content

Frontend map

Fuzja edited this page Nov 12, 2026 · 1 revision

Frontend map

The frontend is a Vite app written in React and TypeScript. Most UI code is grouped by feature under src/features and shared app services and reusable components live in src/services and src/components.

Entry points and layout

  • main.tsx mounts the React app.
  • App.tsx loads configuration and sets up shared UI state and startup UI.
  • src/layout/ contains the app shell, navigation, and startup splash.
  • src/styles/ contains global styles; feature-specific styles sit alongside their screen components.

Feature screens

  • src/features/home/ - home screen and navigation shortcuts.
  • src/features/downloader/ - URL metadata, download options, and queue submission.
  • src/features/conversion/ - input file selection, output options, presets, and conversion submission.
  • src/features/compression/ - input selection, compression targets, presets, and compression submission.
  • src/features/settings/ - application preferences and requirement status.
  • src/features/queue/ - queue state, scheduling, event handling, and queue UI styles.

Each screen calls into shared services for operations used across the app. For example, conversion and compression both use the preset service, format catalog, Tauri wrapper, and queue service.

Shared services

  • services/tauri.ts wraps Tauri invoke and event listen calls.
  • services/config.ts loads and saves app configuration and applies theme and language changes.
  • services/i18n.ts loads JSON dictionaries from public/assets/langs/ and resolves translation keys.
  • services/presets.ts calls native commands to manage presets.
  • services/formats.ts loads and normalizes the native format catalog.
  • features/queue/queue.ts owns the frontend queue model, scheduling, persistence calls, and event subscription.

UI and backend boundary

Uses the shared invoke wrapper for Tauri commands and listen for Tauri events. Commands are registered in src-tauri/src/lib.rs. Keeps native filesystem, process, and media operations in Rust. The frontend gathers options, presents results, and maintains UI state.

Translations

Translation dictionaries are JSON files in public/assets/langs/, with en.json as the reference. When adding or changing visible text, update the matching keys in each language file and run npm run check:translations. The contributor guide has the full language workflow.

Clone this wiki locally