Gif Hunter is a high-performance, minimalist web application built with Flutter for searching, viewing, and sharing animated GIFs. Focused on speed and a frictionless user experience, it leverages the Giphy API to deliver instant results with a modern, responsive interface.
- Search-as-you-type: Fluid, debounced search (500ms) for instantaneous results.
- Trending Tags: Browse and multi-select trending terms to discover new content.
- Infinite Scroll: Smart pre-fetching with duplicate filtering for an endless browsing experience.
- Favorites Gallery: Save your favorite GIFs locally (
shared_preferences) for quick access. - One-Tap Copy: Quick-access "Copy Link" with visual "Copied!" feedback.
- Hero Animations: Smooth transitions from grid items to full-screen detail views.
- Animated Feedback: Scale-down effects for unhearting and smooth hover states across the UI.
- Responsive Layout: Adaptive design that feels native on both Desktop and Mobile.
- Skeleton Loading: Shimmer effects for a polished "content is loading" experience.
- Flutter SDK (Stable channel)
- A Giphy API Key
-
Clone the repository:
git clone https://github.com/rafaelmtro/gif-hunter.git cd gif-hunter -
Setup Environment: Create a
.envfile in the root directory and add your Giphy API Key:GIPHY_API_KEY=your_api_key_here
-
Install Dependencies:
flutter pub get
-
Run the Application:
flutter run -d chrome
- Framework: Flutter (Web)
- State Management: Riverpod
- Networking: Dio
- Local Storage: Shared Preferences
- Animations: Custom Flutter Animations & Hero widgets.
For a consistent development environment, you can use the provided Docker configuration:
# Build the image
docker build -t gif-hunter-dev .
# Run the container
docker run -p 8080:8080 -v $(pwd):/app -it gif-hunter-devDistributed under the MIT License. See LICENSE for more information.
Rafael Monteiro
- GitHub: @rafaelmtro