Skip to content

SebastianLevano/kibo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kibo

Help Kibo restore a magical world by solving math adventures.

Kibo is a free, offline-first educational game for kids aged 5 and up. Players guide a small guardian of nature through short math and logic challenges.

Every correct answer moves Kibo one step forward in the story. Children count objects, solve small sums, compare groups, and complete patterns. Finished levels unlock visual rewards for Kibo's garden.

Features

  • Story-driven math adventure
  • Counting, addition, comparison, and pattern challenges
  • Big answer buttons designed for young children
  • Kibo advances one step after each correct answer
  • Visual rewards after each completed level
  • Seeded procedural level generation
  • Deterministic challenges so level numbers are reproducible
  • Multiple magical environments
  • Bilingual UI: English and Spanish
  • Offline-first, no backend, no accounts
  • Progress saved in localStorage

Level System

Levels Concept
1-3 Counting and tiny sums
4-6 Counting, addition, and simple patterns
7-9 Addition, comparison, and patterns
10-14 Mixed challenges with larger numbers
15+ Harder sums, comparisons, and longer patterns

Getting Started

npm install
npm run dev

Open the local Vite URL and start playing.

Scripts

Command Description
npm run dev Start dev server
npm run build Production build
npm run preview Preview production build
npm run lint Run ESLint

Architecture

src/
  main.jsx
  App.jsx
  index.css
  data/
    catalogs.js
    i18n.js
    missions.js
  engine/
    challengeGenerator.js
    levelGenerator.js
    rng.js
  hooks/
    useGameState.js
  components/
    ChallengeCard.jsx
    GameWorld.jsx
    KiboCharacter.jsx
    Particles.jsx
    ResultOverlay.jsx
    SpeechBubble.jsx
  screens/
    GameplayScreen.jsx
    IntroScreen.jsx
    MissionsScreen.jsx
    SplashScreen.jsx

Design Principles

  • Engine functions stay pure and independent from React.
  • Missions are data-driven and share one structure for tutorials and generated levels.
  • Procedural levels are generated from seeded educational challenges.
  • The theme is nature, magic, restoration, and math discovery.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors