feat: Add AppImage widget for optimized image loading and update various screens to use it

ios/Podfile.lock

···
     - FlutterMacOS
   - share_plus (0.0.1):
     - Flutter
+  - sqflite_darwin (0.0.4):
+    - Flutter
+    - FlutterMacOS
   - url_launcher_ios (0.0.1):
     - Flutter
 
···
   - package_info_plus (from `.symlinks/plugins/package_info_plus/ios`)
   - path_provider_foundation (from `.symlinks/plugins/path_provider_foundation/darwin`)
   - share_plus (from `.symlinks/plugins/share_plus/ios`)
+  - sqflite_darwin (from `.symlinks/plugins/sqflite_darwin/darwin`)
   - url_launcher_ios (from `.symlinks/plugins/url_launcher_ios/ios`)
 
 EXTERNAL SOURCES:
···
     :path: ".symlinks/plugins/path_provider_foundation/darwin"
   share_plus:
     :path: ".symlinks/plugins/share_plus/ios"
+  sqflite_darwin:
+    :path: ".symlinks/plugins/sqflite_darwin/darwin"
   url_launcher_ios:
     :path: ".symlinks/plugins/url_launcher_ios/ios"
 
···
   package_info_plus: c0502532a26c7662a62a356cebe2692ec5fe4ec4
   path_provider_foundation: 2b6b4c569c0fb62ec74538f866245ac84301af46
   share_plus: 8b6f8b3447e494cca5317c8c3073de39b3600d1f
+  sqflite_darwin: 5a7236e3b501866c1c9befc6771dfd73ffb8702d
   url_launcher_ios: 5334b05cef931de560670eeae103fd3e431ac3fe
 
 PODFILE CHECKSUM: 4305caec6b40dde0ae97be1573c53de1882a07e5

lib/screens/comments_page.dart

···
 import 'package:grain/models/gallery.dart';
 import 'package:grain/utils.dart';
 import 'package:grain/widgets/gallery_photo_view.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class CommentsPage extends StatefulWidget {
   final String galleryUri;
···
                                     ),
                                   )
                                 : null,
