Repository navigation
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.
-
main.tsxmounts the React app. -
App.tsxloads 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.
-
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.
-
services/tauri.tswraps Tauriinvokeand eventlistencalls. -
services/config.tsloads and saves app configuration and applies theme and language changes. -
services/i18n.tsloads JSON dictionaries frompublic/assets/langs/and resolves translation keys. -
services/presets.tscalls native commands to manage presets. -
services/formats.tsloads and normalizes the native format catalog. -
features/queue/queue.tsowns the frontend queue model, scheduling, persistence calls, and event subscription.
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.
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.