Słowo dnia
Słowo dnia ("Word of the day") is a free web app (PWA) for learning Polish one word or phrase at a time: a kids' course (500 words, learned together with a parent) and an adult course (1000 words about life in Poland). The interface is in Russian; progress is stored only in the browser.
Open the app: https://trajgiel.github.io/Slowo-dnia/
The code here is the React + TypeScript version of the app. Until it is released, the site serves the previous version (a single page without a build step); it stays in the git history.
Requirements
- Node 24 (see
.nvmrc) and npm
Run locally
npm install
npm run dev
Vite prints the local address; the app is served under the base path /Slowo-dnia/ (for example http://localhost:5173/Slowo-dnia/).
Scripts
| Command | What it does |
|---|
npm run dev | development server |
npm run build | type check and production build into dist/ (base /Slowo-dnia/) |
npm run preview | serve the production build locally |
npm run check | everything CI runs: Prettier, ESLint, TypeScript, Vitest, build |
npm run prettier / npm run prettier:fix | check / fix formatting |
npm run lint / npm run lint:fix | ESLint |
npm run typecheck | TypeScript |
npm test / npm run test:watch | Vitest |
Project layout
src/ — the app, split into layers; a layer imports only the layers below it (ESLint enforces this):
app/ — entry, router, layoutfeatures/ — screensshared/ui/ — shared components; state/ — store and actionsstorage/, data/, platform/, i18n/ — localStorage, course data, browser APIs, dictionariesdomain/ — pure functions and types (no React, DOM or storage)
src/i18n/locales/ — interface strings; text in JSX outside the dictionaries fails npm run lintscripts/extract-courses.ts — one-off transfer of the course data from the prototype (node scripts/extract-courses.ts <prototype-dir>): writes src/data/kidsCourse.ts, src/data/adult.json and the test fixture src/test/fixtures/prototype-courses.jsonpublic/ — files published as is: icons/, fonts/ (with their licenses), LICENSE.github/workflows/ — CI (ci.yml) and the pull request direction check (pr.yml)
Branches
Task branches go into develop via pull request; develop goes into main on release. GitHub Pages publishes main.
Copyright
© 2026 Wlodzimierz Trajgiel. All rights reserved.
Copying, modifying or distributing the app or its parts (code, texts, word lists, design, icons) without the author's written permission is prohibited. See LICENSE. The fonts in public/fonts/ do not belong to the author and are distributed under the SIL Open Font License 1.1.