-                            child: Image.network(
-                              comment.focus!.thumb.isNotEmpty
+                            child: AppImage(
+                              url: comment.focus!.thumb.isNotEmpty
                                   ? comment.focus!.thumb
                                   : comment.focus!.fullsize,
                               fit: BoxFit.cover,

lib/screens/profile_page.dart

···
 import 'package:grain/models/gallery.dart';
 import 'package:grain/api.dart';
 import 'gallery_page.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class ProfilePage extends StatefulWidget {
   final dynamic profile;
···
                                     ),
                                     clipBehavior: Clip.antiAlias,
                                     child: hasPhoto
-                                        ? Image.network(
-                                            gallery.items[0].thumb,
+                                        ? AppImage(
+                                            url: gallery.items[0].thumb,
                                             fit: BoxFit.cover,
-                                            width: double.infinity,
-                                            height: double.infinity,
                                           )
                                         : Center(
                                             child: Text(
···
                                     ),
                                     clipBehavior: Clip.antiAlias,
                                     child: hasPhoto
-                                        ? Image.network(
-                                            gallery.items[0].thumb,
+                                        ? AppImage(
+                                            url: gallery.items[0].thumb,
                                             fit: BoxFit.cover,
-                                            width: double.infinity,
-                                            height: double.infinity,
                                           )
                                         : Center(
                                             child: Text(

lib/screens/splash_page.dart

···
 import 'package:flutter_web_auth_2/flutter_web_auth_2.dart';
 import 'package:grain/app_logger.dart';
 import 'package:grain/main.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class SplashPage extends StatefulWidget {
   final void Function(dynamic session)? onSignIn;
···
       body: Stack(
         fit: StackFit.expand,
         children: [
-          Image.network(
-            'https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:bcgltzqazw5tb6k2g3ttenbj/bafkreiewhwu3ro5dv7omedphb62db4koa7qtvyzfhiiypg3ru4tvuxkrjy@jpeg',
+          AppImage(
+            url:
+                'https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:bcgltzqazw5tb6k2g3ttenbj/bafkreiewhwu3ro5dv7omedphb62db4koa7qtvyzfhiiypg3ru4tvuxkrjy@jpeg',
             fit: BoxFit.cover,
           ),
           Container(color: Colors.black.withOpacity(0.4)),

lib/widgets/app_image.dart

···
+import 'package:flutter/material.dart';
+import 'package:cached_network_image/cached_network_image.dart';
+
+class AppImage extends StatelessWidget {
+  final String? url;
+  final double? width;
+  final double? height;
+  final BoxFit fit;
+  final BorderRadius? borderRadius;
+  final Widget? placeholder;
+  final Widget? errorWidget;
+
+  const AppImage({
+    super.key,
+    required this.url,
+    this.width,
+    this.height,
+    this.fit = BoxFit.cover,
+    this.borderRadius,
+    this.placeholder,
+    this.errorWidget,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    if (url == null || url!.isEmpty) {
+      return errorWidget ??
+          Container(
+            width: width,
+            height: height,
+            color: Colors.grey[200],
+            child: const Icon(Icons.broken_image, color: Colors.grey),
+          );
+    }
+    final image = CachedNetworkImage(
+      imageUrl: url!,
+      width: width,
+      height: height,
+      fit: fit,
+      placeholder: (context, _) =>
+          placeholder ??
+          Container(
+            width: width,
+            height: height,
+            color: Colors.grey[200],
+            child: const Center(
+              child: CircularProgressIndicator(
+                strokeWidth: 2,
+                color: Color(0xFF0EA5E9),
+              ),
+            ),
+          ),
+      errorWidget: (context, _, __) =>
+          errorWidget ??
+          Container(
+            width: width,
+            height: height,
+            color: Colors.grey[200],
+            child: const Icon(Icons.broken_image, color: Colors.grey),
+          ),
+    );
+    if (borderRadius != null) {
+      return ClipRRect(
+        borderRadius:
+            borderRadius!, // BorderRadius is a subclass of BorderRadiusGeometry
+        child: image,
+      );
+    }
+    return image;
+  }
+}

lib/widgets/bottom_nav_bar.dart

···
 import 'package:flutter/material.dart';
 import 'package:font_awesome_flutter/font_awesome_flutter.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class BottomNavBar extends StatelessWidget {
   final int navIndex;
···
                                     ),
                                   )
                                 : null,
-                            child: CircleAvatar(
-                              radius: 12,
-                              backgroundImage: NetworkImage(avatarUrl!),
-                              backgroundColor: Colors.transparent,
+                            child: ClipOval(
+                              child: AppImage(
+                                url: avatarUrl!,
+                                width: 24,
+                                height: 24,
+                                fit: BoxFit.cover,
+                              ),
                             ),
                           )
                         : FaIcon(

lib/widgets/gallery_photo_view.dart

···
 import 'package:flutter/material.dart';
 import 'package:grain/models/gallery.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class GalleryPhotoView extends StatefulWidget {
   final List<GalleryPhoto> photos;
···
                   itemCount: widget.photos.length,
                   onPageChanged: (i) => setState(() => _currentIndex = i),
                   itemBuilder: (context, i) => Center(
-                    child: Image.network(
-                      widget.photos[i].fullsize,
+                    child: AppImage(
+                      url: widget.photos[i].fullsize,
                       fit: BoxFit.contain,
-                      loadingBuilder: (context, child, loadingProgress) {
-                        if (loadingProgress == null) return child;
-                        return const Center(
+                      placeholder: Container(
+                        color: Colors.black,
+                        child: const Center(
                           child: CircularProgressIndicator(
-                            color: Colors.white,
+                            strokeWidth: 2,
+                            color: Color(0xFF0EA5E9),
                           ),
-                        );
-                      },
-                      errorBuilder: (context, error, stackTrace) => const Icon(
-                        Icons.broken_image,
-                        color: Colors.white,
-                        size: 64,
+                        ),
+                      ),
+                      errorWidget: Container(
+                        color: Colors.black,
+                        child: const Icon(
+                          Icons.broken_image,
+                          color: Colors.grey,
+                        ),
                       ),
                     ),
                   ),

lib/widgets/gallery_preview.dart

···
 import 'package:flutter/material.dart';
 import 'package:grain/models/gallery.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class GalleryPreview extends StatelessWidget {
   final Gallery gallery;
···
           Expanded(
             flex: 2,
             child: photos.isNotEmpty
-                ? Image.network(
-                    photos[0].thumb,
+                ? AppImage(
+                    url: photos[0].thumb,
                     fit: BoxFit.cover,
                     width: double.infinity,
                     height: double.infinity,
···
               children: [
                 Expanded(
                   child: photos.length > 1
-                      ? Image.network(
-                          photos[1].thumb,
+                      ? AppImage(
+                          url: photos[1].thumb,
                           fit: BoxFit.cover,
                           width: double.infinity,
                           height: double.infinity,
···
                 const SizedBox(height: 2),
                 Expanded(
                   child: photos.length > 2
-                      ? Image.network(
-                          photos[2].thumb,
+                      ? AppImage(
+                          url: photos[2].thumb,
                           fit: BoxFit.cover,
                           width: double.infinity,
                           height: double.infinity,

lib/widgets/justified_gallery_view.dart

···
 import 'package:flutter/material.dart';
 import 'package:grain/models/gallery.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class JustifiedGalleryView extends StatelessWidget {
   final List<GalleryPhoto> items;
···
                       width: row[i].displayWidth,
                       height: row[i].displayHeight,
                       child: ClipRRect(
-                        child: Image.network(
-                          row[i].thumb,
-                          fit: BoxFit.cover,
-                          errorBuilder: (context, error, stackTrace) =>
-                              Container(
-                            color: Colors.grey[300],
-                            child: const Icon(
-                              Icons.broken_image,
-                              color: Colors.grey,
-                            ),
-                          ),
-                        ),
+                        child: AppImage(url: row[i].thumb, fit: BoxFit.cover),
                       ),
                     ),
                   ),

lib/widgets/timeline_item.dart

···
 import '../screens/profile_page.dart';
 import 'package:grain/api.dart';
 import 'package:grain/utils.dart';
+import 'package:grain/widgets/app_image.dart';
 
 class TimelineItemWidget extends StatelessWidget {
   final Gallery gallery;
···
                     },
                 child: CircleAvatar(
                   radius: 18,
-                  backgroundImage:
-                      actor?.avatar != null && actor!.avatar.isNotEmpty
-                      ? NetworkImage(actor.avatar)
-                      : null,
                   backgroundColor: Colors.transparent,
-                  child: (actor == null || actor.avatar.isEmpty)
-                      ? const Icon(
+                  child: (actor != null && actor.avatar.isNotEmpty)
+                      ? ClipOval(
+                          child: AppImage(
+                            url: actor.avatar,
+                            width: 36,
+                            height: 36,
+                            fit: BoxFit.cover,
+                          ),
+                        )
+                      : const Icon(
                           Icons.account_circle,
                           size: 24,
                           color: Colors.grey,
-                        )
-                      : null,
+                        ),
                 ),
               ),
               const SizedBox(width: 10),

macos/Flutter/GeneratedPluginRegistrant.swift

···
 import package_info_plus
 import path_provider_foundation
 import share_plus
+import sqflite_darwin
 import url_launcher_macos
 import window_to_front
 
···
   FPPPackageInfoPlusPlugin.register(with: registry.registrar(forPlugin: "FPPPackageInfoPlusPlugin"))
   PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin"))
   SharePlusMacosPlugin.register(with: registry.registrar(forPlugin: "SharePlusMacosPlugin"))
+  SqflitePlugin.register(with: registry.registrar(forPlugin: "SqflitePlugin"))
   UrlLauncherPlugin.register(with: registry.registrar(forPlugin: "UrlLauncherPlugin"))
   WindowToFrontPlugin.register(with: registry.registrar(forPlugin: "WindowToFrontPlugin"))
 }

pubspec.lock

···
       url: "https://pub.dev"
     source: hosted
     version: "2.1.2"
+  cached_network_image:
+    dependency: "direct main"
+    description:
+      name: cached_network_image
+      sha256: "7c1183e361e5c8b0a0f21a28401eecdbde252441106a9816400dd4c2b2424916"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.4.1"
+  cached_network_image_platform_interface:
+    dependency: transitive
+    description:
+      name: cached_network_image_platform_interface
+      sha256: "35814b016e37fbdc91f7ae18c8caf49ba5c88501813f73ce8a07027a395e2829"
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.1.1"
+  cached_network_image_web:
+    dependency: transitive
+    description:
+      name: cached_network_image_web
+      sha256: "980842f4e8e2535b8dbd3d5ca0b1f0ba66bf61d14cc3a17a9b4788a3685ba062"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.3.1"
   characters:
     dependency: transitive
     description:
···
     description: flutter
     source: sdk
     version: "0.0.0"
+  flutter_cache_manager:
+    dependency: transitive
+    description:
+      name: flutter_cache_manager
+      sha256: "400b6592f16a4409a7f2bb929a9a7e38c72cceb8ffb99ee57bbf2cb2cecf8386"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.4.1"
   flutter_dotenv:
     dependency: "direct main"
     description:
···
       url: "https://pub.dev"
     source: hosted
     version: "0.4.1"
+  octo_image:
+    dependency: transitive
+    description:
+      name: octo_image
+      sha256: "34faa6639a78c7e3cbe79be6f9f96535867e879748ade7d17c9b1ae7536293bd"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.1.0"
   package_info_plus:
     dependency: "direct main"
     description:
···
       url: "https://pub.dev"
     source: hosted
     version: "2.1.8"
+  rxdart:
+    dependency: transitive
+    description:
+      name: rxdart
+      sha256: "5c3004a4a8dbb94bd4bf5412a4def4acdaa12e12f269737a5751369e12d1a962"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.28.0"
   share_plus:
     dependency: "direct main"
     description:
···
       url: "https://pub.dev"
     source: hosted
     version: "7.0.0"
+  sqflite:
+    dependency: transitive
+    description:
+      name: sqflite
+      sha256: e2297b1da52f127bc7a3da11439985d9b536f75070f3325e62ada69a5c585d03
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.2"
+  sqflite_android:
+    dependency: transitive
+    description:
+      name: sqflite_android
+      sha256: "2b3070c5fa881839f8b402ee4a39c1b4d561704d4ebbbcfb808a119bc2a1701b"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.1"
+  sqflite_common:
+    dependency: transitive
+    description:
+      name: sqflite_common
+      sha256: "84731e8bfd8303a3389903e01fb2141b6e59b5973cacbb0929021df08dddbe8b"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.5.5"
+  sqflite_darwin:
+    dependency: transitive
+    description:
+      name: sqflite_darwin
+      sha256: "279832e5cde3fe99e8571879498c9211f3ca6391b0d818df4e17d9fff5c6ccb3"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.2"
+  sqflite_platform_interface:
+    dependency: transitive
+    description:
+      name: sqflite_platform_interface
+      sha256: "8dd4515c7bdcae0a785b0062859336de775e8c65db81ae33dd5445f35be61920"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.0"
   stack_trace:
     dependency: transitive
     description:
···
       url: "https://pub.dev"
     source: hosted
     version: "1.4.1"
+  synchronized:
+    dependency: transitive
+    description:
+      name: synchronized
+      sha256: c254ade258ec8282947a0acbbc90b9575b4f19673533ee46f2f6e9b3aeefd7c0
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.4.0"
   term_glyph:
     dependency: transitive
     description:

pubspec.yaml

···
   font_awesome_flutter: ^10.8.0
   at_uri: ^0.4.0
   share_plus: ^11.0.0
+  cached_network_image: ^3.4.1
 
 dev_dependencies:
   flutter_test: