Customization

Personalize your Aero mobile app experience with custom app icons, themes, and settings.

App icon customization

Aero for Android includes 12 different app icon designs you can choose from. Each icon maintains the Aero brand while offering unique visual styles.

App icon customization is currently Android-only. iOS support coming soon.

Available icons

Choose from 12 unique icon designs:

Default (Icon 1) - Classic Aero logo
Icon 2 - Alternative color scheme
Icon 3 - Minimalist design
Icon 4 - Gradient variant
Icon 5 - Dark theme
Icon 6 - Light theme
Icon 7 - Circular badge
Icon 8 - Square badge
Icon 9 - Rounded corners
Icon 10 - Modern flat
Icon 11 - Classic aviation
Icon 12 - Premium gold

All icons are stored in assets/logos/ and defined in the app manifest as activity aliases.

Changing your app icon

Customize your app icon from the Profile screen:

Open Profile

Tap the Profile tab in the bottom navigation bar.

Select App Icon

Tap “App Icon” in the profile menu to open the icon selector.

Choose an icon

Browse the grid of 12 available icons. Your current icon is highlighted with a checkmark.

Apply

Tap any icon to apply it. The app will show a loading indicator while changing the icon.

Confirm

A success message appears when the icon is changed. Return to your home screen to see the new icon.

How icon switching works

The app uses Android’s activity-alias system to switch icons without reinstalling:

<!-- AndroidManifest.xml -->
<activity-alias
    android:name="fyi.procrastinator.aero.DEFAULT"
    android:enabled="true"
    android:exported="true"
    android:icon="@mipmap/ic_launcher"
    android:label="Aero"
    android:targetActivity=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity-alias>

Each icon variant has its own activity-alias. When you select a new icon:

The app disables the current alias
Enables the new alias with the selected icon
Saves your selection to SharedPreferences
Shows a confirmation message

The implementation is in lib/screens/profile/app_icon/main.dart:

Future<void> _changeIcon(String iconId) async {
  final iconName = iconId == 'DEFAULT' ? "DEFAULT" : iconId;
  if (await FlutterDynamicIconPlus.supportsAlternateIcons) {
    final channel = MethodChannel(METHOD_CHANNEL);
    await channel.invokeMethod("changeAppIcon", {'iconId': iconName});
  }
  
  final prefs = await SharedPreferences.getInstance();
  await prefs.setString('selected_app_icon', iconId);
}

Icon persistence

Your icon selection is saved to SharedPreferences and persists across:

App restarts
Device reboots
App updates

The selected icon is restored when the app launches.

Platform support

Platform	Supported	Package Used
Android	✅ Yes	`flutter_dynamic_icon_plus`
iOS	❌ Coming soon	Planned

iOS support requires additional entitlements and will be added in a future update.

Theme customization

Aero currently uses a light theme with clean, minimal design.

Current theme

The app theme is defined in lib/main.dart:

