Building the ultimate toddler learning universe. Interactive, safe, and wildly fun educational games designed entirely for curious tiny minds.
Built for speed and simplicity. We use Mise for task management and Bun as our ultra-fast runtime.
# 1. Clone the repository
>_ git clone https://github.com/nramanath/vivingo.git
>_ cd vivingo
# 2. Install & Start (Managed via Mise)
>_ mise run init
>_ mise run dev
[Vite] Server running at http://localhost:5173Vivingo's game library is built on a Unified Game Architecture, ensuring a consistent look and feel while keeping game-specific logic completely decoupled.
View All Available Games
| Game | Age | Core Mechanic | Educational Focus |
|---|---|---|---|
| ABC Hunt | 3+ | Keyboard matching | Typing, Alphabet Sequence |
| Number Hunt | 3+ | Keyboard matching | Number Sequence (1-100) |
| Number Sequencer | 4+ | Fill-in-the-blank | Advanced Counting & Patterns |
| Mystery Messages | 3+ | Symbol Decoding | Reading, Problem Solving |
| Left-Right Match | 2+ | Arrow Key Choice | Directional Awareness |
| The Big Parade | 2+ | Action timing | Cause-and-Effect, Vocabulary |
| Surprise Box | 2+ | Button Mashing | Discovery, Motor Skills |
| World Explorer | 3+ | Number Mapping | Geography |
| Ball Maze | 4+ | 3D Physics Roll | Spatial Navigation |
Note
Technical Deep Dive: Mystery Messages Architecture
Click to see Word System & Combinations
Phrases are composed from categorized JSON word banks located in src/components/game/mystery-messages/utils/words/.
| File | Contents |
|---|---|
animals.json |
80+ animals |
nature.json |
80+ nature words |
food.json |
80+ food words |
things.json |
100+ everyday objects |
adjectives.json |
150+ adjectives |
verbs.json |
100+ action verbs |
| Stage | Template | Example |
|---|---|---|
| 1 | Single noun | CAT |
| 2 | ADJ + NOUN | WET FOX |
| 3 | Complex phrases | FAST DEER LEAP |
With over 24.8 million possible combinations, a child playing twice daily would encounter less than 0.025% of the content in a year.
Unified Game Framework
All games are built using a standardized framework that separates UI from Logic:
- Shared Components: Reusable UI elements (
GameActionButton,GameInstructionPill,GameFeedbackBanner,GameProgressDots) ensure a premium, consistent experience. - Custom Hooks: Business logic is encapsulated in game-specific hooks (e.g.,
useAlphabetHuntLogic), making the visual components lightweight and purely representational. - Strict Testing: Every game is backed by an automated test suite ensuring reliability across all stages and interactions.
Development Standards & Workflows
- Agentic Workflows: Located in
.agent/workflows, our custom agentic commands (/pr-creator,/code-reviewer) enforce production-grade standards autonomously. - Code Style: Strictly enforced via Prettier and comprehensive ESLint rules.
- Conventional Commits: Enforced via Husky and Commitlint (
.commitlintrc.cjs).
- Styled with Tailwind CSS.
- UI components built with shadcn/ui.
- Custom Brand Theme: Zesty Macaroons (Neon Green, Kelly Green, Freesia, Yellow).
Fully integrated with Vercel. Every push to main immediately updates vivingo.vercel.app. Every PR gets a unique dynamic preview string sent straight to GitHub for sandbox testing.
We welcome input from parents, educators, and developers. If you have ideas for new educational games, want to report a bug, or simply have feedback on the user experience, please use the structured forms in our Issues tab.
Built with care for tiny minds. Powered by Antigravity AI.