App Setup & Running

This guide covers the technical requirements and steps to get TaskNova running on your development machine and devices.

---

Technical Requirements

Ensure you have the following installed before starting:

• Flutter SDK: Version 3.19.0 or higher.
• Dart SDK: Automatically included with Flutter.
• IDE: Visual Studio Code (recommended) or Android Studio.
• Native Tools:
  • Android: Android SDK and JDK.
  • iOS: macOS with the latest Xcode.

---

Setup Instructions

1. Install Dependencies

Open your project in the terminal and run:

flutter pub get

2. Generate Database Adapters

TaskNova uses Hive for its local database. You must generate the type-safe adapters:

flutter pub run build_runner build --delete-conflicting-outputs

3. Configure Gemini AI

TaskNova's AI features require a Google Gemini API key.

1. Get your key from Google AI Studio.
2. Open lib/core/config/app_config.dart.
3. Update the key:

   static const String geminiApiKey = 'YOUR_API_KEY_HERE';

---

Running the App

Platforms

• Android: Connect a device or start an emulator and run flutter run.
• iOS: Open ios/Runner.xcworkspace in Xcode, select a device, and run.
• Web: Run flutter run -d chrome.

---

Deployment & Release

Android (APK & App Bundle)

1. Keystore: Generate a signing key if you haven't already.
2. Build:
   • Universal APK: flutter build apk --release
   • Play Store Bundle: flutter build appbundle --release

iOS

1. Xcode: Open the project in Xcode and configure your Signing & Capabilities (Team and Bundle ID).
2. Build:

   flutter build ios --release

Change Package Name

To customize the app identity, update the package name (e.g., com.yourcompany.yourapp):

1. Shortcut: Use the utility package:

   flutter pub run change_app_package_name:main com.new.package.name

2. Manual: Update applicationId in android/app/build.gradle and the Bundle ID in Xcode.

WARNING

Always change the package name BEFORE uploading to the stores.