📂 icon_file

A Flutter package to automatically display a file icon (SVG) with a dynamic badge based on the file extension (.pdf, .jpg, .zip, etc.).
Perfect for file explorers, downloads, or file previews in apps.

🧩 Features

Automatic detection of the file extension
Dynamic colored badge based on file type
Customizable style (color, text, etc.)
Supports over 30 common extensions
Ready for responsive layouts (ScreenUtil)
Dark mode friendly

📸 Preview

Default Icons	Customized Icons

🚀 Installation

Add this to your pubspec.yaml:

dependencies:
  icon_file: ^1.0.X

Then run:

flutter pub get

🛠️ Basic Usage

import "package:icon_file/icon_file.dart";
FileIcon("document.pdf");

🎨 Example with Custom Styles

FileIcon(
  "custom.pdf",
  color: Colors.deepPurple,
  extensionStyle: TextStyle(
    fontSize: 12,
    fontWeight: FontWeight.bold,
    color: Colors.yellow,
  ),
)

💡 Available Parameters

Parameter	Description
`fileName`	(required) File name with extension (`document.pdf`)
`color`	Custom background color for the badge (optional)
`showExtension`	Whether to show the badge with the extension (default: `true`)
`extensionStyle`	Text style for the extension badge
`assetIcon`	Custom path to SVG icon (default: `assets/file.svg`)
`size`	Size of the icon (default: `80`)
`roundedLabel`	Whether the badge has rounded corners (default: `true`)

🔍 Supported Extensions

This package automatically supports the following file types (and can be extended):

pdf, doc, docx, ppt, pptx, xls, xlsx, csv, txt, png, jpg, jpeg, svg, mp3, wav, aac, mp4, avi, mov, js, css, html, json, xml, zip, rar, 7z, tar, gz, dart

🧪 Full Example (UI)

List<String> files = [
  'document.pdf',
  'notes.docx',
  'image.png',
  'video.mp4',
  'music.mp3',
  'slides.pptx',
  'spreadsheet.xlsx',
  'archive.zip',
  'script.js',
  'style.css',
  'readme.txt',
  'logo.svg',
  'data.json',
  'source.dart',
];

List<Widget> icons = files.map((file) => FileIcon(file)).toList();

👥 Contributing

Contributions are welcome!
Feel free to open an issue, submit a pull request, or simply report a bug.

📄 License

This project is licensed under the MIT License.