Skip to content

sloria/sdict

Repository files navigation

Dear SpanishDict,

I wish this project didn't have to exist. Your dictionary is great, but your UI is a bloated mess of ads, login popups, trackers, and feature nagging. Please clean up your site. I'm trying to learn Spanish.

Saludos,

Steve

sdict

A clutter-free frontend for SpanishDict. No ads, no trackers, no JS. Just the dictionary.

sdict home page sdict results page on desktop sdict results page on mobile

Public instance

I run a public instance at https://sdict.sloria.fun.

I can't make any promises on uptime, so you should probably host your own...

Self-host with Docker

docker run --name sdict -p 3000:3000 ghcr.io/sloria/sdict:latest

Or with Docker Compose:

services:
  sdict:
    image: ghcr.io/sloria/sdict:latest
    ports:
      - "3000:3000"
docker compose up

The image is tiny (~15Mb) and runs on very little resources (< 1Mb of RAM).

Environment variables

All environment variables are optional.

  • PORT — Port to listen on (default: 3000)
  • LOG_FORMAT — Log output format: json for structured JSON logging (default: human-readable)
  • RUST_LOG — Log level filter (default: info)
  • SENTRY_DSN — Sentry/GlitchTip DSN
  • SENTRY_ENV — Sentry/GlitchTip environment

Development

# Run the dev server (http://localhost:3000)
mise run start

# Install pre-commit hooks
prek install

# Run tests
cargo test

# Lint
cargo clippy

# Format
cargo fmt

About

A clutter-free frontend for SpanishDict.com

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors