Qzox Scanner is a high-end, feature-rich document management solution built with Flutter. It stands out for its unique Neumorphic (Soft UI) design, providing a modern, premium experience that users love. Whether it's scanning documents, extracting text via OCR, or managing PDFs with advanced tools like Merge, Split, and Password Protection, Qzox Scanner handles it all with ease.

✨ Key Features

• Unique Neumorphic UI: Stunning futuristic and soft-UI visual experience.
• Advanced OCR: Extract text from any image or document with high accuracy.
• Digital Signature: Create, save, and add professional signatures to your PDFs.
• Complete PDF Tools: Merge multiple PDFs, Split, Compress, and Password Protect.
• Smart Trash Recovery: Built-in recycle bin to recover accidentally deleted files.
• Document Expiry Reminders: Never miss a renewal date for your ID cards or insurance.

📸 App Preview

💼 Business & Revenue

• AdMob Mediation Ready: Maximize your earnings with top ad networks.
• In-App Subscriptions (IAP): Sell premium features and monthly/yearly plans easily.
• Clean Source Code: Organized Flutter code, easy to customize and rebrand.

Qzox Scanner is a high-end, feature-rich document management solution built with Flutter. It stands out for its unique Neumorphic (Soft UI) design, providing a modern, premium experience. Whether it's scanning, OCR, or PDF management, Qzox handles it all with ease.

🛠 Technical Requirements

To run and customize this project, you will need:

🛠 Step 1: Prerequisites

Before initializing the project, ensure your development environment is ready:

• Flutter SDK: Latest Stable Version (Ensure flutter doctor is all green).
• IDE: VS Code (Recommended) or Android Studio with Flutter/Dart plugins.
• JDK: Java Development Kit 17 or higher.
• CocoaPods: Required for iOS development (macOS only).

🚀 Step 2: Project Initialization

1. Extract: Extract the source code ZIP to a clean directory.
2. Open IDE: Launch your IDE and open the project folder.
3. Fetch Dependencies: Open your terminal and run:
   flutter pub get
4. Generate Database Adapters: This app uses Hive for ultra-fast local storage. Run:
   flutter pub run build_runner build --delete-conflicting-outputs

📦 Step 3: Package Name Refactoring (IMPORTANT)

To publish the app, you MUST change the package name (com.qzox.scanner).

🛠 How to fix it (Automatic Method):
We recommend using the rename_app package for a one-click rename:

1. Update the pubspec.yaml project name (optional).
2. Run: flutter pub run rename_app:main com.yourcompany.yourapp

⚠️ Manual Refactoring of Imports:
When you change the project name in pubspec.yaml, internal imports will break. Fix it by:

• Open IDE's "Global Search & Replace" (Ctrl+Shift+H).
• Search for: package:qzox1/ | Replace with: package:your_new_project_name/

🔥 Step 4: Firebase Configuration

1. Console: Create a new project in the Firebase Console.
2. Register Apps: Add both Android and iOS apps using your new package name.
3. Config Files:
   • Android: Place google-services.json in android/app/.
   • iOS: Place GoogleService-Info.plist in ios/Runner/.
4. Enable Features: Enable Authentication and Crashlytics in the console.

💰 Step 5: Monetization (AdMob Setup)

1. AdMob Console: Register a new app and generate Banner ID and Interstitial ID.
2. Update Config: Open lib/services/ad_service.dart and replace placeholder IDs.
3. Native Update:
   • Android: Update APPLICATION_ID in AndroidManifest.xml.
   • iOS: Update GADApplicationIdentifier in Info.plist.

🎨 Step 6: Branding & Assets

• App Name: Update android:label in Manifest and CFBundleDisplayName in Info.plist.
• App Icon: Place logo (1024x1024px) in assets/logo/logo.png and run:
  flutter pub run flutter_launcher_icons:main
• Splash Screen: Update colors in lib/theme/app_theme.dart.

🏗 Step 7: Build & Deployment

Debugging: flutter run

Production Release (Android):
flutter build apk --release OR flutter build appbundle --release

Developed with ❤️ for professional document management.