Overview
Features
- React 19 Frontend - Built with the latest React 19, Vite 7, and Tailwind v4 for blazing speed.
- Faithful Rendering - Uses sandboxed iframes to render dictionary entries exactly as intended, preserving original CSS and JavaScript.
- Dark Mode - First-class dark mode support with instant toggling.
- Wordbook System - Star and organize words for vocabulary building.
- Smart Search - Instant search with auto-suggestions and local history.
- Sidebar Navigation - Easily manage multiple dictionaries and toggle visibility.
- Word Frequency - Integrated COCA/BNC frequency data to help prioritize learning.
- Server-Side Caching - Built-in LRU memory cache with optional Valkey/Redis backend for instant repeat lookups.
- Multi-Arch Docker - Runs natively on Apple Silicon (ARM64) and standard servers (AMD64).
Architecture
- Backend: Flask (Python 3.11) handles .mdx/.mdd file parsing and serves raw HTML content. A dual-backend caching layer (in-memory LRU by default, optional Valkey/Redis) eliminates redundant binary I/O and decompression for repeat lookups.
- Frontend: A React 19 SPA consumes the JSON API for search/metadata but embeds the raw content via iframes to ensure perfect rendering isolation.
Tech Stack
- Frontend: React 19, Vite 7, Tailwind CSS v4, Zustand, React Query
- Backend: Python 3.11, Flask, mdict-utils (LZO support)
- Infrastructure: Docker (Multi-stage build), GitHub Actions, Unraid
