Pokedex

A lightweight Flutter Pokédex app showcasing a clean project structure, modern tooling, and a minimal set of features built on top of the PokéAPI.

What is this project?

This is a mobile Pokédex app built with Flutter and Riverpod. It provides a searchable list of Pokémon, load-more pagination, and a basic navigation structure. The app is designed as a starter project that can be extended with additional features such as favorites persistence, detailed Pokémon information, and offline support.

Key Features

• Paginated list of Pokémon (load more as you scroll)
• Search across all Pokémon via a search delegate that loads all Pokemon names once
• Basic navigation using go_router with support for multiple screens
• Light / Dark theme support using a shared theme system
• Splash screen via flutter_native_splash

Demo

Main Screens

Home Screen	Search Screen	Favourites Screen	Details Screen

Search Screen

Search Screen	Searching Screen	Search Results

Demo Video

Architecture & Project Structure

This project follows a feature-driven structure, with a small core and shared layer:

• lib/main.dart – app entrypoint, initializes services, and bootstraps Flutter + Riverpod.
• lib/app.dart – root MaterialApp.router configuration.
• lib/bootstrap/ – app initialization code (e.g., initial data fetch).
• lib/core/ – shared constants, routing, theming, and utilities.
• lib/features/ – feature modules (each feature contains its own presentation, data, and models logic).
• lib/shared/ – shared UI components / scaffolding used across features (e.g., MainScaffold).

Architecture Diagram

Feature Modules

• features/pokemon_list/ – fetches Pokémon list via PokéAPI, renders the grid, and provides search.
• features/pokemon_details/ – placeholder for detailed Pokémon screen (currently a scaffold with app bar).
• features/favourite/ – placeholder for favorites screen.

State Management

• Uses Riverpod for global state (StateProvider) and dependency injection.
• The bottom navigation index is managed via StateProvider<int>.

Navigation

• Uses GoRouter with named routes:
  • / – home screen (MainScaffold)
  • /pokemon-details – details screen

Technology / Dependencies

• Flutter (>= 3.0)
• Riverpod (flutter_riverpod) – state management
• GoRouter – declarative routing
• Dio – HTTP client
• flutter_native_splash – native splash screen
• shimmer – loading shimmer effect

How to Run

Prerequisites

• Flutter SDK installed (stable)
• Xcode (macOS) or Android Studio

Run on a device / emulator

flutter pub get
flutter run

Build

• Android (APK): flutter build apk
• iOS: flutter build ios

Code Highlights

API Layer

The app uses a small API client (PokemonApi) to fetch:

• paginated Pokémon list with details (/pokemon?limit=&offset=)
• all Pokémon names for search (/pokemon?limit=2000)
• single Pokémon details by name (/pokemon/{name})

Pagination Strategy

• The list screen uses a scroll listener to detect when the user approaches the bottom.
• When near the bottom, it requests the next page from the API.
• The repo maintains an _offset and hasMore flag to track pagination state.

Search Strategy

• On first search, the app downloads the full list of Pokémon names (and details) once.
• All search filtering is performed in-memory on the loaded list.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for full terms and conditions.