dhruvin771 / dreamy_walls

Dreamy Walls is a Flutter app for exploring and downloading high-quality wallpapers from Unsplash, with features like liking images and live search.

Dreamy Walls

Dreamy Walls is a Flutter app that allows users to explore and download high-quality wallpapers from Unsplash. With features like image liking, category-wise browsing, live search, and automatic cache clearing, Dreamy Walls aims to provide users with a seamless wallpaper browsing experience.

Screenshot

Features

• Explore Wallpapers: Browse a vast collection of high-resolution wallpapers from Unsplash.
• Download Wallpapers: Download wallpapers directly to your device for offline use.(Note: Download feature is currently pending and under development.)
• Like Wallpapers: Like your favorite wallpapers to save them for later viewing.
• Category-wise Browsing: Explore wallpapers based on different categories for easy navigation.
• Live Search: Instantly find wallpapers with the live search feature for a seamless user experience.
• Automatic Cache Clearing: Automatically clear cached images every 7 days to optimize storage usage.
• Upcoming Features: More functionalities will be added in the future to enhance user experience.

Setup Instructions

1. Clone the repository: https://github.com/dhruvin771/Dreamy_Walls.git
2. Install dependencies: Refer to the pubspec.yaml file and ensure all listed dependencies are installed.
3. Customize the app as per your preferences.
4. Run the app on your preferred device/emulator: flutter run

Usage

• Explore: Browse through wallpapers by scrolling or selecting categories.
• Download: Tap on the download button to save wallpapers to your device.
• Like: Like wallpapers by tapping the heart icon to save them to your favorites.
• Search: Use the search feature to find specific wallpapers by keywords.

Technologies Used

• Flutter
• Dio (for API calls)
• sqflite (for local database)
• flutter_local_notifications (for notifications) (Upcoming)
• flutter_bloc (for state management)
• connectivity_plus (for network connectivity status)
• dartz (for functional programming)
• flutter_staggered_grid_view (for grid layout)
• cached_network_image (for caching network images)
• flutter_cache_manager (for managing cached images)
• shared_preferences (for storing user preferences)
• url_launcher (for launching URLs)
• equatable (for value equality)

Contributing

Contributions are welcome! If you'd like to contribute to Dreamy Walls, please fork the repository, make your changes, and submit a pull request.

Credits

Dreamy Walls utilizes the Unsplash API for fetching wallpapers. Special thanks to Unsplash for providing such an extensive collection of high-quality images.

License

This project is licensed under the MIT License. Feel free to modify and distribute it according to the terms of the license.