Framework guides

Flutter

Lunadeck supports building Flutter applications for Android. The Flutter SDK is automatically provisioned in the cloud build environment.

Getting started

Upload or connect your Flutter project
Lunadeck detects pubspec.yaml and identifies the project as Flutter
The build engine runs flutter build apk to produce the artifact

Requirements

Flutter 3.16 or later
A valid pubspec.yaml
Android configuration in android/app/build.gradle

Build configuration

Lunadeck supports the following Flutter build modes:

Mode	Command	Output
Debug	`flutter build apk --debug`	Debug APK
Release	`flutter build apk --release`	Release APK
App Bundle	`flutter build appbundle`	AAB for Play Store

You can select the build mode in your project settings or lunadeck.config.json:

{
  "framework": "flutter",
  "buildCommand": "flutter build appbundle --release"
}

Platform channels

If your Flutter app uses platform channels with native Android code (Kotlin/Java), ensure the native code compiles correctly with the Android SDK version used by Lunadeck.

Plugins

Flutter plugins with native dependencies are automatically resolved. If a plugin requires additional Android SDK components, specify them in your project configuration.