Primary color: Black (#000000)
Background: White (#FFFFFF)
Accent: Blue (#2196F3)
Font: Geist for body text, CalSans for headings
Navigation bar: Light gray (#FAFAFA)
Material Design: Material 3

Typography

Two custom fonts are included: Geist (body text):

Clean, modern sans-serif
Used for all body text, labels, and descriptions
Loaded from assets/fonts/geist.ttf

CalSans (headings):

Bold, geometric display font
Used for titles, headers, and emphasis
Weight: 600 (semi-bold)
Loaded from assets/fonts/calsans.ttf

Fonts are defined in pubspec.yaml:

fonts:
  - family: Geist
    fonts:
      - asset: assets/fonts/geist.ttf
  - family: CalSans
    fonts:
      - asset: assets/fonts/calsans.ttf
        weight: 600

Color scheme

The app uses a consistent color palette:

Primary: Black for high contrast
Secondary: Blue accents for interactive elements
Success: Green for early flights and confirmations
Warning: Orange for diverted flights
Error: Red for delays and errors
Surface: Light gray for cards and elevated surfaces
Background: Pure white

Text colors:

Primary text: Black (#000000)
Secondary text: Gray (#757575) - defined in lib/constants/main.dart
Disabled: Light gray (#BDBDBD)

Dark mode

Dark mode is not yet implemented but is planned for a future release.

When dark mode is added, it will include:

OLED black backgrounds
Muted accent colors
Reduced eye strain at night
Automatic switching based on system settings

Profile settings

Customize your profile and app behavior from the Profile screen.

Access profile settings

Tap the Profile tab in bottom navigation
View your profile information:
- Avatar (generated from your name)
- Display name
- Email address

Available settings

Flight Stats

View your lifetime aviation statistics and records

Wear OS Devices

Manage connected Wear OS smartwatches

App Icon

Choose from 12 different app icon designs

Log Out

Sign out of your account

Profile avatar

Your profile displays a generated avatar based on your name:

CircleAvatar(
  radius: 50,
  backgroundColor: Colors.grey.shade200,
  backgroundImage: CachedNetworkImageProvider(
    "https://api.dicebear.com/9.x/initials/png?seed=${user?.name}",
  ),
)

The avatar uses DiceBear to generate initials-based images. No custom avatar upload yet.

Notification settings

Push notifications are planned for a future release.

Planned notification types:

Flight status changes: Delays, gate changes, cancellations
Departure reminders: Notifications before flight departure
Boarding alerts: When boarding begins
Gate changes: Real-time gate updates
Baggage claim: When baggage is ready

Notifications will be configurable per-flight and globally.

Data and privacy settings

Account management

From the Profile screen: Log Out: Sign out of your account. This:

Clears your authentication token
Removes locally cached flight data
Redirects to the login screen
Keeps widgets active until they expire

Account deletion (coming soon):

Delete your account and all associated data
Removes flight history, bookings, and statistics
Cannot be undone

Data storage

The app stores data locally in: SQLite database (sqflite):

Tracked flights
Flight search history
Cached flight information
User preferences

SharedPreferences:

Selected app icon
Authentication tokens
Widget data
App settings

Cache directory (path_provider):

Airline logos (via cached_network_image)
Map tiles (via flutter_map)
Generated flight cards

Clear cache

Manual cache clearing is not yet available in the UI.

To clear the cache:

Go to Android Settings → Apps → Aero → Storage
Tap “Clear cache” (keeps your data)
Or “Clear data” (resets the app completely)

Language and region

The app currently supports:

Language: English (en_US)
Time format: Respects device 12/24-hour preference
Date format: Local device format
Units: Displays both metric (km) and imperial (mi) for distances

Additional languages planned:

Spanish (es)
French (fr)
German (de)
Japanese (ja)
Chinese Simplified (zh_CN)

Accessibility settings

Accessibility features are limited in the current version.

The app supports:

System font scaling: Text respects Android font size settings
Screen readers: Basic TalkBack support
High contrast: Light theme provides good contrast ratios

Planned improvements:

Enhanced screen reader labels
Larger touch targets option
Reduced motion mode
Voice commands

Advanced settings

API configuration

For self-hosted deployments, you can change the backend URL by editing lib/constants/main.dart:

const String API_BASE_URL = 'https://your-backend.com';

Then rebuild the app:

flutter clean
flutter pub get  
flutter build apk --release

Debug mode

Enable debug features by building in debug mode:

flutter run --debug

Debug mode enables:

Performance overlay
Widget inspector
Console logging
Network traffic logging

The default widget update interval is 15 minutes. To change it, edit lib/main.dart:

await Workmanager().registerPeriodicTask(
  'widget-update',
  'widgetUpdateTask',
  frequency: const Duration(minutes: 15), // Change this
  constraints: Constraints(
    networkType: NetworkType.connected,
  ),
);

Shorter intervals increase battery usage and API calls. Android enforces a minimum of 15 minutes.

Resetting the app

To completely reset Aero:

Log out

Tap Profile → Log Out to sign out.

Clear app data

Go to Android Settings → Apps → Aero → Storage → Clear data.

Restart app

Open Aero and log in again or create a new account.

This removes:

Authentication tokens
Cached flights and statistics
Selected app icon (reverts to default)
Widget data
All local preferences

Your account data on the server remains intact.

Upcoming customization features

Planned for future releases:

Dark mode: OLED black theme with auto-switching
Custom color themes: Choose accent colors
Widget themes: Light and dark widget variants
Custom fonts: Select from multiple font options
Home screen layouts: Compact or detailed views
Gesture customization: Configure swipe actions
Sound effects: Optional UI sounds

Stay tuned for updates! See the Features documentation for core app functionality.

Getting Started

Mobile App

Wear OS

Backend

Development

Customization

App icon customization

Available icons

Changing your app icon

How icon switching works

Icon persistence

Platform support

Theme customization

Current theme

Typography

Color scheme

Dark mode

Profile settings

Access profile settings

Available settings

Flight Stats

Wear OS Devices

App Icon

Log Out

Profile avatar

Notification settings

Data and privacy settings

Account management

Data storage

Clear cache

Language and region

Accessibility settings

Advanced settings

API configuration

Debug mode

Widget update frequency

Resetting the app

Upcoming customization features

Build docs developers (and LLMs) love

Getting Started

Mobile App

Wear OS

Backend

Development

​App icon customization

​Available icons

​Changing your app icon

​How icon switching works

​Icon persistence

​Platform support

​Theme customization

​Current theme

​Typography

​Color scheme

​Dark mode

​Profile settings

​Access profile settings

​Available settings

Flight Stats

Wear OS Devices

App Icon

Log Out

​Profile avatar

​Notification settings

​Data and privacy settings

​Account management

​Data storage

​Clear cache

​Language and region

​Accessibility settings

​Advanced settings

​API configuration

​Debug mode

​Widget update frequency

​Resetting the app

​Upcoming customization features

Build docs developers (and LLMs) love

App icon customization

Available icons

Changing your app icon

How icon switching works

Icon persistence

Platform support

Theme customization

Current theme

Typography

Color scheme

Dark mode

Profile settings

Access profile settings

Available settings

Profile avatar

Notification settings

Data and privacy settings

Account management

Data storage

Clear cache

Language and region

Accessibility settings

Advanced settings

API configuration

Debug mode

Widget update frequency

Resetting the app

Upcoming customization features