Giphy App

Test task: an application to display GIF animations from the Giphy website

---

Project overview

This application retrieves a list of GIF images from the Giphy web API and displays them to the user. Users can click on any GIF to view it in full-screen mode on the next screen

Splash Screen

When the application is launched, the user is greeted with a splash screen where the Internet connection is checked

• If no connection is detected and the local database is empty (e.g., the application is being launched for the first time), a dedicated screen informs the user about the issue with the Internet connection and provides the option to navigate to the device settings to enable it

• If the Internet connection is unavailable but the database already contains previously saved and cached GIF images, the application opens a screen displaying the GIFs. At the same time, the user is notified about the lack of Internet connectivity with an option to quickly navigate from this screen directly to the device settings

GIF Images Loading

Search Functionality

• If the local database already contains previously requested GIF images, the application displays images based on the most recent search query from the database

• If the user navigates to the next page of the current search query, the application fetches and displays images for the next page of the current query

• If the user enters a new search query, the application fetches images for the new query and displays them. All search queries are saved in the database. When GIF files are deleted, they are removed from the database and will no longer appear on the screen, even if the query is entered again.

Search Requests

All user search queries (validated for specific characters) are processed by making requests to the Giphy Search API. For example: https://api.giphy.com/v1/gifs/search?api_key=YOUR_API_KEY&q=SEARCH_QUERY&limit=25&offset=OFFSET&rating=g

Individual GIF View

If a user selects a GIF from the list, it is displayed in full-screen mode on a new screen. To fetch this high-quality and detailed GIF, the application makes a separate request to the following endpoint: https://api.giphy.com/v1/gifs/{GIF_ID}?api_key=YOUR_API_KEY&rating=g

This high-resolution GIF is not saved to the local database

Minimum Android Version:

• Mobile app: Android 8.0 (API level 26)

Basic Architecture

• Jetpack Compose
• Multi-module project
• MVI
• Offline-first approach

Libraries and Frameworks

• Koin DI
• Room Database
• Retrofit
• Coil

Features and Functionality

• Offline-first approach: Data is fetched directly from the database, considering pagination offsets.
• Pagination Controls: The forward button is hidden if the loaded GIF count is below 24, signaling the last page.
• Type-safe compose navigation
• GIF Deletion Handling: When a GIF is deleted, it is replaced by the next one. If insufficient GIFs are available locally, additional ones are fetched from the internet.
• Persistent Internet Check: The application monitors internet availability throughout its lifecycle.
• User Input Validation: Search queries undergo character validation.
• Smooth User Experience: Animated transitions enhance the UI.
• Screen Orientation Support: The app dynamically adapts to portrait and landscape modes.
• Error Handling:
  • Handles API request failures, including server unavailability, network issues, and response status codes.
  • Ensures database integrity by handling access issues and storage limitations.
• User Notifications: Errors and messages are displayed using SnackBar notifications.
• Pagination Navigation: Users can move between search results pages, with the "Next" button disappearing when fewer than 24 GIFs are loaded.
• Efficient Data Delivery: Uses Kotlin Coroutines and Flows for asynchronous data processing.
• Search Query Retention: The app retains up to 100 search queries, automatically removing associated GIFs when queries are deleted.