Polish public repository presentation

README.md

@@ -1,6 +1,35 @@
-# Математика / Matemáticas
+# Plusik Math Trainer
 
-A static bilingual math trainer for a Ukrainian-speaking 6-year-old learning Spanish first-grade math vocabulary. The app is built with Vite, React 18, TypeScript, Tailwind CSS, and localStorage only.
+![CI](https://github.com/maximbilan/Plusik/actions/workflows/ci.yml/badge.svg)
+
+A static bilingual math trainer for Ukrainian-speaking children joining Spanish first grade.
+
+Plusik helps a child practice the exact worksheet-style math skills used in class while seeing Ukrainian and Spanish labels side by side. It is built as a touch-first static app: no backend, no accounts, no analytics, and no AI calls.
+
+## Screenshots
+
+<p>
+  <img src="docs/screenshots/home.svg" alt="Home screen with bilingual module tiles" width="32%" />
+  <img src="docs/screenshots/column-practice.svg" alt="Column addition practice with number pad" width="32%" />
+  <img src="docs/screenshots/coin-practice.svg" alt="Exact coin payment practice" width="32%" />
+</p>
+
+## Highlights
+
+- Ukrainian-first and Spanish-underneath UI, with UK-only and ES-only modes.
+- 13 practice areas: 12 worksheet skill modules plus bilingual word problems.
+- iPad and iPhone friendly: large tap targets, on-screen number pad, no keyboard required.
+- Local-only persistence with `localStorage`.
+- Static Vite SPA deployable to AWS Amplify Hosting.
+- PR CI on Linux with production build and smoke test.
+
+## Tech Stack
+
+- Vite + React 18 + TypeScript
+- Tailwind CSS
+- lucide-react
+- Web Audio API for tiny generated feedback sounds
+- localStorage for progress
 
 ## Develop
 
@@ -44,9 +73,8 @@ Pull requests to `main` run GitHub Actions on Linux (`ubuntu-latest`):
 
 ## What Is Included
 
-- Ukrainian, Ukrainian+Spanish, and Spanish-only language modes.
-- iPad-first touch UI with on-screen number pads and large tap targets.
-- 13 practice areas: the 12 worksheet skill modules plus bilingual word problems.
+- Number recognition, hundred chart, place value, addition/subtraction with and without carrying/borrowing.
+- Decomposition, euro coin counting, exact payment by tapping coins, balance comparisons, fruit equations, and word problems.
 - Local-only persistence under the `math-trainer/v1` localStorage key.
 - No backend, accounts, analytics, database, Firebase, or Amplify backend resources.