shiyi-math-practice

shiyi-math-practice is a math drill website for first-grade students in China, built around the 2024 edition of the Beijing Normal University elementary school math curriculum. The project was made by a parent for their child, described in the README as a warm and reusable local practice environment rather than a full educational platform.

The site runs entirely in the browser without any backend server, database, or login system. All practice history and incorrect answers are stored in the browser's local storage on the device being used, so nothing is sent to any server. The question bank lives in a local TypeScript file and currently contains 442 questions across ten topic areas: addition and subtraction within 20, understanding numbers up to 100, size comparisons, Chinese currency, pattern recognition, observing objects, shapes, and word problems.

For daily use, the site picks 10 questions from the question bank covering the main curriculum topics. There is also a focused practice mode where a child can drill a specific topic, and a mistake review mode where questions answered incorrectly are saved and shown again until they are answered correctly. From the mistake list, a parent can export a printable practice sheet as a PDF. The interface uses large fonts and large buttons, shows one question at a time, and provides gentle feedback: a celebration animation for correct answers and a soft "let's think again" prompt for wrong ones. Chinese characters in questions and options are displayed with phonetic pinyin and tone marks to help early readers.

The project is built with Vite, React, and TypeScript, and deploys automatically to GitHub Pages when changes are pushed to the main branch. MIT licensed.