{"id":51288403,"url":"https://github.com/junhey/kid-smart-learning","last_synced_at":"2026-06-30T08:02:36.556Z","repository":{"id":343401721,"uuid":"1177548330","full_name":"junhey/kid-smart-learning","owner":"junhey","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-30T03:16:14.000Z","size":542,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-30T03:24:30.820Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://kid-smart-learning.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/junhey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-10T06:05:56.000Z","updated_at":"2026-04-30T03:16:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/junhey/kid-smart-learning","commit_stats":null,"previous_names":["junhey/kid-smart-learning"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/junhey/kid-smart-learning","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junhey%2Fkid-smart-learning","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junhey%2Fkid-smart-learning/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junhey%2Fkid-smart-learning/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junhey%2Fkid-smart-learning/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/junhey","download_url":"https://codeload.github.com/junhey/kid-smart-learning/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junhey%2Fkid-smart-learning/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34957627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-30T08:02:35.678Z","updated_at":"2026-06-30T08:02:36.546Z","avatar_url":"https://github.com/junhey.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kid Smart Learning 🎓\n\nAn interactive, gamified learning website for children ages 5-7, featuring fun English and Math games with a star-based reward system.\n\n**Live Demo:** [kid-smart-learning.vercel.app](https://kid-smart-learning-em5eci9lj-junheys-projects.vercel.app) *(deploy to get your URL)*\n\n---\n\n# 儿童智慧学习 🎓\n\n一款专为 5-7 岁儿童设计的互动游戏化学习网站，包含英语和数学趣味游戏，以及星星奖励系统。\n\n---\n\n## Features / 功能特色\n\n- 🔤 **5 English Games** — Alphabet Balloons, Word Match, Phonics Fun, Listen \u0026 Choose, Sentence Builder\n- 🔢 **5 Math Games** — Count It, Adding Fun, Shape Match, Big or Small, Math Shooter\n- ⭐ **Reward System** — Stars, Levels (1-10), Achievements stored in localStorage\n- 🎵 **Audio Support** — Web Speech API for pronunciation\n- 📱 **Responsive** — Optimized for iPad/tablet/desktop\n- 🎨 **Animations** — Framer Motion throughout\n\n---\n\n## Tech Stack\n\n| Technology | Version |\n|---|---|\n| Next.js | 14 (App Router) |\n| React | 18 |\n| TypeScript | 5 |\n| TailwindCSS | 3 |\n| Framer Motion | 11 |\n\n---\n\n## Quickstart / 快速开始\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/kid-smart-learning.git\ncd kid-smart-learning\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n\n# Open http://localhost:3000\n```\n\n### Build for production / 生产构建\n\n```bash\nnpm run build\nnpm start\n```\n\n---\n\n## Games Overview / 游戏介绍\n\n### 📚 English Games\n\n| Game | Description |\n|---|---|\n| 🎈 **Alphabet Balloons** | Pop the balloon with the correct letter as balloons float up |\n| 🐶 **Word Match** | See an emoji picture, pick the matching word from 4 choices |\n| 🔤 **Phonics Fun** | See a letter, find which picture starts with that sound |\n| 👂 **Listen \u0026 Choose** | Hear a word spoken aloud, pick the matching emoji picture |\n| ✍️ **Sentence Builder** | Click word tiles to arrange them into a correct sentence |\n\n### 🔢 Math Games\n\n| Game | Description |\n|---|---|\n| 🔢 **Count It!** | Count the emoji objects and select the correct number (1-15) |\n| ➕ **Adding Fun** | Visual addition and subtraction with emoji groups |\n| 🔷 **Shape Match** | Match shape names to CSS/SVG drawn shapes |\n| ⚖️ **Big or Small?** | Compare two numbers and choose \u003e or \u003c |\n| 🎯 **Math Shooter** | Shoot the floating bubble with the correct answer |\n\n---\n\n## Reward System / 奖励系统\n\n```\nStars ⭐  →  earned per correct answer\nLevel 🏆  →  1-10 based on stars (every 10 stars = 1 level)\n```\n\n### Achievements / 成就\n\n| Achievement | Unlock Condition |\n|---|---|\n| 🌟 First Star | Get your first correct answer |\n| 💯 Perfect Round | Complete a game with all correct |\n| 🔥 Streak 10 | Answer 10 in a row correctly |\n\n---\n\n## Project Structure / 项目结构\n\n```\nkid-smart-learning/\n├── app/\n│   ├── layout.tsx          # Root layout, fonts\n│   ├── page.tsx            # Home page\n│   ├── globals.css         # Global styles \u0026 animations\n│   ├── english/page.tsx    # English hub (5 games)\n│   └── math/page.tsx       # Math hub (5 games)\n├── components/\n│   ├── ui/\n│   │   ├── StarReward.tsx  # Animated star burst\n│   │   ├── ProgressBar.tsx # Colorful progress bar\n│   │   └── SoundButton.tsx # Button with audio click\n│   ├── games/\n│   │   ├── english/        # 5 English game components\n│   │   └── math/           # 5 Math game components\n│   └── layout/\n│       ├── Header.tsx      # Stars + level display\n│       ├── Navigation.tsx  # Back/Home nav\n│       └── RewardPanel.tsx # Full reward panel\n├── data/\n│   ├── english/\n│   │   ├── alphabet.json   # 26 letters with words\n│   │   ├── words.json      # 100+ words (5 categories)\n│   │   └── sentences.json  # 30 sentence templates\n│   └── math/\n│       ├── numbers.json    # 1-20 in English \u0026 Chinese\n│       └── shapes.json     # 8 shapes with properties\n├── hooks/\n│   ├── useSound.ts         # Web Speech API hook\n│   ├── useReward.ts        # Stars/levels/achievements\n│   └── useProgress.ts      # Game progress tracking\n└── lib/\n    └── gameUtils.ts        # Shuffle, random, scoring utils\n```\n\n---\n\n## Deployment / 部署\n\n### Vercel (Recommended)\n\n#### 🚀 首次部署\n\n1. Push to GitHub\n2. Import project at [vercel.com/new](https://vercel.com/new)\n3. Deploy automatically!\n\n#### ⚙️ 配置自动部署（GitHub Actions）\n\n**问题**: 如果你看到 `Error: Input required and not supplied: vercel-token`\n\n**解决方案**: 需要配置 GitHub Secrets\n\n1. **运行配置助手**（推荐）:\n   ```bash\n   npm run setup:deploy\n   # 或者\n   ./scripts/setup-deployment.sh\n   ```\n\n2. **手动配置**:\n   - 查看详细指南: [DEPLOYMENT_SETUP.md](./DEPLOYMENT_SETUP.md)\n   - 获取 Vercel Token: https://vercel.com/account/tokens\n   - 添加 GitHub Secrets: https://github.com/junhey/kid-smart-learning/settings/secrets/actions\n\n3. **需要添加的 Secrets**:\n   - `VERCEL_TOKEN` - 从 Vercel Dashboard 创建\n   - `VERCEL_ORG_ID` - 运行 `vercel link` 后获取\n   - `VERCEL_PROJECT_ID` - 运行 `vercel link` 后获取\n\nThe workflow in `.github/workflows/deploy.yml` will:\n- ✅ Type-check on every push\n- ✅ Build and deploy to Vercel on merge to `main`\n- ✅ Create preview deployments for PRs\n\n---\n\n## Design System / 设计规范\n\n### Colors / 颜色\n\n| Token | Hex | Usage |\n|---|---|---|\n| Primary | `#FFB84D` | Buttons, accents |\n| Secondary | `#4DD0E1` | Math theme |\n| Danger | `#FF6B6B` | Wrong answers |\n| Success | `#81C784` | Correct answers |\n| Purple | `#A78BFA` | Levels, rewards |\n\n### Typography\n- **Nunito** — Primary font (rounded, child-friendly)\n- **Fredoka One** — Display letters in games\n\n### Touch Targets\n- All interactive elements: minimum 64px height\n- Large emoji buttons: 80-100px height\n\n---\n\n## Roadmap / 路线图\n\n- [ ] More English categories (body parts, weather, food)\n- [ ] Chinese language support (Mandarin mode)\n- [ ] Multiplayer / family mode\n- [ ] More math: multiplication intro, skip counting\n- [ ] Story mode with narrative\n- [ ] Parent dashboard with progress reports\n- [ ] Offline PWA support\n- [ ] More languages (Spanish, French)\n\n---\n\n## Changelog / 更新日志\n\n### v1.0.0 (2026-03-10)\n- Initial release\n- 5 English games: AlphabetBalloon, WordMatch, PhonicsGame, ListenAndChoose, SentenceBuilder\n- 5 Math games: NumberCount, AdditionGame, ShapeMatch, CompareNumbers, MathShooter\n- Reward system: stars, levels 1-10, achievements (firstStar, perfectRound, streak10)\n- JSON curriculum: 26 letters, 100+ words, 30 sentences, 8 shapes\n- Framer Motion animations throughout all games\n- Web Speech API for pronunciation in English games\n- Responsive design for iPad/tablet/desktop\n- GitHub Actions CI/CD workflow for Vercel\n\n---\n\n## Contributing / 贡献\n\nContributions welcome! Please:\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/new-game`\n3. Commit your changes\n4. Open a Pull Request\n\n---\n\n## License / 许可证\n\nMIT License — free for educational use.\n\n---\n\nMade with ❤️ for curious kids everywhere!\n为世界各地好奇的孩子们用爱制作！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunhey%2Fkid-smart-learning","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjunhey%2Fkid-smart-learning","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunhey%2Fkid-smart-learning/lists"}