Flutter App Metadata Skill

This skill guides updating application metadata (app name, bundle identifier, company info) across all platforms in this Flutter project.

When to Use

Trigger this skill when:

• Renaming the application
• Changing the bundle/application identifier
• Updating company name or copyright information
• Setting up a new project from this template
• User asks to "change app name", "update identifier", "rename app", or "change bundle id"

Quick Reference: All Files to Update

Detailed Platform Updates

1. Flutter (pubspec.yaml)

name: my_app_name          # Package name (snake_case)
description: My App Description

2. Android

build.gradle.kts

Location: android/app/build.gradle.kts

android {
    namespace = "com.example.myapp"        // Line ~19
    // ...
    defaultConfig {
        applicationId = "com.example.myapp" // Line ~33
    }
}

MainActivity.kt

Location: android/app/src/main/kotlin/<package>/MainActivity.kt

Important: The directory structure must match the package name!

package com.example.myapp  // Must match applicationId

import io.flutter.embedding.android.FlutterActivity

class MainActivity : FlutterActivity()

Directory rename required:

# Old: android/app/src/main/kotlin/dev/gsmlg/flutter_app_template/
# New: android/app/src/main/kotlin/com/example/myapp/

mkdir -p android/app/src/main/kotlin/com/example/myapp
mv android/app/src/main/kotlin/<old>/<package>/MainActivity.kt \
   android/app/src/main/kotlin/com/example/myapp/
rm -rf android/app/src/main/kotlin/<old>

Fastlane Appfile

Location: android/fastlane/Appfile

package_name("com.example.myapp")

3. iOS

Xcode Project

Location: ios/Runner.xcodeproj/project.pbxproj

Search and replace all occurrences of PRODUCT_BUNDLE_IDENTIFIER:

• Main app: com.example.myapp
• Tests: com.example.myapp.RunnerTests

6 occurrences total (Debug, Release, Profile for both Runner and RunnerTests)

Fastlane Files

Appfile (ios/fastlane/Appfile):

app_identifier("com.example.myapp")

Matchfile (ios/fastlane/Matchfile):

app_identifier(["com.example.myapp"])

Fastfile (ios/fastlane/Fastfile):

# In update_code_signing_settings:
bundle_identifier: "com.example.myapp",
profile_name: ENV["sigh_com.example.myapp_appstore_profile-name"] || "match AppStore com.example.myapp",

# In export_options provisioningProfiles:
"com.example.myapp" => ENV["sigh_com.example.myapp_appstore_profile-name"] || "match AppStore com.example.myapp"

4. macOS

AppInfo.xcconfig

Location: macos/Runner/Configs/AppInfo.xcconfig

PRODUCT_NAME = my_app_name
PRODUCT_BUNDLE_IDENTIFIER = com.example.myapp
PRODUCT_COPYRIGHT = Copyright © 2025 My Company. All rights reserved.

Xcode Project

Location: macos/Runner.xcodeproj/project.pbxproj

Search and replace PRODUCT_BUNDLE_IDENTIFIER:

• Tests: com.example.myapp.RunnerTests

3 occurrences (Debug, Release, Profile for RunnerTests)

5. Linux

Location: linux/CMakeLists.txt

set(BINARY_NAME "my_app_name")
set(APPLICATION_ID "com.example.myapp")

6. Windows

Location: windows/runner/Runner.rc

BEGIN
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904e4"
        BEGIN
            VALUE "CompanyName", "My Company" "\0"
            VALUE "FileDescription", "My App Name" "\0"
            VALUE "FileVersion", VERSION_AS_STRING "\0"
            VALUE "InternalName", "my_app_name" "\0"
            VALUE "LegalCopyright", "Copyright (C) 2025 My Company. All rights reserved." "\0"
            VALUE "OriginalFilename", "my_app_name.exe" "\0"
            VALUE "ProductName", "My App Name" "\0"
            VALUE "ProductVersion", VERSION_AS_STRING "\0"
        END
    END
END

Identifier Naming Conventions

Recommended: Use consistent lowercase with dots across all platforms:

• app.mycompany.myappname

Automated Rename Script

This project includes a setup script for initial renaming:

dart run bin/setup_project.dart my_new_project_name

Note: This script handles basic renaming but may not update all metadata fields. Use this skill for comprehensive updates.

Post-Update Checklist

After updating metadata:

1. Android: Clean and rebuild

   bashCopy

   cd android && ./gradlew clean
   flutter clean && flutter pub get
   

2. iOS: Reinstall pods and regenerate

   bashCopy

   cd ios && rm -rf Pods Podfile.lock && pod install
   

3. iOS/macOS Signing: If bundle ID changed, regenerate certificates

   bashCopy

   cd ios/fastlane && fastlane match nuke appstore  # Caution: removes existing
   cd ios/fastlane && fastlane sync_certificates
   

4. Verify Build:

   bashCopy

   flutter clean
   melos bootstrap
   flutter build apk --debug
   flutter build ios --debug --no-codesign
   flutter build macos --debug
   flutter build linux --debug
   flutter build windows --debug
   

Common Issues

Search Commands

Find all identifier references:

# Find old identifier pattern
grep -r "old\.identifier" --include="*.gradle*" --include="*.kt" --include="*.pbxproj" \
  --include="*.xcconfig" --include="*.rc" --include="*.cmake" --include="Appfile" \
  --include="Matchfile" --include="Fastfile" --include="pubspec.yaml" .

Example: Full Rename

Renaming from dev.gsmlg.flutterAppTemplate to app.mycompany.myapp:

# 1. Update pubspec.yaml name
# 2. Update Android (build.gradle.kts, MainActivity.kt + directory, Appfile)
# 3. Update iOS (project.pbxproj, Appfile, Matchfile, Fastfile)
# 4. Update macOS (AppInfo.xcconfig, project.pbxproj)
# 5. Update Linux (CMakeLists.txt)
# 6. Update Windows (Runner.rc)
# 7. Clean and rebuild all platforms