Skip to content

README.md

Latest commit

 

History

History
80 lines (55 loc) · 2.5 KB

README.md

File metadata and controls

80 lines (55 loc) · 2.5 KB

📱 Pokémon Explorer

This is a simple React Native app that interacts with the PokeAPI to fetch and display a list of Pokémon. Users can view detailed information about each Pokémon, including images, types, abilities, stats, and more.

✨ Features

  • 🔍 Fetch and display a paginated list of Pokémon
  • 📄 View detailed information about each Pokémon
  • 🖼️ Display official artwork, sprites, and stats
  • ❤️ Toggle favorites (feature ready for extension with Context API)
  • 🚀 Smooth navigation between screens
  • 📱 Responsive UI designed for mobile devices

🔧 Tech Stack

  • React Native with TypeScript
  • React Navigation (native stack)
  • PokeAPI for Pokémon data
  • Context API (setup ready for state like favorites)
  • Toast Messages for error handling
  • FlashList and performance-optimized components

🗂️ Project Structure

├── api/                  # API calls and helpers
├── components/           # Reusable UI components
├── context/              # Global state management (favorites setup)
├── screens/              # App screens (Home, Details, etc.)
├── utils/                # Constants, helpers, and entity interfaces
└── App.tsx               # App entry point

📸 Screenshots

Homepage Favorite pokemons Pokemon details page Notification

🚀 Getting Started

1. Clone the repository

git clone https://github.com/Samson8/react-native-task.git
cd react-native-task

2. Install dependencies

yarn install

3. Start the development server

npx react-native run-ios    # for iOS
npx react-native run-android # for Android

⚠️ Make sure your emulator or device is properly configured.

✅ To Do / Future Improvements

  • Implement persistent storage (e.g., AsyncStorage) for favorites
  • Improve UI styling with cards and colors
  • Handle offline support or loading states more gracefully

🧑‍💻 Author

Samson Damilola
GitHub