AWO JAY Wallpaper App

A beautiful Flutter wallpaper application that fetches images from the Pexels API.

Features

• Home Screen:

  • Random images displayed in a circular pattern at the top right
  • "AWO JAY" text centered on the screen
  • Image slideshow with auto-play
  • Three dots indicator showing current slide

• Search Screen:

  • Search box to find wallpapers from Pexels API
  • Grid view of search results

• Categories Screen:

  • Predefined categories (Nature, Animals, Architecture, etc.)
  • Beautiful category cards with preview images

Setup Instructions

1. Install Dependencies

Run the following command in the images_app directory:

flutter pub get

2. Get Pexels API Key

1. Go to https://www.pexels.com/api/
2. Sign up for a free account
3. Get your API key from the dashboard

3. Configure API Key

Open lib/services/pexels_service.dart and replace YOUR_PEXELS_API_KEY with your actual API key:

static const String _apiKey = 'YOUR_PEXELS_API_KEY';

4. Run the App

flutter run

Project Structure

lib/
├── main.dart                 # App entry point with navigation
├── models/
│   └── pexels_image.dart    # Data models for Pexels API
├── services/
│   └── pexels_service.dart  # API service for Pexels
├── providers/
│   └── pexels_provider.dart # Riverpod state management
└── screens/
    ├── home_screen.dart      # Home page with slideshow
    ├── search_screen.dart    # Search functionality
    └── categories_screen.dart # Categories page

Packages Used

• flutter_riverpod: State management
• http: HTTP client for API calls
• cached_network_image: Efficient image loading and caching
• carousel_slider: Image slideshow functionality

Notes

• The app uses Riverpod for state management
• Images are cached for better performance
• The slideshow auto-plays with 3-second intervals
• All images are fetched from the Pexels API