Skip to content

๐Ÿ•ต๏ธ A detective-themed math learning game that teaches children quick calculation verification techniques. Features 6 mathematical reasoning skills, achievement system, and PWA support. Built with Phaser 3 + TypeScript.

Notifications You must be signed in to change notification settings

Carton/tica-math

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Tica Detective Agency: Digital Mystery Cases

GitHub release License: MIT GitHub stars

๐Ÿ“– ไธญๆ–‡็‰ˆ README | ๐ŸŽฎ Play Online | โญ Give us a star!


๐Ÿ•ต๏ธ A detective-themed math learning game that teaches children quick calculation verification techniques through engaging detective work!

Perfect for children aged 8-10, this game transforms mathematical learning into an exciting detective adventure where kids verify calculations using various mathematical reasoning skills.

๐ŸŽฎ Screenshots

Main Menu & User Selection

Main Menu Choose your detective profile and jump into the world of mathematical mysteries!

Detective Gameplay

Game Scene Solve math cases using detective tools and verification techniques!

Core Educational Objective: This game is primarily designed to teach children how to quickly verify calculations using different methods, which is the core purpose of the game. Through various mathematical verification techniques (such as digit verification, parity checking, rule of 9s, etc.), it cultivates children's mathematical thinking and calculation confidence.

๐ŸŽญ Trivia: Tica, the protagonist detective, is named after the developer's daughter!


๐ŸŒŸ Key Features

๐Ÿง  6 Mathematical Reasoning Skills

  • Last Digit Tracking - Verify calculations by checking the final digit
  • Estimation Power - Quick approximation techniques for fast validation
  • Odd/Even Code - Parity checking methods for calculation verification
  • Casting Out Nines - Classic digital root technique for error detection
  • Carry/Borrow Detection - Identify common arithmetic mistakes
  • Special Digit Fingerprint - Advanced divisibility rules (3s, 9s, etc.)

๐ŸŽฎ Engaging Gameplay

  • ๐Ÿ”ง Three detective tools: Magnifying Glass, Pocket Watch, and Lightning Bolt
  • ๐ŸŽฏ Adaptive difficulty system with 100+ levels
  • โฑ๏ธ Time-based challenges with combo rewards
  • ๐Ÿ† Comprehensive achievement system with badge collection

๐Ÿ“ฑ Modern Features

  • ๐Ÿ“ฑ PWA support - Play offline on any device
  • ๐Ÿ‘ฅ Multi-user profile system
  • ๐ŸŒ Full internationalization (English/Chinese)
  • ๐ŸŽต Dynamic audio system with sound effects and background music

๐Ÿ› ๏ธ Technology Stack

๐ŸŽฎ Frontend & Game Engine

  • Phaser 3.90.0 - Modern HTML5 game framework
  • TypeScript 5.0+ - Type-safe JavaScript development
  • Vite 4.x - Fast build tool and dev server

๐ŸŒ Internationalization

  • i18n System - Full English/Chinese language support
  • Dynamic Language Switching - Runtime language changes

๐Ÿš€ Quick Start

๐ŸŽฎ Play Online

Visit https://carton.github.io/tica-math/ to play the game directly in your browser!

๐Ÿ’ป Local Development

Install Dependencies

npm install

Start Development Server

npm run dev

Run Tests

npm test

Build Production Version

npm run build

Deploy to GitHub Pages

Automatic Deployment (Recommended)

  1. Push code to the main or master branch of the GitHub repository
  2. Go to repository Settings โ†’ Pages
  3. Set Source to "GitHub Actions"
  4. Automatic deployment will occur with each push

Manual Deployment

If manual deployment is needed:

# Build
npm run build

# Push to gh-pages branch (need to create first)
git checkout -b gh-pages
git add dist -f
git commit -m "Deploy to GitHub Pages"
git push origin gh-pages

# Return to main branch
git checkout main

License

MIT License

About

๐Ÿ•ต๏ธ A detective-themed math learning game that teaches children quick calculation verification techniques. Features 6 mathematical reasoning skills, achievement system, and PWA support. Built with Phaser 3 + TypeScript.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published