Skip to content

Troubleshooting ​

fks: command not found ​

The installer puts fks in ~/.local/bin. Add it to your PATH:

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # or ~/.bashrc
source ~/.zshrc

On Windows, open a new terminal. The installer added fks to your user PATH.

My agent doesn't know the skill ​

  • Start a new agent session. Skills load when a session starts.
  • Check the skill is linked: ls ~/.claude/skills/flutter-kickstart (or your agent's folder from Installation).
  • If your agent ignores symlinks, reinstall with copies: ~/.flutter-kickstart/install.sh --copy.

Generation stopped with an error ​

The generator stops at the first failing step and prints why. Common causes:

SymptomFix
pub get failsCheck your network or proxy, then re-run
very_good not foundRun dart pub global activate very_good_cli, and make sure ~/.pub-cache/bin is on your PATH
Wrong Flutter versionPin one with fvm, or upgrade Flutter

After fixing the cause, reuse the project that was already created:

bash
fks create <same flags> --skip-create

fks run says there's no lib/main_<flavor>.dart ​

Run it from the app's root folder. The error lists the flavors that exist.

Android/iOS workflows fail in CI ​

That is expected until you add signing keys and secrets. pr_checks works right away. Follow docs/deployment-setup.md in your app, or see CI/CD and releases.

Coverage check fails on a pull request ​

Add tests for the code you changed, then run ./scripts/quality_gate.sh locally. Generated files (*.g.dart, l10n output, flavor entrypoints) don't count toward coverage.

Still stuck? ​

Open an issue with the output of fks doctor and the command you ran.

Released under the MIT License.