onimal-game

🐾 Onimal - The Ultimate Pet Webgame

Ogame meets Pokémon meets Tamagotchi - Modern pet simulation for kids 5-13 years old

Note: The game source code lives in the onimal-game/ subdirectory of this repository. The root folder hosts documentation and meta files.

🎮 Play Now

▶️ PLAY ONIMAL (Coming Soon)

✨ What Makes Onimal Special

• 🕰️ Ogame-style Timers: Strategic waiting (1-16 hours) that builds anticipation
• ⚔️ Tactical Combat: Turn-based battles with type advantages
• 🐕 5 Pet Species: Dogs, Cats, Birds, Reptiles, Amphibians
• 📈 4 Evolution Stages: Cub → Young → Adult → Veteran
• 💫 Spectacular Animations: Epic moments that make kids say “WOW!”
• 📱 Mobile-First: Perfect on phones, tablets, and desktop

🎯 Game Features

✅ Currently Working (MVP)

• Create and adopt virtual pets (5 species)
• Care for pets: Feed, Play, Rest
• Resource management (coins, needs)
• Persistent save system (localStorage)
• Responsive mobile-first UI

🚧 In Development

• Daily timer system (Ogame-style)
• Evolution system (4 stages)
• Combat system (turn-based)
• Professional sprites (120 total)
• Achievement system
• Daily rewards

🔮 Planned Features

• Breeding system
• Trading cards
• Mini tournaments
• Offline PWA mode

🛠️ Tech Stack

Current (MVP)

• Frontend: Pure HTML5 + CSS3 + Vanilla JavaScript
• Storage: localStorage (client-side)
• Deployment: Static hosting ready

Next Phase

• Framework: Svelte 5 + SvelteKit + TypeScript
• Testing: Vitest (36/36 tests passing)
• Animations: Framer Motion + CSS
• Build: Vite

🚀 Quick Start

Play the Game

1. Generate onimal-standalone.html with npm run build:standalone (see docs/standalone-build.md)
2. Open the generated file in any modern browser
3. Start caring for your first pet!

Development Setup

git clone https://github.com/Ghenwy/onimal-game.git
cd onimal-game
npm install
npm run dev

📱 Screenshots

Coming soon - Game screenshots and GIFs

🎨 Design Philosophy

“Quality webgame that rivals mobile games”

• For Kids: Safe, educational, no ads or predatory monetization
• For Parents: Responsible gaming, clear time limits, educational value
• For Players: Addictive but healthy, strategic depth, emotional bonding

📊 Development Roadmap

Phase 1: Foundation (Week 1-2)

• MVP functional game
• Core pet mechanics
• GitHub setup & documentation
• Timer system implementation

Phase 2: Professional Assets (Week 3-4)

• 120 professional sprites
• Advanced CSS animations
• Epic moment sequences

Phase 3: Combat & Strategy (Week 5-6)

• Turn-based combat system
• Daily battle limits
• Evolution mechanics

Phase 4: Polish & Launch (Week 7-8)

• Performance optimization
• User testing
• Public launch

🤝 Contributing

We welcome contributions! See our Contributing Guide for details.

How You Can Help

• 🎨 Artists: Create pet sprites and animations
• 💻 Developers: Implement new features
• 🎮 Game Designers: Balance mechanics
• 👶 Parents: Playtesting with kids

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎯 Project Goals

1. Create the best pet webgame for kids
2. Demonstrate modern web game development
3. Build a safe, educational gaming experience
4. Showcase strategic timing mechanics

📞 Contact

• Developer: @Ghenwy
• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

⭐ Star this repo if you think Onimal will be awesome!

📢 Follow the project to get updates on development progress!

🎮 Try the game and let us know what you think!

---

Made with ❤️ for kids everywhere

This site is open source. Improve this page.