🚀 FIP CLI

An interactive command-line tool that bootstraps a new Flutter project and takes care of the repetitive first-day setup — app name, bundle ID, splash screen and launcher icons — in a single guided flow.

✨ What it does

fip ignite walks you through a short interactive wizard, then sets everything up in one go:

• Creates a fresh Flutter app with flutter create
• Sets the app display name and bundle ID across every platform (Android, iOS, macOS, Web, Windows)
• Generates a native splash screen in the background color you choose (via flutter_native_splash)
• Generates launcher icons from your logo (via flutter_launcher_icons)
• Adds a placeholder assets/logo/logo.png that you can swap for your own before the icons/splash are generated
• Checks your installed Flutter version and warns if it's older than recommended

ℹ️ FIP starts from the standard flutter create layout — it automates the setup and branding, it does not impose a custom folder architecture or add state-management/routing packages.

⚙️ Requirements

• Dart SDK >= 3.7.2
• Flutter SDK — 3.27.0 or newer recommended

📦 Installation

FIP isn't on pub.dev yet, so install it globally straight from the repository:

dart pub global activate --source git https://github.com/cKalens/fip-cli.git

If the fip command isn't found afterwards, add Dart's global bin directory to your PATH:

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

🚀 Usage

Run the generator from the directory where you want the new project to be created:

fip ignite

The wizard asks you, in order:

1. Application display name — e.g. Instagram (the project/folder name is derived from it)
2. Bundle ID — e.g. com.example.instagram (validated)
3. Add a splash screen? — optional
4. Use the same logo as the app icon? — only asked if you enabled the splash screen
5. Splash background color — hex, e.g. #6A1B9A; only asked if you enabled the splash screen
6. Open the logo folder to replace the placeholder? — optional; only asked if you enabled the splash screen

After showing a summary and asking for confirmation, FIP creates the project and runs the splash/icon generation.

Other commands:

fip help      # list available commands
fip version   # print the FIP CLI version

🛠️ Run from source

git clone https://github.com/cKalens/fip-cli.git
cd fip-cli
dart pub get
dart run bin/fip.dart ignite

🗺️ Roadmap

Planned ideas — not implemented yet:

• Publish to pub.dev for one-line installation
• Optional networking layer setup
• Optional local storage integration
• Interactive localization setup
• State management templates

🤝 Contributing

Contributions, issues and feature requests are welcome — feel free to open an issue or a pull request.

📝 License

Released under the MIT License.