📱 Pixeldust Flutter Assignment: Build an API-Powered App

Welcome to the Flutter Developer Assignment! We’re excited to see your skills in action. This assignment is designed to evaluate your Flutter development skills, understanding of APIs, and your ability to create a user-friendly application.

---

🛠 Assignment Objectives

1. Build an Android and iOS app using Flutter.
2. Use a public API to fetch data and display it in a list format.
3. Implement the following features:
   • Search Bar: Allow users to search through the list of data.
   • Recent Searches: Display a list of the most recent search terms entered by the user.
4. Host the code in a public GitHub repository.
5. Share the repository link and include the following in your submission:
   • Screenshots of the working app.
   • Optionally, upload the APK of the app for extra points.

---

💡 Assignment Details

Functional Requirements

1. Use a public API of your choice to fetch data (refer to suggestions below).
2. Display the fetched data in a scrollable list.
3. Implement a search bar at the top of the list.
4. Show a dropdown or horizontal list of recent searches below the search bar.
5. Optimize the UI to be responsive and visually appealing.

---

⚙️ Suggested Public APIs

Here are some interesting APIs you can use for the assignment:

1. The Movie Database (TMDB)

   • Base URL: https://api.themoviedb.org/3/
   • API Key: Sign up for a free account to get your API key.
   • Docs: TMDB API Documentation
   • Example: Fetch popular movies and implement a search functionality.

2. OpenWeather API

   • Base URL: https://api.openweathermap.org/data/2.5/
   • API Key: Sign up for free access.
   • Docs: OpenWeather API Documentation
   • Example: Fetch current weather data for a list of cities and enable search.

3. JSONPlaceholder API

   • Base URL: https://jsonplaceholder.typicode.com/
   • Docs: JSONPlaceholder API Documentation
   • Example: Fetch a list of users, posts, or todos.

4. Dog CEO API

   • Base URL: https://dog.ceo/dog-api/
   • Docs: Dog API Documentation
   • Example: Fetch a list of dog breeds and images.

5. Public APIs Directory

   • Explore public-apis.io for more APIs.

---

📋 Submission Guidelines

1. GitHub Repository: Create a public GitHub repository and commit your code.
   • Include a detailed README.md file explaining your app, API usage, and steps to run the project.
2. Screenshots: Add screenshots of the app in the repository.
3. APK: Share a working APK file of the app for extra points.
4. Link: Share the GitHub repository link with us.

---

🏆 Bonus Points

1. Implement a persistent storage mechanism to save recent searches (e.g., Shared Preferences or SQLite).
2. Make the UI interactive and user-friendly with animations or theming.
3. Use state management libraries like Provider, Riverpod, or Bloc.

---

🧭 Evaluation Criteria

1. Code Quality: Readability, modularity, and adherence to best practices.
2. App Functionality: Proper API integration and feature implementation.
3. UI/UX: Clean and visually appealing user interface.
4. Innovation: Any additional features or creative enhancements.

---

We can’t wait to see what you build! Good luck and happy coding! 🚀