🍭 Sugar Fast - Flutter Development Hub

Sugar Fast is a comprehensive meta-package that brings together the entire Sugar ecosystem for super-fast Flutter development. Instead of managing multiple dependencies, install once and get access to everything you need.

🎯 One Package, Everything Included

dependencies:
  sugar_fast: ^2.0.0  # Gets you EVERYTHING

import 'package:sugar_fast/sugar_fast.dart';  // One import for all Sugar features

void main() {
  SugarFast.initialize();
  runApp(MyApp());
}

🧩 What's Included

Package	Status	Description
🍰 Riverpod Sugar	✅ Available	Enhanced Riverpod utilities and helpers
🧩 Sugar UI	🚧 Coming Soon	Pre-built, customizable widgets
🔗 Sugar Connect	🚧 Coming Soon	HTTP/API utilities and networking
🎨 Sugar Themer	🚧 Coming Soon	Advanced theming and styling system
🍰 Sugar Slices	🚧 Coming Soon	Enhanced Riverpod state management

🚀 Quick Start

1. Install

flutter pub add sugar_fast

2. Initialize

import 'package:sugar_fast/sugar_fast.dart';
import 'package:flutter/foundation.dart';

void main() {
  SugarFast.initialize(
    devMode: kDebugMode,
  );
  runApp(MyApp());
}

3. Use Everything

class MyWidget extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    // Use Riverpod Sugar (currently available)
    final user = ref.watch(userProvider);
    
    // Coming soon: Use other Sugar packages
    // return SugarCard(child: ...);        // Sugar UI
    // return SugarTheme.dark(child: ...);  // Sugar Themer
    // ApiClient.get('/users');             // Sugar Connect
    
    return Text('Hello ${user.name}');
  }
}

🎛️ Individual Packages (Advanced Users)

Need fine-grained control? Install individual packages:

dependencies:
  riverpod_sugar: ^1.0.9     # State management only
  # sugar_ui: ^1.0.0         # UI components only (coming soon)
  # sugar_connect: ^1.0.0    # API utilities only (coming soon)
  # sugar_themer: ^1.0.0     # Theming only (coming soon)

📚 Documentation

• Riverpod Sugar Docs - Available now
• Sugar UI Docs - Coming soon
• Sugar Connect Docs - Coming soon
• Sugar Themer Docs - Coming soon

🗺️ Development Roadmap

Phase 1 - State Management ✅

• Riverpod Sugar integration
• Hub package structure
• Unified initialization

Phase 2 - UI Components 🚧

• Sugar UI package
• Pre-built widgets
• Customizable components

Phase 3 - Networking & APIs 🚧

• Sugar Connect package
• HTTP utilities
• API helpers

Phase 4 - Theming & Design 🚧

• Sugar Themer package
• Advanced theming system
• Design tokens

🌟 Why Use Sugar Fast?

Single Dependency

Instead of managing multiple packages, add one dependency and get access to the entire Sugar ecosystem.

Unified API

All Sugar packages work together seamlessly with consistent APIs and patterns.

Future-Proof

As new Sugar packages are released, they're automatically included in Sugar Fast updates.

Optional Granularity

Need fine control? You can still install individual packages separately.

📦 Package Details

Current Size

• Riverpod Sugar: Enhanced state management utilities

Coming Soon

• Sugar UI: Pre-built, customizable widgets for common use cases
• Sugar Connect: HTTP/API utilities with built-in error handling
• Sugar Themer: Advanced theming system with design tokens
• Sugar Slices: Enhanced Riverpod state management patterns

🤝 Contributing

We welcome contributions to the Sugar ecosystem! Each package has its own repository:

• sugar_fast (this hub): mukhbit0/sugar_fast
• riverpod_sugar: Contribute here
• More packages coming soon...

Contribution Guidelines

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

MIT License - see LICENSE for details.

🔗 Links

• Pub.dev Package
• GitHub Repository
• Issue Tracker
• Changelog

---

Built with ❤️ for the Flutter community
Making Flutter development faster, one package at a time.