📱 Aethel Application

📋 Application Overview

Key Features

Technical Stack

🏗️ Application Architecture

Project Structure

aethel/
├── android/                    # Android platform code
│   ├── app/
│   │   ├── build.gradle.kts   # Build configuration
│   │   └── src/main/
│   │       └── AndroidManifest.xml
│   └── key.properties         # Signing keys (not in git)
├── ios/                       # iOS platform code
├── lib/                       # Flutter application code
│   ├── l10n/                  # Localization files
│   ├── main.dart              # App entry point
│   └── src/
│       ├── core/              # Core functionality
│       │   ├── theme/         # App theming
│       │   ├── localization/  # Language support
│       │   └── services/      # Core services
│       ├── features/          # Feature modules
│       │   ├── tasks/         # Task management
│       │   ├── premium/       # Subscription features
│       │   ├── ads/           # Advertisement
│       │   ├── settings/      # App settings
│       │   └── activity/      # Activity tracking
│       └── shared/            # Shared widgets
├── assets/                    # Application assets
│   └── icon/                  # App icons
├── pubspec.yaml              # Dependencies
└── flutter_launcher_icons.yaml

How the Application Works

1. Initialization Flow

1. main.dart - Entry point that initializes Flutter
2. Hive Database - Opens local storage for tasks and settings
3. Services - Initializes ads, notifications, and tracking
4. Splash Screen - Shows while loading (3 seconds minimum)
5. Dashboard - Main screen with task list

2. State Management (Riverpod)

3. Data Persistence

Uses Hive (NoSQL database) for local storage:

• Tasks Box - Stores all user tasks
• Settings Box - Stores preferences
• Activity Box - Stores usage statistics

⚙️ Application Configuration

class AppConfig {
  static const String appName = 'My App';
  static const String supportEmail = 'support@myapp.com';
  // ... Ads and Subscription IDs are also here!
}

1. Change Application Name (System)

1. Change Application Name

Step 1: Update pubspec.yaml

name: aethel  # Change this to your app name (lowercase, no spaces)
description: "Your app description here"

Step 2: Update Android Manifest

<application
    android:label="Your App Name"  <!-- Change this -->
    android:icon="@mipmap/ic_launcher">

Step 3: Update iOS Info.plist

<key>CFBundleName</key>
<string>Your App Name</string>

2. Change Package Name (Application ID)

Step 1: Update build.gradle.kts

android {
    namespace = "com.yourcompany.yourapp"  // Change this
    
    defaultConfig {
        applicationId = "com.yourcompany.yourapp"  // Change this
        minSdk = flutter.minSdkVersion
        targetSdk = 36
        versionCode = flutter.versionCode
        versionName = flutter.versionName
    }
}

Step 2: Update AndroidManifest.xml

No changes needed - it uses the applicationId from build.gradle

Step 3: Rename Package Directories

Step 4: Update MainActivity.kt

package com.yourcompany.yourapp  // Change this

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity() {
}

3. Change Application Version

Update pubspec.yaml

version: 1.0.1+4
# Format: MAJOR.MINOR.PATCH+BUILD_NUMBER
# Example: 2.0.0+5
# - 2.0.0 = Version shown to users
# - 5 = Build number (must increase for each upload)

💰 Google AdMob Configuration

Current Ad Implementation

The app uses Google Mobile Ads SDK 7.0.0 with:

• Banner Ads - Displayed on Dashboard and Drawer
• Interstitial Ads - Shown every 5 task completions
• Test Ads - Currently using Google's test ad units

Step 1: Create AdMob Account

1. Go to https://admob.google.com
2. Sign in with your Google account
3. Click "Get Started" and complete registration
4. Create a new app in AdMob console

Step 2: Get Your Ad Unit IDs

Step 3: Update AndroidManifest.xml

<!-- Replace with YOUR AdMob App ID -->
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY"/>

Step 4: Update Ad Unit IDs in Code

We have moved ad configuration to AppConfig for easier access.

class AppConfig {
  // Ads Configuration
  static const bool adsEnabled = true;

  // Android
  static const String adMobAppIdAndroid = 'ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY'; 
  static const String bannerAdUnitIdAndroid = 'ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY';
  static const String interstitialAdUnitIdAndroid = 'ca-app-pub-XXXXXXXXXXXXXXXX/AAAAAAAAAA';

  // iOS
  static const String adMobAppIdiOS = 'ca-app-pub-XXXXXXXXXXXXXXXX~ZZZZZZZZZZ';
  static const String bannerAdUnitIdiOS = 'ca-app-pub-XXXXXXXXXXXXXXXX/BBBBBBBBBB';
  static const String interstitialAdUnitIdiOS = 'ca-app-pub-XXXXXXXXXXXXXXXX/CCCCCCCCCC';
}

Step 5: Test Your Ads

Ad Display Logic

💎 In-App Subscriptions Setup

Current Subscription Plans

Step 1: Configure Google Play Console

1. Upload your app to Google Play Console (see Deployment section)
2. Go to Monetize → Products → Subscriptions
3. Click "Create subscription"

Step 2: Create Subscription Products

Step 3: Change Subscription Prices

To change prices:

1. Go to Google Play Console
2. Navigate to Monetize → Subscriptions
3. Select the subscription product
4. Click "Edit" on the price
5. Set new price and save
6. Changes take effect immediately

Step 4: Update Product IDs

