Skip to content

Repository files navigation

AwesomeList Logo

🌟 AwesomeList

A modern Flutter application that curates and categorizes the most useful links and resources from around the web.



Flutter Dart


📌 About the Project

AwesomeList is a collaborative platform built with Flutter, designed to gather the best links and resources on various topics in one easily accessible application. Categories and subcategories are meticulously organized, allowing users to find what they need quickly.

The project welcomes contributions from everyone. If you have a valuable resource, you can easily add it to the database!


✨ Key Features

Feature Description
🗂️ Categorized Links Resources are neatly organized into intuitive categories and subcategories (managed in lib/screen).
🤝 Community Driven Anyone can contribute by submitting their favorite links via a simple JSON format.
🔍 Searchable Tags Each entry includes tags, making it easy to find specific tools or information.
🎨 Modern UI Built with Flutter for a smooth, responsive, and visually appealing experience across devices.

🛠️ Tech Stack

Category Technology
Framework Flutter (Dart)
Data Structure JSON
(Add other packages used) E.g., url_launcher, shared_preferences, etc.

📂 Project Structure

```text AwesomeList/ ├── lib/ │ ├── screen/ <-- Categories and subcategories are managed here │ ├── models/ │ ├── widgets/ │ └── main.dart ├── assets/ │ └── (Images, fonts, etc.) ├── pubspec.yaml └── README.md ```

🙋‍♂️ How to Contribute

We encourage everyone to add useful links to the AwesomeList! Please follow these simple steps to contribute:

1. Identify the Category

First, check the lib/screen folder to find the appropriate sub_category_id and sub_category_name for your link.

2. Prepare the Data

Format your resource information using this JSON structure:

```json { "sub_category_id": "id_from_lib_screen", "sub_category_name": "Name from lib/screen", "items": [ { "id": "your_unique_id", "title": "Resource Name", "description": "Brief description of the resource.", "url": "https://your-link.com", "image_url": "https://your-link.com/image.png", "tags": ["tag1", "tag2"] } ] } ```

3. Submit

Choose one of the following ways to submit your entry:

  • Method 1 (Preferred): Paste your JSON block into our AwesomeList Submission Doc.
  • Method 2: Email your JSON snippet to ruhidjavadoff@gmail.com with the subject "AwesomeList - New Link".

🖥️ How to Build

1. Install Dependencies

```bash flutter pub get ```

2. Run the App

```bash flutter run ```

📄 License

License: © 2026 AwesomeList. All rights reserved.

👨‍💻 Author

Ruhid Javadov (Mr-Ruhid)

🌟 Support & Donate

If you appreciate the time and effort put into building this app, consider supporting the development. Your motivation keeps this project alive!


Support on Kofe.al    Donate via PayPal



☕ Kofe.al: @ruhidjavadoff
🍵 Çayvoy: ruhid4715
💳 PayPal: ruhidjavadoff@gmail.com
🪙 Crypto (USDT - BNB Smart Chain):
0x9a4AD41762D6B07B8C266b312Cf0dBe31FAd890c

Releases

Contributors

Languages