12 |
13 | Congrats on your interest in **Solid**! Let's make Flutter development even more enjoyable.
14 |
15 | Solid is a tiny framework built on top of Flutter that makes building apps easier and more enjoyable.
16 | The benefits of using Solid include:
17 | 1. **Don't write boilerplate**: Solid generates boilerplate code for you, so you can focus on building your app. Inspired by SwiftUI.
18 | 2. **No state management/dependency injection manual work**: Solid has built-in state management and dependency injection. Just annotate your variables and Solid takes care of the rest.
19 | 3. **Fine-grained reactivity**: Solid's reactivity system is inspired by SolidJS, allowing for efficient and fine-grained updates to your UI. Only the parts of the UI that depend on changed state are updated, leading to better performance. And the best is that you don't have to think about it, Solid does it for you automatically.
20 |
21 | ## Example
22 |
23 | You write this code, without any boilerplate and manual state management:
24 |
25 | ```dart
26 | import 'package:flutter/material.dart';
27 | import 'package:solid_annotations/solid_annotations.dart';
28 |
29 | class Counter extends StatelessWidget {
30 | Counter({super.key});
31 |
32 | @SolidState()
33 | int counter = 0;
34 |
35 | @override
36 | Widget build(BuildContext context) {
37 | return Scaffold(
38 | body: Center(
39 | child: Column(
40 | mainAxisSize: MainAxisSize.min,
41 | children: [
42 | Text('Date: ${DateTime.now()}'),
43 | Text('Counter is $counter'),
44 | ],
45 | ),
46 | ),
47 | floatingActionButton: FloatingActionButton(
48 | onPressed: () => counter++,
49 | child: const Icon(Icons.add),
50 | ),
51 | );
52 | }
53 | }
54 | ```
55 |
56 | You get this result, with real fine-grained reactivity:
57 |
58 | [](../../assets/solid_demo.gif)
59 |
60 | As you can see, the `DateTime.now()` text does not update when the counter changes, only the `Counter is X` text updates. This is because Solid tracks which parts of the UI depend on which state, and only updates those parts when the state changes, without any manual work from you.
61 |
62 | If this sounds interesting, check out the [Getting Started Guide](https://solid.mariuti.com/guides/getting-started) to learn how to set up Solid in your Flutter project!
63 |
64 | ## License
65 |
66 | The Solid framework is open-source software licensed under the [MIT License](./LICENSE).
67 |
68 | ## Sponsorship
69 |
70 | If you find Solid useful and would like to support its development, consider sponsoring the project on [GitHub Sponsors](https://github.com/sponsors/nank1ro/).
71 | I love building open-source software and your support helps me dedicate more time to improving Solid and adding new features.
72 |
--------------------------------------------------------------------------------
/packages/solid_annotations/lib/extensions.dart:
--------------------------------------------------------------------------------
1 | import 'package:flutter/widgets.dart';
2 | import 'package:solid_annotations/provider.dart';
3 |
4 | /// Extension methods for Future and Stream to handle loading, error, and data
5 | /// states.
6 | extension FutureWhen