diff --git a/README.md b/README.md
index 2c8c5a4..7f81e47 100644
--- a/README.md
+++ b/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.
+
+
+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
+
+
+
+
+
+
+
+## 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.
diff --git a/docs/screenshots/coin-practice.svg b/docs/screenshots/coin-practice.svg
new file mode 100644
index 0000000..6a7ec93
--- /dev/null
+++ b/docs/screenshots/coin-practice.svg
@@ -0,0 +1,51 @@
+
diff --git a/docs/screenshots/column-practice.svg b/docs/screenshots/column-practice.svg
new file mode 100644
index 0000000..6101345
--- /dev/null
+++ b/docs/screenshots/column-practice.svg
@@ -0,0 +1,53 @@
+
diff --git a/docs/screenshots/home.svg b/docs/screenshots/home.svg
new file mode 100644
index 0000000..e699d16
--- /dev/null
+++ b/docs/screenshots/home.svg
@@ -0,0 +1,62 @@
+