Update the IDs to match your Google Play Console products:

class AppConfig {
  // Subscription Configuration
  static const String premiumMonthlyId = 'your_monthly_id';
  static const String premiumYearlyId = 'your_yearly_id';
}

Step 5: Link Payment Method with Google Play

Testing Subscriptions

🖼️ Changing Application Images

1. App Icon

Current Icon Location

Step 1: Prepare Your Icon

Step 2: Replace Icon File

1. Replace assets/icon/app_icon.png with your new icon
2. Keep the same filename or update flutter_launcher_icons.yaml

Step 3: Update flutter_launcher_icons.yaml

flutter_launcher_icons:
  android: true
  ios: true
  image_path: "assets/icon/app_icon.png"  # Your icon path
  adaptive_icon_background: "#ffffff"     # Background color
  adaptive_icon_foreground: "assets/icon/app_icon.png"

Step 4: Generate Icons

# Run this command in terminal
flutter pub get
flutter pub run flutter_launcher_icons

2. Splash Screen

The app uses a custom splash screen widget. To modify:

You can:

• Change background gradient colors
• Add a logo image
• Modify animation effects
• Change loading indicator style

3. Other Images in App

🔒 Privacy Policy

Using the Template

1. Open
   📁 privacy_policy_template.md
   in the project root.
2. Replace the placeholders:
   • [APP_NAME]
   • [DEVELOPER_NAME]
   • [SUPPORT_EMAIL]
   • [ADMOB_PUBLISHER_ID]
3. Export as PDF or host it on a website (e.g., GitHub Pages) to use as your Play Store Privacy Policy URL.

🚀 Deployment to Google Play Store

Prerequisites

• ✅ Google Play Developer Account ($25 one-time fee)
• ✅ App signing key (keystore file)
• ✅ All configurations completed
• ✅ App tested thoroughly

Step 1: Create Signing Key

Generate Keystore

# Run in terminal (Windows)
keytool -genkey -v -keystore d:\app\aethel\android\upload-keystore.jks ^
-storetype JKS -keyalg RSA -keysize 2048 -validity 10000 ^
-alias upload

# You'll be asked for:
# - Keystore password (remember this!)
# - Key password (can be same as keystore)
# - Your name, organization, etc.

Step 2: Configure Signing

Create key.properties

storePassword=your_keystore_password
keyPassword=your_key_password
keyAlias=upload
storeFile=upload-keystore.jks

Step 3: Build Release APK/AAB

Build App Bundle (Recommended)

# App Bundle is smaller and optimized for Google Play
flutter build appbundle --release

Build APK (Alternative)

# APK for direct distribution
flutter build apk --release

Step 4: Upload to Google Play Console

1. Create App:
   • Go to Google Play Console
   • Click "Create app"
   • Fill in app details (name, language, type)
2. Set Up App:
   • Complete all required sections in Dashboard
   • Privacy Policy URL (required)
   • App category and content rating
   • Target audience
3. Upload Release:
   • Go to Production → Releases
   • Click "Create new release"
   • Upload your .aab file
   • Add release notes
4. Store Listing:
   • Add app description (short & full)
   • Upload screenshots (minimum 2)
   • Add feature graphic (1024x500)
   • Upload app icon (512x512)
5. Submit for Review:
   • Review all sections
   • Click "Send for review"
   • Wait for approval (typically 1-3 days)

App Signing by Google Play

Update Existing App

1. Increase version number in pubspec.yaml
2. Build new release: flutter build appbundle --release
3. Go to Production → Releases
4. Create new release and upload .aab
5. Submit for review

🔧 Common Issues & Solutions

Build Errors

# Clean build
flutter clean
flutter pub get
flutter build appbundle --release

# Update Gradle wrapper
cd android
./gradlew wrapper --gradle-version=8.0

# Clear Gradle cache
./gradlew clean

# Rebuild
cd ..
flutter clean
flutter pub get
flutter build appbundle

Ad Issues

In-App Purchase Issues

Version Issues

# In pubspec.yaml, increase build number
version: 1.0.1+4  # Change to 1.0.1+5 or higher

Runtime Errors

flutter clean
flutter pub get
# Rebuild the app completely

Google Play Console Issues

🛠️ Required Tools & Software

Essential Development Tools

Installation Guide

1. Install Flutter

1. Download Flutter SDK from flutter.dev
2. Extract to C:\src\flutter (Windows)
3. Add to PATH: C:\src\flutter\bin
4. Verify installation:

   flutter doctor

2. Install Android Studio

1. Download from developer.android.com
2. Install with default settings
3. Open Android Studio
4. Install Android SDK (API 36 recommended)
5. Install Flutter and Dart plugins

3. Setup Android SDK

1. Open Android Studio → Settings → Appearance & Behavior → System Settings → Android SDK
2. Install:
   • Android SDK Platform 36
   • Android SDK Build-Tools
   • Android SDK Command-line Tools
3. Accept licenses:

   flutter doctor --android-licenses

4. Verify Setup

flutter doctor -v

# Should show:
# ✓ Flutter (Channel stable, 3.x.x)
# ✓ Android toolchain
# ✓ Android Studio
# ✓ Connected device

VS Code Extensions (Optional)

• Flutter - Official Flutter extension
• Dart - Dart language support
• Flutter Widget Snippets - Code snippets
• Pubspec Assist - Dependency management

Useful Commands

Online Resources