nit-helper

nit-helper — это кроссплатформенный CLI-инструмент на Dart, предназначенный для автоматизации сборки Flutter и Serverpod проектов.

Инструмент автоматически определяет нужные директории (*_flutter, *_server) и выполняет соответствующие команды, с учётом опционального использования fvm.

✨ Возможности

  • 📦 Автоматическая сборка Flutter-модулей
  • 🛠 Генерация кода и миграций для Serverpod
  • 🔁 Поддержка fvm (Flutter Version Management)
  • 🧠 Умная навигация по структуре проекта
  • 🔧 Команды объединены в единый CLI: nit-helper

🚀 Установка

dart pub global activate nit_helper

Убедитесь, что путь к глобальным утилитам Dart добавлен в PATH:

  • Linux/macOS:

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

  • Windows: Откройте Свойства системы → Дополнительные параметры → Переменные среды и добавьте

    %APPDATA%\Pub\Cache\bin

    в переменную Path.

🧪 Использование

🔨 build

Собирает Flutter-проект (ищет директорию, оканчивающуюся на _flutter, или работает в текущей, если она таковая).

nit-helper build

С использованием fvm:

nit-helper build --fvm

Выполняются команды:

  • dart run build_runner build
  • fluttergen

🖥 build-server

Генерирует код Serverpod и применяет миграции. Ищет директорию, оканчивающуюся на _server.

nit-helper build-server

Принудительное создание миграций:

nit-helper build-server --f

С использованием fvm:

nit-helper build-server --fvm

Выполняются команды:

  • serverpod generate
  • serverpod create-migration (или -f)
  • dart run bin/main.dart --role maintenance --apply-migrations

🔁 build-full

Комбинирует build и build-server:

nit-helper build-full

С опциями:

nit-helper build-full --fvm --f

🧰 Аргументы

Аргумент Команда Описание
--fvm все команды Выполнять через fvm exec
--f build-server, build-full Принудительно создать миграции

💡 Примеры

# Сборка Flutter с fvm
nit-helper build --fvm

# Сборка Serverpod с принудительной миграцией
nit-helper build-server --f

# Полная сборка проекта
nit-helper build-full --fvm --f

📂 Структура проекта

project_root/
├── my_app_flutter/
│   └── main.dart
├── my_app_server/
│   └── bin/main.dart

nit-helper сам определит, где *_flutter, где *_server, и выполнит команды.

📜 Лицензия

MIT License. © 2025 \ Maksim Levchenko

📫 Обратная связь

Сообщите об ошибках или предложениях: GitHub Issues

Libraries