README.md

ImageX - Image Converter

A browser-based image converter that allows you to convert images to various formats without any ads or servers—ensuring your privacy.

🌟 Features

• Multiple Format Support: Convert images to PNG, JPEG, WebP, AVIF, BMP, and ICO.
• Responsive Design: Works seamlessly on all devices.
• Privacy First: All processing happens locally in your browser.
• User-Friendly Interface: Intuitive controls for file uploads, format selection, and resizing.
• Download History: Keep track of your recent conversions.

🚀 Demo

Try it out live at imagex.vehbi.me

🛠️ Technologies Used

• React (via NextJS)
• TypeScript
• TailwindCSS
• Lucide Icons
• FileSaver.js

⚙️ Installation

1. Clone the repository

   git clone https://github.com/vehbiu/imagex.git

2. Install dependencies

   bun install

3. Start the development server

   bun run dev

📁 Project Structure

src/
├── components/
│   ├── ui/                  # UI components
│   └── download-history.tsx # Download history component
├── app/
│   ├── page.tsx             # Main conversion page
│   └── layout.tsx           # Default layout
├── lib/
│   ├── types.ts             # Type definitions
│   └── utils.ts             # Utility functions (shadcn)
├── App.tsx                  # Main application component
└── ...

🎨 Customization

Adding New Formats

To add support for a new image format, modify the format options in the Select component within image-converter.tsx:

<SelectItem value="newformat">New Format</SelectItem>

⚠️ Warning Canvas does not support all image formats. Make sure to test the new format thoroughly before adding it to the list.

Updating Styles

Modify the styles in tailwind.config.js to customize the appearance of the UI components.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

👤 Author

Vehbi

• Website: vehbi.me
• GitHub: @vehbiu

🙏 Acknowledgments

• Icons provided by Lucide
• File handling library: FileSaver.js

📊 Stats

---

Made with ❤️ by @vehbiu