Skip to content
Back to search

flutter

SkillWorks with Gemini CLIGitHub

Flutter extension for Gemini CLI

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gemini-cli-extensions--flutter/badge.svg)](/listings/gemini-cli-extensions--flutter)

HTML

<a href="/listings/gemini-cli-extensions--flutter"><img src="/api/listings/gemini-cli-extensions--flutter/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install from GitHub

Use the `gemini extensions install` terminal command to install directly from the source repository:

gemini extensions install https://github.com/gemini-cli-extensions/flutter.git --auto-update

The `--auto-update` is optional: if specified, it will update to new versions as they are released.

You can manage the extension with the following commands:

- Update to the latest version.

  gemini extensions update flutter

- Uninstall the extension.

  gemini extensions uninstall flutter

**Note for Windows users:** There is currently a [known issue](https://github.com/google-gemini/gemini-cli/issues/10616) with installing extensions on Gemini CLI for Windows. The workaround is as follows:

1. Follow instructions above to attempt to install the plugin (this will fail).

       gemini extensions install https://github.com/gemini-cli-extensions/flutter.git

2. In the command line, navigate to the folder in the home user's path where the code was downloaded (USER is the user's username)

       cd %TEMP%

3. Locate the folder for the downloaded extension. It will be the latest titled `gemini-extension<hash>` where `<hash>` is a 6 character string. Change into this directory.

       cd gemini-extension123456

4. There should be a zip file in this folder called "win32.flutter.zip". Unpack this file using `tar` (available in modern Windows versions) or by right-clicking it in File Explorer and selecting "Extract All...".

       tar xvf win32.flutter.zip

5. Use the path flag to gemini installation

       gemini extensions install --path %TEMP%\gemini-extension123456

2. Available Commands

The new commands will be available in new Gemini CLI sessions. The following commands will be available (with or without the `flutter:` prefix):

