NonStop

Digital Product Development Experts for Startups & Enterprises

About | Website

🚀 NonStop CLI

⚡ Supercharge your Flutter development with mono-repo magic

🎯 What is NonStop CLI?

The NonStop CLI simplifies Flutter project setup and management, with a focus on mono-repository structures using Melos. It provides standardized templates, validation tools for your development environment, and ongoing updates for the best experience.

🎨 Perfect for teams who want consistent project structure and streamlined development workflows

🚀 Quick Start

# Install NonStop CLI globally
dart pub global activate nonstop_cli

# Check your development environment
nonstop doctor

# Create your first mono-repo project
nonstop create my_awesome_app

# Navigate and start coding!
cd my_awesome_app

📖 Commands

🏗️ create - Project Generator

Creates a new Flutter project based on predefined templates.

nonstop create <project-name> [arguments]

🔧 Arguments

📦 Template Options

💡 Examples

🧩 Modules

mono does not stop at empty folders. It asks which platform modules the app needs and generates them wired together - bootstrap order, DI registration, route table and all.

? Which modules should youtube start with?
❯ ◉  Network          - Dio client, auth + logging interceptors, typed errors
  ◉  Authentication   - Firebase Auth (email, Google, Apple) with route guards
  ◯  Cloud Firestore  - Firestore + Cloud Functions wiring and timestamp converters
  ◉  Push notifications
  ◉  Analytics
  ◉  Crash reporting
  ◉  Feature flags
  ◉  Developer tools
  ◉  Dashboard shell

Answer non-interactively with -y (recommended set) or per module:

nonstop create youtube -y --no-notifications --firestore

Two rules are applied for you, because the code will not compile otherwise: push notifications pull in network, and developer tools pull in feature_flags.

Every project also gets core, di, design_system, localization and utils - the pieces every app needs.

nonstop create youtube

youtube/
├── 📱 apps/
│   └── youtube/          # bootstrap, router, splash - no business logic
├── 🧩 features/
│   ├── auth/             # Firebase Auth + route guards
│   └── dashboard/        # bottom-navigation shell
├── 📦 packages/
│   ├── core/             # logger, DI bootstrap, observers, error types
│   ├── design_system/    # Material 3 theme, components, toasts
│   ├── di/               # service locator
│   ├── localization/     # type-safe strings (i69n)
│   ├── network/          # Dio client and interceptors
│   ├── analytics/
│   ├── crashlytics/
│   ├── feature_flags/
│   ├── notifications/
│   ├── developer/
│   └── utils/
├── 🔌 plugins/
├── 📋 analysis_options.yaml
├── 📖 README.md
├── ⚙️ melos.yaml
└── 📄 pubspec.yaml

nonstop create core --template package

nonstop create youtube_studio --template app -o ./apps

nonstop create youtube_music --org-name com.youtube

nonstop create youtube -o ./projects

🩺 doctor - Environment Checker

Checks your development environment to ensure all required tools are installed and configured correctly.

nonstop doctor

🔍 What it checks:

📊 Status Indicators:

• ✅ Success: Tool is installed and working properly
• ⚠️ Partial: Tool is installed but has issues
• ❌ Missing: Tool is not installed or not found

🔄 update - Stay Current

Updates the NonStop CLI to the latest version automatically.

nonstop update

🚀 What it does:

1. 🔍 Checks the current installed version
2. 🌐 Compares with the latest version on pub.flutter-io.cn
3. ⬆️ Updates to the latest version if needed

🔄 Common Workflows

🚀 Setting up a new Flutter project with mono-repo

# 1️⃣ Check if your environment is properly set up
nonstop doctor

# 2️⃣ Create a new Flutter project with mono-repo structure
nonstop create youtube

# 3️⃣ Navigate to the project directory
cd youtube

# 🎉 You're ready to code!

📦 Adding a new package to an existing mono-repo

# 1️⃣ Navigate to your mono-repo root
cd youtube/packages

# 2️⃣ Create a new package
nonstop create core --template package

# 3️⃣ Update dependencies
melos bootstrap

📱 Adding a new app to an existing mono-repo

# 1️⃣ Create a new app in the apps directory
nonstop create youtube_studio --template app -o ./apps

# 2️⃣ Update dependencies
melos bootstrap

🛠️ Troubleshooting

❌ CLI not found after installation

Ensure the Dart SDK bin directory is in your PATH. Follow the instructions at: 📖 Running a script from your PATH

⚠️ Doctor command shows issues

If the doctor command shows issues with your development environment:

1. 🐦 Ensure Flutter is installed correctly: Flutter Installation
2. 🎯 Verify your Dart SDK installation: dart --version
3. 🔧 Install Melos if missing: dart pub global activate melos

🚫 Template generation fails

If template generation fails:

1. 🔐 Ensure you have proper permissions in the target directory
2. ✅ Check if the project name is valid (should follow Dart package naming rules)
3. 🔍 Run with the --verbose flag to see detailed logs: nonstop create my_project --verbose

⚙️ Global Options

🔗 Command Aliases

nonstop create my_app    # Full command
ns create my_app         # Short alias
nsio create my_app       # Alternative alias

🔗 Connect with NonStop

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.