Skip to content

Add docs on 'Create app flavors for Windows and Linux' - #13736

Open
sfshaza2 wants to merge 2 commits into
mainfrom
flavors-windows-linux
Open

Add docs on 'Create app flavors for Windows and Linux'#13736
sfshaza2 wants to merge 2 commits into
mainfrom
flavors-windows-linux

Conversation

@sfshaza2

Copy link
Copy Markdown
Contributor

Closes #13642

Adds documentation for setting up app flavors on Windows and Linux desktop platforms.

@sfshaza2
sfshaza2 requested a review from a team as a code owner August 17, 2026 22:58

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new documentation guide for setting up Flutter flavors on Windows and Linux desktop apps, along with updating existing docs and navigation links to reference it. Feedback on the new guide highlights a critical MDX syntax error with an unclosed <Tabs> tag, and suggests providing more concrete, actionable CMake and configuration examples for customizing application icons on both Windows and Linux.

Comment thread sites/docs/src/content/deployment/flavors-windows-linux.md Outdated
Comment on lines +356 to +357
1. Configure `windows/runner/Runner.rc` or your CMake target
to use `APP_ICON_NAME` for the application icon resource.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This step is currently very vague and does not explain how to configure Runner.rc or the CMake target to use APP_ICON_NAME. Since configuring resource files with dynamic CMake variables can be non-trivial for users, please provide a concrete example or a brief explanation of how to achieve this (for example, using configure_file in CMake to generate Runner.rc from a template).

Comment on lines +370 to +371
1. Update `linux/CMakeLists.txt` to install the correct `.desktop` file
and icon based on `FLUTTER_APP_FLAVOR`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Similar to the Windows icon customization step, this instruction is very high-level and does not provide a concrete CMake snippet showing how to conditionally install the .desktop file and icon. Providing a brief example would make this guide much more actionable and user-friendly.

@flutter-website-bot

flutter-website-bot commented Aug 17, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 76814d8):

https://flutter-docs-prod--docs-pr13736-flavors-windows-linux-xianrw9y.web.app

@sfshaza2

sfshaza2 commented Aug 17, 2026

Copy link
Copy Markdown
Contributor Author

@AngeloAvv, can you help with a review? The bot is suggesting a more detailed description and I could use some help.

@flutter-website-bot

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit 7656651):

https://flutter-dev-230821--www-pr13736-flavors-windows-linux-6b9jzi0s.web.app

@AngeloAvv

Copy link
Copy Markdown
Contributor

@sfshaza2 sure! I'll take a look in the upcoming days

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add docs on "Create app flavors for Windows and Linux".

3 participants