- `/create-app` - Guides you through bootstrapping a new Flutter project with best practices. - `/create-package` - Guides you through bootstrapping a new Dart package with best practices. - `/modify` - Manages a structured modification session with automated planning. - `/commit` - Automates pre-commit checks and generates a descriptive commit message.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 194 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Flutter extension for Gemini CLI
  2. Help Gemini CLI create, build, test, and run Flutter apps.
  3. - **Status: Experimental** - This is an experimental project. Features and commands may change drastically. We welcome your feedback!
  4. ## ✨ Features
  5. - **🚀 Project Bootstrapping**: Create new Flutter projects from scratch with built-in best practices, including linters, documentation, and design planning.
  6. - **🔧 Guided Modifications**: Execute complex modification tasks with automated planning, git branch management, and step-by-step implementation guides for your approval.
  7. - **✅ Automated Pre-Commit Checks**: Automatically format, analyze, and test your code before committing to maintain codebase quality.
  8. - **✍️ Smart Commit Messaging**: Generate descriptive, conventional commit messages based on your staged changes.
  9. - **🧠 Context Priming**: Initializes Gemini with specific rules and context for Dart and Flutter, ensuring high-quality, idiomatic code generation.
  10. ## 📋 Prerequisites
  11. 1. **Gemini CLI 0.4.0+** installed and configured.
  12. 2. **Flutter & Dart SDK** installed on your system.
  13. 3. **Git** installed and available in your PATH.
  14. ## 🚀 Installation
  15. ### 1. Install from GitHub
  16. Use the `gemini extensions install` terminal command to install directly from the source repository:
  17. ```bash
  18. gemini extensions install https://github.com/gemini-cli-extensions/flutter.git --auto-update
  19. ```
  20. The `--auto-update` is optional: if specified, it will update to new versions as they are released.
  21. You can manage the extension with the following commands:
  22. - Update to the latest version.
  23. ```bash
  24. gemini extensions update flutter
  25. ```
  26. - Uninstall the extension.
  27. ```bash
  28. gemini extensions uninstall flutter
  29. ```
  30. **Note for Windows users:** There is currently a [known issue](https://github.com/google-gemini/gemini-cli/issues/10616) with installing extensions on Gemini CLI for Windows. The workaround is as follows:
  31. 1. Follow instructions above to attempt to install the plugin (this will fail).
  32. ```bash
  33. gemini extensions install https://github.com/gemini-cli-extensions/flutter.git
  34. ```
  35. 2. In the command line, navigate to the folder in the home user's path where the code was downloaded (USER is the user's username)
  36. ```bash
  37. cd %TEMP%
  38. ```
  39. 3. Locate the folder for the downloaded extension. It will be the latest titled `gemini-extension<hash>` where `<hash>` is a 6 character string. Change into this directory.
  40. ```bash
  41. cd gemini-extension123456
  42. ```
  43. 4. There should be a zip file in this folder called "win32.flutter.zip". Unpack this file using `tar` (available in modern Windows versions) or by right-clicking it in File Explorer and selecting "Extract All...".
  44. ```bash
  45. tar xvf win32.flutter.zip
  46. ```
  47. 5. Use the path flag to gemini installation
  48. ```bash
  49. gemini extensions install --path %TEMP%\gemini-extension123456
  50. ```
  51. ### 2. Available Commands
  52. The new commands will be available in new Gemini CLI sessions. The following commands will be available (with or without the `flutter:` prefix):
  53. - `/create-app` - Guides you through bootstrapping a new Flutter project with best practices.
  54. - `/create-package` - Guides you through bootstrapping a new Dart package with best practices.
  55. - `/modify` - Manages a structured modification session with automated planning.
  56. - `/commit` - Automates pre-commit checks and generates a descriptive commit message.
  57. ## 💡 Usage
  58. This extension provides powerful commands to automate key phases of the development lifecycle.
  59. ### `/create-app`
  60. Initiates a guided process to bootstrap a new Flutter application, ensuring your project starts with a solid foundation.
  61. **Process:**
  62. 1. Asks for the package's purpose, details, and desired location on your filesystem.
  63. 2. Creates a new Flutter project with recommended settings and linter rules.
  64. 3. Generates starter `pubspec.yaml`, `README.md`, and `CHANGELOG.md` files.
  65. 4. Produces a `DESIGN.md` and `IMPLEMENTATION.md` for your review and approval before any code is written.
  66. ```bash
  67. /create-app I want to create a trip planning app
  68. ```
  69. ### `/modify`
  70. Starts a structured session to modify existing code. It helps you plan and execute changes safely and efficiently.
  71. **Process:**
  72. 1. Asks for your high-level modification goals and what you want to accomplish.
  73. 2. Offers to create a new `git` branch for the modification work, isolating changes.
  74. 3. Generates a `MODIFICATION_DESIGN.md` design document detailing the proposed changes.
  75. 4. Creates a phased `MODIFICATION_IMPLEMENTATION.md` plan for your review and approval.
  76. ```bash
  77. /modify
  78. ```
  79. ### `/commit`
  80. Prepares your staged `git` changes for a clean, high-quality commit. It acts as an automated pre-commit hook and message generator.
  81. **Process:**
  82. 1. Runs `dart fix` and `dart format` to clean and format your code.
  83. 2. Executes the Dart analyzer to check for static analysis issues.
  84. 3. Runs your project's test suite to ensure all tests are passing.
  85. 4. Generates a descriptive commit message based on the staged changes for you to review, edit, and approve.
  86. ```bash
  87. /commit
  88. ```
  89. ## ⚙️ Coding Guidelines
  90. This extension enforces a specific set of coding standards to ensure consistency and quality. These rules are defined in the extension's repository:
  91. - **`flutter.md`**: Contains rules and best practices for writing Dart and Flutter code. These rules are opinionated, and we encourage you to review them to ensure they align with your style.
  92. ## Connecting to a running app
  93. You can connect to an app by providing the Flutter extension with the URL for
  94. the Dart Tooling Daemon:
  95. 1. **Run the app**: in VSCode on a target device (iOS, Android, macOS, or web)
  96. 2. **Execute the Copy DTD Uri action**: Open the VSCode Command Runner
  97. (Cmd+Shift+P, or Ctrl+Shift+P) and type "Copy DTD Uri to Clipboard" to copy the
  98. DTD URL to your clipboard
  99. 3. **Paste the URL into Gemini CLI**: Enter a prompt like "Connect to the
  100. Flutter app with this DTD URL: " and paste the URL from your clipboard. You
  101. should see a "Connection succeeded" message from the
  102. connect_dart_tooling_daemon MCP tool.
  103. Alternatively, you can run from the command line with the `--print-dtd` flag:
  104. ```bash
  105. $ flutter run --print-dtd
  106. ...
  107. The Dart Tooling Daemon is available at: ws://127.0.0.1:52636/M3G9d1Q3hFk=
  108. ```
  109. To learn more about the Dart and Flutter MCP server, see the
  110. [Dart and Flutter MCP server](https://dart.dev/tools/mcp-server)
  111. page on dart.dev or the
  112. [dart_mcp_server README](https://github.com/dart-lang/ai/tree/main/pkgs/dart_mcp_server).
  113. ## Known issues
  114. - Running a Flutter app from within Gemini CLI and then triggering a Hot Reload
  115. does not work in Flutter stable <= 3.37.0.
  116. Tracking issue: [gemini-cli-extensions/flutter#15](https://github.com/gemini-cli-extensions/flutter/issues/15)
  117. ## 🐛 Troubleshooting
  118. ### Common Issues
  119. 1. **"Command not recognized"**: Ensure the extension is installed correctly and you have restarted the Gemini CLI. Verify the installation with `gemini extensions list`.
  120. 2. **"Gemini CLI version error"**: This extension requires Gemini CLI version 0.4.0 or greater. Check your version with `gemini --version` and update if necessary.
  121. 3. **"[WARN] Skipping extension MCP config for server with key "dart" as it already exists."**:
  122. This warning appears if you have manually configured the Dart MCP server in your `.gemini/settings.json` file.
  123. Since this extension manages the Dart MCP server, you can safely remove your manual configuration to resolve the warning.
  124. ### Filing Issues
  125. If you have feedback, suggestions, or run into issues, please [file an issue on GitHub](https://github.com/gemini-cli-extensions/flutter/issues/new/choose).
  126. ## 🤝 Contributing
  127. Contributions are welcome! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) guide for more details on how to get started.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.