Skip to content

tinystacklab/image-cube

Repository files navigation

Image Cube - Professional Online Image Processing Tool

简体中文 | 繁體中文 | English

A free, privacy-focused online image processing tool with compression, format conversion, and cropping capabilities. All processing is done locally in your browser - your images never leave your device.

✨ Features

🗜️ Smart Compression

  • Advanced compression algorithms maintain visual quality while reducing file size
  • Adjustable quality settings (10-100%)
  • Max size limits (no limit, 1920px, 1280px, 800px)
  • Batch processing support

🔄 Format Conversion

  • Convert between JPG, PNG, WebP, GIF, and BMP formats
  • One-click conversion to optimal format
  • Adjustable output quality

✂️ Precise Cropping

  • Free cropping or preset aspect ratios (1:1, 4:3, 16:9, etc.)
  • Common size presets (800×600, 1280×720, 1920×1080, 1080×1080)
  • ID photo sizes with real dimensions:
    • 1-inch Photo (25×35mm)
    • 2-inch Photo (35×49mm)
    • Passport (35×45mm)
    • Visa Photo (33×48mm)
    • US Visa (51×51mm)
  • Multiple output formats

🌐 Multi-language Support

  • English
  • Simplified Chinese (简体中文)
  • Traditional Chinese (繁體中文)
  • Auto-detection based on browser language
  • Manual language switching

🔒 Privacy & Security

  • 100% Client-side Processing: All image processing is done in your browser
  • No Server Uploads: Images never leave your device
  • No Data Collection: We don't track or store any information
  • No Registration Required: Use all features without signing up

🚀 Getting Started

Local Development

  1. Clone the repository:
git clone https://github.com/tinystacklab/image-cube.git
cd image-cube
  1. Install dependencies:
npm install
  1. Start development server:
npm run dev
  1. Open http://localhost:3000 in your browser

Build for Production

npm run build

The built files will be in the dist folder.

📦 Deployment

This is a static website that can be deployed to any static hosting platform.

Deploy to Cloudflare Pages

  1. Push your code to a GitHub repository
  2. Log in to Cloudflare Dashboard
  3. Go to PagesCreate a projectConnect to Git
  4. Configure build settings:
    • Build command: npm run build
    • Build output directory: dist
  5. Click Save and Deploy

Deploy to Vercel

  1. Push your code to GitHub
  2. Import project at Vercel
  3. Vercel will auto-detect Vite and configure accordingly
  4. Click Deploy

Deploy to Netlify

  1. Push your code to GitHub
  2. Import project at Netlify
  3. Configure build settings:
    • Build command: npm run build
    • Publish directory: dist
  4. Click Deploy site

Deploy to GitHub Pages

  1. Add to vite.config.js: base: '/your-repo-name/'
  2. Build the project: npm run build
  3. Deploy the dist folder to GitHub Pages

🛠️ Tech Stack

📝 License

MIT License - feel free to use this project for personal or commercial purposes.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📧 Contact

If you have any questions or suggestions, please open an issue on GitHub.


Made with ❤️ for privacy-conscious image processing

About

Image Cube - Image processing tool with compression, format conversion, and cropping.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published