RA
rafay99-epic/ImageComposer
ImageComposer is a web app responsible for compressing images while ensuring they remain high quality
๐ผ๏ธ Image Composer
A modern, client-side image compression and optimization tool built with React and TypeScript. Process your images directly in the browser with no server uploads required.
โจ Features
- ๐ Client-Side Processing: All image processing happens in your browser - your images never leave your device
- ๐จ Multiple Format Support: Convert between JPEG, PNG, and WebP formats
- ๐ฑ Fully Responsive: Optimized for mobile, tablet, and desktop devices
- ๐ฏ Batch Processing: Process multiple images at once with bulk selection tools
- ๐ Real-Time Preview: See your changes instantly before downloading
- ๐๏ธ Advanced Controls:
- Quality adjustment (1-100%)
- Format conversion (JPEG/PNG/WebP)
- Rounded corners with adjustable radius
- Drag and drop support
- ๐ Social Sharing: Share your compression results directly to social media
- ๐ Compression Stats: View detailed statistics about your image optimization
๐ Getting Started
Prerequisites
- Node.js (v16 or higher)
- npm or yarn or bun
Installation
- Clone the repository:
git clone https://github.com/rafay99-epic/ImageComposer.git
cd ImageComposer- Install dependencies:
# Using npm
npm install
# Using yarn
yarn
# Using bun
bun install- Start the development server:
# Using npm
npm run dev
# Using yarn
yarn dev
# Using bun
bun dev- Open http://localhost:5173 in your browser
๐ ๏ธ Built With
- React - UI Framework
- TypeScript - Type Safety
- Vite - Build Tool
- Tailwind CSS - Styling
- shadcn/ui - UI Components
- Lucide Icons - Icons
๐ฑ Mobile Optimization
- Touch-friendly controls
- Responsive layouts
- Optimized for various screen sizes
- Native share integration
- Mobile-first design approach
๐ Privacy & Security
- No server uploads required
- All processing happens locally
- No data collection
- No external API calls for image processing
๐ฏ Use Cases
- Optimize images for web use
- Reduce file sizes for sharing
- Convert between image formats
- Prepare images for social media
- Batch process multiple images
๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
๐ Acknowledgments
- browser-image-compression for image processing
- react-hot-toast for notifications
- Community feedback and contributions
Made with โค๏ธ by Abdul Rafay
On this page
Languages
TypeScript95.6%JavaScript1.8%HTML1.5%CSS1.1%
Contributors
MIT License
Created April 14, 2025
Updated February 11, 2026
