Turbo Packages

A collection of focused Dart and Flutter packages for building robust applications — type-safe responses, MVVM state management, Firestore access, serialization, forms, observability, and AI prompting. Each package is published independently to pub.dev and validated at a 160/160 pana score.

Table of Contents

• Packages
• Getting Started
• Development
• Publishing
• Contributing
• License

Packages

Package	Platform	Description	pub.dev
turbo_response	Dart	Type-safe response wrapper for success/failure states with pattern matching and utility methods
turbo_mvvm	Flutter	Lightweight MVVM state management inspired by the Stacked package
turbo_notifiers	Flutter	Enhanced behaviour over Flutter's ValueNotifier
turbo_forms	Flutter	Type-safe form field configuration and validation for Flutter with ShadCN UI integration
turbo_firestore_api	Flutter	Clean, efficient, type-safe approach to dealing with Firestore data
turbo_serializable	Dart	Serialization abstraction with multi-format support (JSON, YAML, Markdown, XML)
turbolytics	Flutter	User-friendly way to implement logs, analytics, and crash reports
turbo_promptable	Dart	Object-Oriented Prompting framework for AI agent prompts, roles, workflows, and tools as type-safe Dart objects

Getting Started

Each package is standalone — add only the ones you need. Install from pub.dev:

dart pub add turbo_response
# or for a Flutter package
flutter pub add turbo_forms

Then import and use it:

import 'package:turbo_response/turbo_response.dart';

See each package's own README.md and example/ directory for usage details and API documentation.

Development

This is a Melos-managed monorepo. Requires the Dart SDK ^3.10.

Setup

# Install dependencies and bootstrap the workspace
dart pub get
melos bootstrap

Common Commands

Use either make (convenience wrappers) or melos directly:

# Using Make
make analyze      # Run static analysis
make format       # Format code
make test         # Run tests with coverage
make build        # Run build_runner
make pub-check    # Validate pub.dev readiness (160/160 pana)
make help         # Show all available commands

# Using Melos
melos analyze
melos format
melos test
melos build_runner
melos pub-check
melos pub-publish-dry-run

Publishing

• Run melos pub-check to validate a 160/160 pana score before publishing.
• Use melos pub-publish (or make pub-publish) to publish; see tool/pub_publish.sh.
• Each package maintains independent versioning following semantic versioning — update its CHANGELOG.md per release.
• Validation and publish scripts live in tool/.

Contributing

Contributions are welcome. See CONTRIBUTING.md for the development workflow, branch and commit conventions, and the checks a change must pass before merge.

Contributors

Thanks to everyone who has contributed to these packages:

License

Distributed under the MIT License. See the root LICENSE file, or the LICENSE file in each package directory, for details.