Dictionary

Web dictionary for Spanish and English, installable as a PWA — and it works with no connection at all.

https://fs-frost.github.io/dictionary

Offline first

The 30,000 most frequent words of each language ship with the app: definitions, IPA transcriptions, etymologies, usage examples and synonyms. Looking a word up normally never touches the network.

Press Download for offline use and the whole language is stored in your browser (19 MB for Spanish, 36 MB for English). After that the dictionary works on a plane, on the underground, or with the Wi-Fi off — including words you have never searched before.

When a word is not in the bundled dataset, the app falls back to online sources. None of them requires an API key.

Language	Order of lookup
Spanish	bundled dataset → rae-api.com → freedictionaryapi.com
English	bundled dataset → dictionaryapi.dev → freedictionaryapi.com

Spanish queries the RAE first because it defines words in Spanish; the Wiktionary-backed APIs serve English glosses and would answer agua with "water".

Built with

• Svelte 5 and SvelteKit 2 with adapter-static
• TypeScript and Zod
• Vite and Bun
• Vitest and Playwright
• Dictionary data from Wiktionary via kaikki.org (wiktextract)

Run locally

bun install
bun run dev

Go to http://localhost:5000.

Commands

bun run check        # type and template checking
bun run test         # unit tests + dataset integrity
bun run test:e2e     # end-to-end, including a real offline run
bun run build        # static build into build/
bun run preview      # serve the build on http://localhost:5000

The end-to-end tests need a Chromium (bunx playwright install chromium). If you already have one, CHROMIUM_PATH=/path/to/chrome bun run test:e2e skips the download.

Regenerating the dataset

static/data/ is generated and committed. To rebuild it, download a wiktextract dump and a frequency list from hermitdave/FrequencyWords:

bun run dataset:es --input es.jsonl.gz --freq es_50k.txt
bun run dataset:en --input en.jsonl.gz --freq en_50k.txt

Use the eswiktionary/Español export for Spanish — the dictionary/Spanish one contains Spanish words glossed in English.

Deploy

Pushing to master triggers the GitHub Actions workflow, which type-checks, runs both test suites, builds the site, rewrites the base tag to /dictionary/ and publishes build/ to the gh-pages branch.

Licence and attribution

Dictionary content comes from Wiktionary and is licensed under CC BY-SA 4.0. Spanish definitions fetched online come from the Diccionario de la lengua española through the unofficial rae-api.com. Icons are from Bootstrap Icons (MIT).