A Tamagotchi-style mobile app where you can adopt and care for your own Pokémon. Feed, play with, clean, and rest your Pokémon to keep them happy and healthy. As you care for your Pokémon, they gain experience, level up, and can even evolve!
- Complete Care System: Manage your Pokémon's hunger, happiness, cleanliness, energy, and overall health
- Real-time Stat Decay: Stats decrease over time, requiring regular attention
- Experience & Leveling: Earn XP through care activities, increasing your Pokémon's level
- Evolution: Once your Pokémon reaches the right level, experience the magic of evolution
- Personalized Trainer Profile: Create your own trainer with name and gender selection
- Starter Pokémon Selection: Choose from classic starter Pokémon to begin your journey
- Authentication System: Secure login and registration system
The app is built with a modern, maintainable architecture:
- Expo Router: File-based routing system with type safety
- Tab Navigation: Clean bottom tabs for switching between main app sections
- Stack Navigation: Smooth transitions for auth and onboarding flows
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Context │◄────┤ Components │────►│ AsyncStorage│
│ (Auth/Game)│ │ (UI Screens)│ │(Local Data) │
└──────┬──────┘ └─────────────┘ └─────────────┘
│ ▲ ▲
▼ │ │
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Helpers │────►│ Hooks │────►│ PokeAPI │
│ (Utilities) │ │(Custom Logic│ │(External │
└─────────────┘ │ Handlers) │ │ Data Source)│
└─────────────┘ └─────────────┘
- AuthContext: Manages user authentication state
- PokemonCareScreen: Main game screen for interacting with Pokémon
- EvolutionModal: Handles Pokémon evolution animations and logic
- Notification System: Alerts for Pokémon needs and events
- React Native: Cross-platform mobile framework
- Expo: Development platform and tools
- TypeScript: Type-safe code
- Expo Router: File-based navigation
- Styled Components: Component-level styling
- AsyncStorage: Local data persistence
- PokeAPI: External Pokémon data source
- Hunger: Decreases over time, restored by feeding
- Happiness: Decreases over time, increased by playing
- Cleanliness: Decreases over time, restored by cleaning
- Energy: Decreases over time, restored by sleeping
- Health: Overall wellbeing based on other stats
- Pokémon can evolve once they reach level 10
- Evolution changes appearance and improves base stats
- Evolution chains follow canonical Pokémon progressions
- Clone the repository
git clone https://github.com/yourusername/pokemon-care.git
cd pokemon-care- Install dependencies
npm install- Start the development server
npx expo start- Run on your device or emulator
- Scan the QR code with Expo Go app (Android) or Camera app (iOS)
- Or press 'a' for Android emulator or 'i' for iOS simulator
- Create an account or log in
- Complete the onboarding process and select your starter Pokémon
- Take care of your Pokémon by:
- Feeding when hungry
- Playing when sad
- Cleaning when dirty
- Resting when tired
- Watch your Pokémon grow, level up and evolve!
- Multiple Pokémon collection
- Mini-games for more interactive play
- Pokémon trading system
- Seasonal events with special rewards
- Expanded evolution chains and more Pokémon
This project is licensed under the MIT License - see the LICENSE file for details.
- PokeAPI for the comprehensive Pokémon data
- Expo for the excellent development tools
- The Pokémon franchise for the inspiration
Note: This is a fan project and is not affiliated with Nintendo or The Pokémon Company.