Skip to content

Repository files navigation

Wallpaper App - Development Guide

🎯 Project Overview

A modern, modular Flutter wallpaper application built with clean architecture principles. This app allows users to browse, search, and manage wallpapers from Pexels API with a beautiful dark theme and smooth user experience.

✨ Features

Core Features:

  • 🖼️ Wallpaper Browsing - Curated and categorized wallpapers
  • ❤️ Favorite Management - Local persistence with SharedPreferences
  • 🔍 Search Functionality - Find wallpapers by keywords
  • 📱 Full-Screen Viewer - Interactive image viewing with zoom
  • 📂 Category Filtering - Organized by nature, abstract, technology, etc.
  • 🔄 Pull-to-Refresh - Smooth refresh experience
  • 📜 Infinite Scrolling - Pagination for endless browsing

Advanced Features:

  • 🎨 Dark Theme - Beautiful dark UI with Material Design
  • 💾 Cached Images - Fast loading with cached_network_image
  • 🌐 Cross-Platform - Works on mobile and web
  • 📊 State Management - Provider for efficient state handling
  • 🛡️ Error Handling - Comprehensive error states and recovery
  • Performance Optimized - Modular architecture for better performance

🏗️ Architecture

Modular Structure:

Screenshot 2025-12-03 222534 Screenshot 2025-12-03 222509 Screenshot 2025-12-03 222435 Screenshot 2025-12-03 222328 Screenshot 2025-12-03 222236 Screenshot 2025-12-03 222907 Screenshot 2025-12-03 222810 Screenshot 2025-12-03 222731 Screenshot 2025-12-03 222717 Screenshot 2025-12-03 222615 Screenshot 2025-12-03 222553

🚀 Release Build Notes

  • This app now expects the Pexels API key at build/run time:
    • --dart-define=PEXELS_API_KEY=YOUR_KEY
  • Android release signing must be configured with your real upload keystore before Play Store upload.
  • App identifiers are set for production:
    • Android: com.elyasahmadi786.online_wallpaper
    • iOS: com.elyasahmadi786.onlinewallpaper
  • Use HTTPS-only network traffic in production (cleartext disabled).

📝 Store Submission

  • Privacy policy: see /PRIVACY_POLICY.md
  • Full store checklist: see /STORE_SUBMISSION_CHECKLIST.md

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages