NeruShort - Video Downloader & Editor

#📱 Features

##Core Features

• Multi-Platform Support: YouTube, TikTok, Instagram, Reddit
• HD Quality Downloads: Up to 1080p video quality
• Watermark Removal: Clean videos without platform watermarks (Premium)
• Video Editing: Trim videos, add custom watermarks
• Background Downloads: Continue downloads in background
• Download Queue: Manage multiple downloads simultaneously

##Premium Features

• Unlimited downloads and edits
• Watermark removal
• HD quality access
• Ad-free experience
• Priority support

#🏗 Architecture

#🛠 Tech Stack

##Core Technologies

• Framework: Flutter 3.x
• Language: Dart
• State Management: Riverpod 2.x
• Backend: Supabase
• Local Storage: Hive + SharedPreferences
• Architecture: Clean Architecture

##Key Dependencies

• flutter_riverpod - State management
• supabase_flutter - Backend and authentication
• dio - HTTP client
• video_player - Video playback
• ffmpeg_kit_flutter - Video processing
• easy_localization - Internationalization
• auto_route - Navigation
• hive - Local database
• freezed - Code generation for immutable classes

#🚀 Getting Started

##Prerequisites

• Flutter SDK 3.8.1 or higher
• Dart SDK
• Android Studio / VS Code
• Git

##Installation

1. Clone the repository
   git clone https://github.com/nerustudio/nerushort.git
   cd nerushort
   

2. Install dependencies
   flutter pub get
   

3. Run code generation (when implemented in Phase 2)
   flutter packages pub run build_runner build
   

4. Run the app
   flutter run
   

##Testing

# Run all tests
flutter test

# Run analysis
flutter analyze

# Check dependencies
flutter pub deps

#📋 Development Phases

##✅ Phase 1: Project Foundation (Completed)

• Flutter project setup with Clean Architecture
• Core domain entities and business logic
• Error handling and validation system
• Network layer and utilities
• Basic UI and localization
• State management with Riverpod

##🔄 Phase 2: Authentication & User Management (Next)

• Supabase integration and configuration
• User authentication (login, register, password reset)
• User profile and preferences management
• Trial usage tracking and premium features
• Local user data caching

##📅 Phase 3: Core Download Functionality

• Platform integration (YouTube, TikTok, Instagram, Reddit)
• Video extraction and quality selection
• Download queue and progress tracking
• Background download service
• Local storage management

##📅 Phase 4: Advanced Features

• HD quality downloads
• Watermark removal functionality
• Video editing capabilities
• Premium feature gating
• Ad integration

##📅 Phase 5: Monetization & UI Polish

• In-app purchases and subscriptions
• Ad system integration
• UI/UX improvements
• Performance optimizations

#🎨 Design Principles

##KISS (Keep It Simple, Stupid)

• Simple, intuitive user interface
• Clear and straightforward user flows
• Minimal cognitive load
• Easy-to-understand code structure

##DRY (Don't Repeat Yourself)

• Reusable components and utilities
• Centralized configuration and constants
• Shared business logic in use cases
• Common error handling patterns

##OOP (Object-Oriented Programming)

• Clear class hierarchies and encapsulation
• Interface-based programming
• Dependency injection for testability
• Proper separation of concerns

#🌍 Localization

• English (en)
• Indonesian (id)

1. Create new JSON file in assets/localization/
2. Add translations for all keys
3. Update supportedLocales in main.dart

#🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat(scope): add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

##Commit Message Format

#📄 License

#📞 Support

• Documentation: Coming soon
• Issues: Report bugs and feature requests
• Email: Contact for support

#⭐ Acknowledgments

• Flutter team for the amazing framework
• Supabase for backend infrastructure
• Contributors and beta testers
• Open source community