Skip to main content

FAQs ❓

Below are the most common questions about Flutter Release X.

🔹 General Questions​

How does Flutter Release X work?​

Flutter Release X automates your app release process, handling builds, uploads, and sharing with just one command.

Can I use Flutter Release X for non-Flutter projects?​

Yes! Only the Advanced Pipeline feature is supported for non-Flutter projects like React, Node.js, or other technologies.

Is FRX completely free to use?​

Yes! FRX is 100% free and open-source, unlike traditional CI/CD platforms that charge for build minutes.

What build targets are supported?​

By default, FRX supports Android (.apk & .aab), but with the Advanced Pipeline, you can extend support to iOS, Web, Windows, Linux, and Mac.

How do I trigger a build?​

Once configured, simply run:

frx build

🔧 Troubleshooting Issues​

Why is my build failing?​

Possible reasons:

  1. Incorrect Flutter path – Ensure flutter_path is correctly set in config.yaml.
  2. Invalid API keys – Double-check GitHub, Google Drive, or Slack tokens.
  3. Missing dependencies – Run flutter pub get before building.

How do I fix "command not found" when running frx build?​

  • Ensure Dart’s bin directory is added to your system’s $PATH:

    export PATH="$HOME/.pub-cache/bin:$PATH"

☁️ Cloud Integration​

How to enable GitHub uploads?​

Follow Cloud Integration to set up GitHub releases.

Can I upload builds to Google Drive?​

Yes! Follow Cloud Integration to set up Google Drive uploads.

📱 QR Codes & Sharing​

How do I generate QR codes for my app?​

Ensure the following settings are enabled in config.yaml:

qr_code:
  enabled: true
  save_file: true
  show_in_command: true
  size: 256
  save_path: "./release-qr-code.png"

Yes! Enable Slack integration in your config:

upload_options:
  slack:
    enabled: true
    bot_user_oauth_token: YOUR_BOT_TOKEN
    default_channel_id: CXXXXXXXXX
    share_QR: true
    share_link: true

⚙️ Customization & Advanced Features​

Can I add custom commands or scripts?​

Yes! The Advanced Pipeline feature allows you to define custom steps like flutter test, node --version, or even external scripts.

How does FRX handle errors in the pipeline?​

By default, FRX stops on failure. However, you can define custom exit conditions:

customExitCondition: "error: specific error message"

How do I use a custom configuration file?​

Run:

frx build -c path/to/custom_config.yaml
info

This persists for future builds.

How do I create an Advanced Pipeline?​

Define your pipeline in config.yaml:

example:

pipeline_steps:
  - name: "Build APK"
    command: "flutter build apk --release"
    upload_output: true
    notify_slack: true

For full customization, check the Advanced Pipeline Guide.

🎯 Still Have Questions?​

If you didn’t find an answer here, feel free to:

  • Open an issue on GitHub.
  • Join the community discussions.
  • Contact us via Email or GitHub Discussions or Discord.

🔥 Star us on GitHub if you like FRX! ⭐ → GitHub Repo Happy Building! 🚀