arch_sherpa 0.3.0

CLI for architecture scaffolding and structure validation in Flutter projects.

arch_sherpa

Flutter Sherpa Suite — Professional Engineering Toolkit for Flutter Teams

The Flutter Sherpa Suite is a collection of focused, production-grade engineering tools for Dart and Flutter projects. Each Sherpa solves a distinct problem in the software lifecycle — from architecture and versioning to technical debt, migrations, and risk analysis.

arch_sherpa provides architecture scaffolding and structure validation for Flutter teams. It validates project shape and generated feature structure; it does not enforce CocoaPods as the only valid iOS/macOS setup.

Installation

dart pub global activate arch_sherpa

Quick Start

arch_sherpa init
arch_sherpa add feature auth
arch_sherpa doctor --strict
dart run arch_sherpa audit --format json --out reports/arch --project-root .

Commands

arch_sherpa init
arch_sherpa add feature <name>
arch_sherpa config
arch_sherpa config validate
arch_sherpa config check
arch_sherpa config migrate
arch_sherpa config deprecations
arch_sherpa check
arch_sherpa doctor
arch_sherpa audit

Suite report example:

dart run arch_sherpa audit --format json --out reports/arch --project-root .

Documentation

• Configuration Reference
• Troubleshooting
• Pub Score Playbook
• Legacy Architecture Docs

Darwin dependency managers

Flutter projects may use CocoaPods, Swift Package Manager, a mixed setup, no Darwin native dependency manager, or an unknown state depending on project type and Flutter/plugin support.

arch_sherpa audit performs lightweight structural detection only. It can report which Darwin dependency-manager metadata is present, or warn when a Flutter plugin declares iOS/macOS/darwin support without CocoaPods or Swift Package Manager metadata. Normal Flutter app native shells are not treated as invalid just because they lack Podfile or Package.swift metadata. Dependency readiness and Swift Package Manager migration risk analysis belong to dep_sherpa, not arch_sherpa.

Cross-package guidance:

• Use arch_sherpa to keep project architecture and structure consistent.
• Use dep_sherpa to inspect dependencies and Darwin SPM readiness.
• Use techdebt_sherpa to surface readiness gaps as migration debt.

Part of the Flutter Sherpa Suite

• arch_sherpa - Architectural validation and structure enforcement
• dep_sherpa - Dependency risk intelligence and observability
• semver_sherpa - Semantic versioning and changelog automation
• techdebt_sherpa - Technical debt observatory and hotspot detection

Support the Project

• Buy Me a Coffee: https://buymeacoffee.com/carlosfdev
• Patreon: https://patreon.com/CarlosF_dev

License

MIT. See LICENSE.