whatisgithub

What is shiyi-math-practice?

jackli01030/shiyi-math-practice — explained in plain English

Analysis updated 2026-05-18

31TypeScriptAudience · generalComplexity · 1/5LicenseSetup · easy

In one sentence

A browser-only math drill site for first-graders in China, built by a parent to practice the Beijing Normal University curriculum with no login or server.

Mindmap

mindmap
  root((shiyi-math-practice))
    What it does
      Daily 10-question drills
      Topic focused practice
      Mistake review mode
      Printable PDF export
    Tech stack
      Vite
      React
      TypeScript
    Use cases
      First grade math practice
      Chinese currency drills
      Word problem practice
    Audience
      Parents
      Young children
    Data
      Local storage only
      No server or login

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a first-grade child daily randomized math drills covering the school curriculum.

USE CASE 2

Let a parent review a child's missed questions and print a practice sheet as a PDF.

USE CASE 3

Focus practice on one topic area, like Chinese currency or shape recognition.

What is it built with?

TypeScriptReactVite

How does it compare?

jackli01030/shiyi-math-practiceclipboardhealth/groundcrewelbelicojackson-hue/haking-code-
Stars313131
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatehard
Complexity1/54/55/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

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.

Copy-paste prompts

Prompt 1
Help me add a new topic area of 40 questions to the shiyi-math-practice question bank following the existing TypeScript format.
Prompt 2
Fork this project and adapt the question bank for second-grade math instead of first grade.
Prompt 3
Add a simple progress chart to shiyi-math-practice that shows how many questions a child answered correctly this week.
Prompt 4
Deploy my copy of shiyi-math-practice to GitHub Pages and set up the auto-deploy workflow.

Frequently asked questions

What is shiyi-math-practice?

A browser-only math drill site for first-graders in China, built by a parent to practice the Beijing Normal University curriculum with no login or server.

What language is shiyi-math-practice written in?

Mainly TypeScript. The stack also includes TypeScript, React, Vite.

What license does shiyi-math-practice use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is shiyi-math-practice to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is shiyi-math-practice for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.