ChoicePal is a fun, interactive web game that helps couples, friends, and families discover how alike they are through an engaging "this or that" choice-based experience.
- Topic-based Gameplay: Players input any topic (e.g., food, movies, animals) to start the game
- AI-Generated Choices: Uses Google's Gemini 2.5 Flash Lite AI API to generate unique pairs of choices based on the chosen topic
- Two-Player Experience: Players take turns making choices on the same device
- Beautiful UI: Sleek, modern interface with smooth animations and playful design
- Compatibility Score: See how well your choices match with your partner's at the end
- Responsive Design: Works seamlessly on both desktop and mobile devices
- HTML5
- CSS3 (with modern features like CSS Grid and Flexbox)
- Vanilla JavaScript (ES6+)
- Node.js (for local development server)
- Google's Gemini Flash Lite AI API
- Clone the repository:
git clone https://github.com/GxAditya/ChoicePal.git
cd ChoicePal-
Get your Gemini API key:
- Sign up for Google AI Studio at https://aistudio.google.com/app/apikey
- Create and copy your API key
-
Start the local development server:
node server.js- Open your browser and navigate to:
http://localhost:3000
- Enter your API key and a topic to start playing!
- Enter your Gemini API key in the provided field
- Enter a topic in the input field (e.g., food, movies, animals)
- Player 1 makes their choices
- Pass the device to Player 2
- Player 2 makes their choices
- View your compatibility score and comparison of choices
- AI Integration: Uses Google's Gemini 2.5 Flash Lite AI to generate contextually relevant choices
- Fallback System: Includes predefined choices if AI generation fails
- Responsive Cards: Interactive choice cards with hover effects
- Progress Tracking: Visual indicators for game progress
- Results Analysis: Detailed comparison of both players' choices
- Replayability: Easy to start a new game with a different topic
Supports all modern browsers including:
- Chrome
- Firefox
- Safari
- Edge
Contributions are welcome! Please feel free to submit a Pull Request.
This project is open source and available under the MIT License.