# halkyon_learn_server

This is the starting point for your Serverpod server.

Start your server by running:

    cd halkyon_learn
    serverpod start

When you are finished, you can shut down the running server with `Q`.

## Dictionaries

The dictionaries people look words up in (JMdict, …) are reference data the
server holds for everyone. They come as dictionary files, which
`halkyon_learn_curator` makes from the sources' downloads (its README says how).
At every start, the server loads the files in its `dictionaries` folder that
changed since they were last loaded (by their SHA-256): in the background, a
source at a time, and all at once, so searches meanwhile still find the old
entries. A file it can't read is logged and left out.

- **Development:** put the file into `halkyon_learn_server/dictionaries/` and
  restart `serverpod start`.
- **An instance:** put it into `deploy/dictionaries/` beside `compose.yaml`
  (mounted read-only as `/app/dictionaries`) and restart the server container.
  `DICTIONARIES_DIR` names another folder.

JMdict in English, with the JLPT levels, is about 17 MB gzipped and takes the
server half a minute to load (219,000 entries). Its licence (CC BY-SA 4.0) asks
for attribution: the app lists the credits each file carries.

## Licence

Copyright (C) 2026 The Halkyon Learn contributors

Licensed under the Server Side Public License, version 1 (`SSPL-1.0`); the full text
is in `LICENSE`.