Skip to main content

A month of Flutter: rendering a ListView with StreamBuilder

Originally published on
The data for Birb will be stored in Firebase Cloud Firestore. When looking at patterns to handle getting and rendering data, I decided to go with the StreamBuilder example from the cloud_firestore package documentation. I don't know how well pagination will work with this approach so that will be an experiment for another day.
The first change I'm making is turning the static List<int> into a Stream, and moving it further up the widget tree. I want the PostsList widget to only care about rendering items from a Stream, not how to create the Streamitself. This has the bonus of making it easier to mock data in the tests.
final Stream<List<int>> _posts = Stream<List<int>>.fromIterable(
    List<int>.generate(10, (int i) => i),
This looks a little weird but it is basically generating a list of 10 items. That List of 10 items is used as the first value in a new Stream. From the subscription side of the Stream, there will be a single event with data that is a List of 10 items. I'm going with this pattern because Firestore will have snapshots with multiple documents.
The PostsList build method needs to be updated to consume the Stream and use a StreamBuilder:
Widget build(BuildContext context) {
  return StreamBuilder<List<int>>(
    stream: posts,
    builder: (BuildContext context, AsyncSnapshot<List<int>> snapshot) {
      if (snapshot.hasError) {
        return Text('Error: ${snapshot.error}');
       switch (snapshot.connectionState) {
        case ConnectionState.waiting:
          return const Text('Loading...');
          if ( {
            return const NoContent();
          return _itemList(;
The StreamBuilder takes a Stream and will then call the builder with an AsyncSnapshot. There are a couple of different states on this snapshot that need to be handled:
  • The first is checking to see if there has been an error. If there has been, render some error text.
  • Second, if the connection is waiting, show a loader while waiting for data to arrive.
  • Third, if there is no data, render the NoContent widget.
  • Finally if none of the previous cases are met, render the actual data.
Looking at the tests for PostList, all four of those scenarios are tested by creating different kinds of mock streams with the _postsStream helper.
Stream<List<int>> _postsStream(int count) {
  return Stream<List<int>>.fromIterable(
      List<int>.generate(count, (int i) => i),
Then I can test that the loading text is shown, followed a test that all the mocked items are rendered.
testWidgets('renders list of PostItems', (WidgetTester tester) async {
  // Build our app and trigger a frame.
  await tester.pumpWidget(MaterialApp(
    home: PostsList(_postsStream(5)),

  expect(find.text('Loading...'), findsOneWidget);

  await tester.pump(;

  expect(find.byType(PostItem), findsNWidgets(5));
To simulate the error case, I can throw an error on a Future and convert that to a stream.
testWidgets('renders NoContent widget', (WidgetTester tester) async {
  // Build our app and trigger a frame.
  await tester.pumpWidget(MaterialApp(
    home: PostsList(Future<List<int>>.error('Bad Connection').asStream()),

  await tester.pump(;
   expect(find.text('Error: Bad Connection'), findsOneWidget);
One other minor change I made was to reduce the height of the cards so I could be sure the additional cards were rendering.

Code changes


Popular posts from this blog

Sync is currently experiencing problems

Update : I now recommend you install Google Chrome  and  disable  the built in Browser as it supports encrypting all synced data. After picking up a gorgeous  Galaxy Nexus yesterday I was running into an issue where my browser data wasn't syncing to the phone. After a little Googling I found this is commonly caused by having all of my synced Chrome data encrypted instead of the default of only encrypting the passwords. These are the steps I went through to get my dat syncing again without losing any of it. The exact error I was getting was "Sync is currently experiencing problems. It will be back shortly." In Google Chrome open the personal stuff settings page by clicking this link or by opening the wrench menu, and click on "signed in with".  Hit "disconnect your Google Account" to temporarily disable syncing from your browser. Visit the Google Dashboard and "Stop sync and delete data from Google". I waite

A month of Flutter: a look back

Originally published on . This is it. 31 blog posts in 31 days. Writing  a month of flutter  has been a ton of work but also lots of fun and a good learning experience. I really appreciate how supportive and and positive everyone as been. Publishing experience For the series I've been posting on ,  DEV ,  my personal blog , and  Medium . After publishing to these sites, I would put the Bendyworks link on  Twitter ,  Reddit , and the  Flutter Study Group Slack . Posting to DEV was easy as they use Markdown just like the Bendworks blog. DEV also has built in support for a  series of posts  so it's easy to read the entire series. I did have to manually upload any embedded images. DEV also has a number of  liquid tags  for embedding things like GitHub issues that I didn't make as much use of as I should have. Blogger is rich text so it was easy to copy/paste the rendered posts. This would hotlink all the images though so I had to rem

A month of Flutter: the real hero animation

Originally published on . For the last post before the month's wrap up tomorrow, I wanted to do something more fun: use a  hero animation between the home page list and the individual post page. When I first implemented the  Hero  animation it never worked going back from a  PostPage  to the  HomePage . The reason was that  HomePage  would get rerendered and that would  generate new fake posts . So I moved the fake data generation up a level to  MyApp  and pass it into  HomePage . This is more realistic as going to the  HomePage  shouldn't request the  Post s every time. HomePage ( title: 'Birb' , posts: _loadPosts ( context ), ) The  PostPage  implementation is a simple  StatelessWidget  that takes  Post  and renders a  PostItem . This will become more complex as things like comments and likes are implemented but works for now. class PostPage extends StatelessWidget { const PostPage ({ Key key , @required this