sheeroo/ruko

📱 Ruko

Clean your camera roll in an oddly fun way 🎯

Transform the tedious task of cleaning your camera roll into an addictive, swipe-based experience

🎥 Demo • ✨ Features • 📲 Download • 🚀 Getting Started • 🤝 Contributing

---

🎯 What is Ruko?

Ruko helps you clean your camera roll. Inspired by the familiar swipe mechanics of dating apps, Ruko makes decluttering your camera roll surprisingly addictive. Swipe right to keep, swipe left to delete – it's that simple, yet oddly satisfying.

---

✨ Features {#features}

🎭 Multiple Cleanup Modes

Mode	Description	Perfect For
🎲 Shuffle	Random photo order	Breaking decision paralysis
📅 By Month	Chronologically grouped	Cleaning up specific time periods
📍 By Location	Geographically clustered	Removing photos from unwanted places
📱 Screenshots	System screenshots only	Quick cleanup of temporary saves

🎮 Intuitive Gestures

• 👈 Swipe Left: Delete photo/video
• 👉 Swipe Right: Keep photo/video
• 🔍 Tap: View full-screen with metadata

🎯 Smart Features

• 🔄 Undo Support: Accidentally deleted? No problem!
• 🔗 Share: Found a gem memory? easily share it with your friends

---

📱 Download {#download}

App Stores

• 📱 iOS: Download from App Store
• 🤖 Android: (Coming Soon)

---

🎥 Demo {#demo}

🚀 Getting Started {#getting-started}

Prerequisites

• Flutter: >=3.32.0
• Dart: >=3.7.0

🛠️ Installation

1. Clone the repository

   git clone https://github.com/sheeroo/ruko
   cd ruko
   

2. Install dependencies

   flutter pub get
   

3. Set up platform-specific configurations

   iOS:

   cd ios && pod install && cd ..
   

4. Run the app

   flutter run
   

🔧 Build for Release

# Android
flutter build apk --release
flutter build appbundle --release

# iOS
flutter build ios --release

🤝 Contributing {#contributing}

🎯 Areas We Need Help With

• 🌍 Localization: Help translate Ruko into your language
• 🎨 UI/UX: Improve the user experience and design
• 🧪 Testing: Write tests
• 📱 Platform Features: iOS/Android specific enhancements
• 🐛 Bug Fixes: Squash bugs and improve stability

---

📄 License

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

MIT License

Copyright (c) 2025 Ruko Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
...

---

📊 Project Stats

---