🎮 KindWars

A wholesome arcade game where kindness saves the day!

KindWars is an open-source arcade game with a mission: Gaming for a Cause. Every friend you save in the game helps us support cancer patients. We donate 100% of the ad revenue generated from this game directly to cancer patient charities.

Shoot kindness orbs at falling enemies to transform them into friends. Fast, fun, and perfect for casual play!

�️ Our Mission

We believe in the power of gaming to make a positive impact. KindWars was built to:

1. Spread Kindness: A non-violent game where you "defeat" enemies by turning them into friends.
2. Support Charity: All proceeds from in-game advertisements go to verified cancer support organizations.
3. Open Source: We encourage developers to contribute, learn, and help us make the game better.

�🎯 Features

• Gaming for a Cause: Play to donate!
• Simple Gameplay: Tap/click to shoot kindness upward.
• Progressive Difficulty: The game speeds up as your score increases.
• 3 Lives System: Don't let enemies reach the bottom!
• Score Tracking: See how many friends you can save.
• PWA Enabled: Install on your phone for offline play.
• Mobile Optimized: Fullscreen, responsive design for gaming on the go.

🎮 Controls

• Mobile: Tap anywhere to shoot, drag to move.
• Desktop: Arrow keys to move, Spacebar to shoot.

🚀 Getting Started

We welcome contributions! Whether you're a developer, designer, or sound artist, you can help improve KindWars.

Run Locally

# Clone the repository
git clone https://github.com/gajanansr/kindness-bloom.git

# Navigate to the project directory
cd kindness-bloom

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:8080 to play!

Build for Production

npm run build

🛠 Tech Stack

• React - UI framework
• TypeScript - Type safety
• Phaser 3 - Game engine
• Tailwind CSS - Styling
• shadcn/ui - UI Component library
• Vite - Build tool
• PWA - Installable app

🤝 Contributing

This project is open source and we love contributions! Here are some ways you can help:

• Code: Fix bugs, add new features (power-ups, new enemy types).
• Art: Create new sprites, animations, or backgrounds.
• Sound: Compose music or create sound effects.
• Ideas: Suggest new gameplay mechanics or improvements.

Please feel free to fork the repository and submit a Pull Request.

📄 License

MIT License - You are free to use, modify, and distribute this software. See the LICENSE file for details.

🎮 Play & Support

Spread kindness, save friends, and help us fight cancer! 💕

---

Built with ❤️ by Gajanan