feat: add timeline post embeds for images and videos with download functionality

.github/workflows/ci.yml

···
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  analyze-and-test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: '17'
+          cache: 'gradle'
+
+      - name: Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.5'
+          channel: 'stable'
+          cache: true
+          cache-key: 'flutter-:os:-:channel:-:version:-:arch:-:hash:'
+          cache-path: '${{ runner.tool_cache }}/flutter/:channel:-:version:-:arch:'
+
+      - name: Get dependencies
+        run: flutter pub get
+
+      - name: Analyze code
+        run: flutter analyze
+
+      - name: Run code generation
+        run: dart run build_runner build --delete-conflicting-outputs
+
+      - name: Run tests with coverage
+        run: flutter test --coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage/lcov.info
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+          flags: unittests
+          name: codecov-lazurite
+          verbose: true

codecov.yml

···
+coverage:
+  precision: 2
+  round: down
+  range: "70...100"
+
+  status:
+    project:
+      default:
+        target: 80% # our true target is 95%
+        threshold: 1%
+        if_ci_failed: error
+
+    patch:
+      default:
+        target: 80% # true target is 95%
+        threshold: 1%
+
+comment:
+  layout: "reach,diff,flags,files,footer"
+  behavior: default
+  require_changes: false
+
+ignore:
+  - "**/*.g.dart"
+  - "**/*.freezed.dart"
+  - "lib/src/app/**"
+  - "test/**"

doc/roadmap.txt

···
 Tasks:
 - [x] Profile screen: fetch + cache profile + author feed, cursor paging.
 - [x] Search screen: query -> paged results; store recent searches (local).
-- [ ] Shared hydration: ensure embeds/media are rendered consistently.
+- [x] Shared hydration: ensure embeds/media are rendered consistently.
 - [ ] Add routes
       - [ ] /search?q=<query>
         (SearchScreen has initialQuery but router doesn't wire query params)

lib/src/core/utils/logger_provider.g.dart

···
 
 final class LoggerProvider extends $FunctionalProvider<Logger, Logger, Logger>
     with $Provider<Logger> {
-  LoggerProvider._({required LoggerFamily super.from, required String super.argument})
-    : super(
-        retry: null,
-        name: r'loggerProvider',
-        isAutoDispose: false,
-        dependencies: null,
-        $allTransitiveDependencies: null,
-      );
+  LoggerProvider._({
+    required LoggerFamily super.from,
+    required String super.argument,
+  }) : super(
+         retry: null,
+         name: r'loggerProvider',
+         isAutoDispose: false,
+         dependencies: null,
+         $allTransitiveDependencies: null,
+       );
 
   @override
   String debugGetCreateSourceHash() => _$loggerHash();
···
 
   @$internal
   @override
-  $ProviderElement<Logger> $createElement($ProviderPointer pointer) => $ProviderElement(pointer);
+  $ProviderElement<Logger> $createElement($ProviderPointer pointer) =>
+      $ProviderElement(pointer);
 
   @override
   Logger create(Ref ref) {
···
 
   /// {@macro riverpod.override_with_value}
   Override overrideWithValue(Logger value) {
-    return $ProviderOverride(origin: this, providerOverride: $SyncValueProvider<Logger>(value));
+    return $ProviderOverride(
+      origin: this,
+      providerOverride: $SyncValueProvider<Logger>(value),
+    );
   }
 
   @override
···
 
 String _$loggerHash() => r'bd47f4c6cd32d9afa5bd157104a6ad483aaafc58';
 
-final class LoggerFamily extends $Family with $FunctionalFamilyOverride<Logger, String> {
+final class LoggerFamily extends $Family
+    with $FunctionalFamilyOverride<Logger, String> {
   LoggerFamily._()
     : super(
         retry: null,
···
         isAutoDispose: false,
       );
 
-  LoggerProvider call(String name) => LoggerProvider._(argument: name, from: this);
+  LoggerProvider call(String name) =>
+      LoggerProvider._(argument: name, from: this);
 
   @override
   String toString() => r'loggerProvider';

lib/src/features/auth/application/auth_providers.g.dart

···
 final secureStorageProvider = SecureStorageProvider._();
 
 final class SecureStorageProvider
-    extends $FunctionalProvider<FlutterSecureStorage, FlutterSecureStorage, FlutterSecureStorage>
+    extends
+        $FunctionalProvider<
+          FlutterSecureStorage,
+          FlutterSecureStorage,
+          FlutterSecureStorage
+        >
     with $Provider<FlutterSecureStorage> {
   SecureStorageProvider._()
     : super(
···
 
   @$internal
   @override
-  $ProviderElement<FlutterSecureStorage> $createElement($ProviderPointer pointer) =>
-      $ProviderElement(pointer);
+  $ProviderElement<FlutterSecureStorage> $createElement(
+    $ProviderPointer pointer,
+  ) => $ProviderElement(pointer);
 
   @override
   FlutterSecureStorage create(Ref ref) {
···
 final identityRepositoryProvider = IdentityRepositoryProvider._();
 
 final class IdentityRepositoryProvider
-    extends $FunctionalProvider<IdentityRepository, IdentityRepository, IdentityRepository>
+    extends
+        $FunctionalProvider<
+          IdentityRepository,
+          IdentityRepository,
+          IdentityRepository
+        >
     with $Provider<IdentityRepository> {
   IdentityRepositoryProvider._()
     : super(
···
 
   @$internal
   @override
-  $ProviderElement<IdentityRepository> $createElement($ProviderPointer pointer) =>
-      $ProviderElement(pointer);
+  $ProviderElement<IdentityRepository> $createElement(
+    $ProviderPointer pointer,
+  ) => $ProviderElement(pointer);
 
   @override
   IdentityRepository create(Ref ref) {
···
   }
 }
 
-String _$identityRepositoryHash() => r'38ca9e5b495eecbd5c25af2f3968a92b89f90c30';
+String _$identityRepositoryHash() =>
+    r'38ca9e5b495eecbd5c25af2f3968a92b89f90c30';
 
 @ProviderFor(oauthClient)
 final oauthClientProvider = OauthClientProvider._();
 
-final class OauthClientProvider extends $FunctionalProvider<OAuthClient, OAuthClient, OAuthClient>
+final class OauthClientProvider
+    extends $FunctionalProvider<OAuthClient, OAuthClient, OAuthClient>
     with $Provider<OAuthClient> {
   OauthClientProvider._()
     : super(
···
   }
 }
 
-String _$oauthClientHash() => r'5c4f5fd51c2d9f1936f004fba9dc1fa4b362e6ec';
+String _$oauthClientHash() => r'4262ff26da2346cd4a0fb28eaacc66c2b0587cdf';
 
 @ProviderFor(serverMetadataRepository)
 final serverMetadataRepositoryProvider = ServerMetadataRepositoryProvider._();
···
 
   @$internal
   @override
-  $ProviderElement<ServerMetadataRepository> $createElement($ProviderPointer pointer) =>
-      $ProviderElement(pointer);
+  $ProviderElement<ServerMetadataRepository> $createElement(
+    $ProviderPointer pointer,
+  ) => $ProviderElement(pointer);
 
   @override
   ServerMetadataRepository create(Ref ref) {
···
   }
 }
 
-String _$serverMetadataRepositoryHash() => r'8a4213bf3952ed89db571088d94fa6998211f96e';
+String _$serverMetadataRepositoryHash() =>
+    r'8a4213bf3952ed89db571088d94fa6998211f96e';
 
 @ProviderFor(authRepository)
 final authRepositoryProvider = AuthRepositoryProvider._();
···
 @ProviderFor(AuthNotifier)
 final authProvider = AuthNotifierProvider._();
 
-final class AuthNotifierProvider extends $NotifierProvider<AuthNotifier, AuthState> {
+final class AuthNotifierProvider
+    extends $NotifierProvider<AuthNotifier, AuthState> {
   AuthNotifierProvider._()
     : super(
         from: null,
···
 
   /// {@macro riverpod.override_with_value}
   Override overrideWithValue(AuthState value) {
-    return $ProviderOverride(origin: this, providerOverride: $SyncValueProvider<AuthState>(value));
+    return $ProviderOverride(
+      origin: this,
+      providerOverride: $SyncValueProvider<AuthState>(value),
+    );
   }
 }
 

lib/src/features/profile/application/profile_providers.g.dart

···
   }
 }
 
-String _$profileNotifierHash() => r'64dd55fec0d7c7189141790373270bc9eb244789';
+String _$profileNotifierHash() => r'8c85b7b98f88588be316afe12936a90082506568';
 
 final class ProfileNotifierFamily extends $Family
     with
···
 }
 
 String _$authorFeedNotifierHash() =>
-    r'905cb265b01479bfbfcd45bfe6f88573a6357a1a';
+    r'b241402d3ec7ba5ca64908fd166bbfa3d3b126c7';
 
 final class AuthorFeedNotifierFamily extends $Family
     with

lib/src/features/search/application/search_providers.g.dart

···
   }
 }
 
-String _$searchNotifierHash() => r'415fa1737884a131e01380878ece09cba2a15120';
+String _$searchNotifierHash() => r'fae1ada9ad3fa7cb3b48ea549a570f132f718126';
 
 final class SearchNotifierFamily extends $Family
     with

lib/src/features/timeline/infrastructure/timeline_repository.dart

···
       cid: json['cid'],
       authorDid: json['author']['did'],
       record: jsonEncode(json['record']),
+      embed: Value(json['embed'] != null ? jsonEncode(json['embed']) : null),
       indexedAt: Value(DateTime.tryParse(json['indexedAt'] ?? '')),
       replyCount: Value(json['replyCount'] ?? 0),
       repostCount: Value(json['repostCount'] ?? 0),

lib/src/features/timeline/presentation/widgets/embeds/embed_images.dart

···
+import 'package:dio/dio.dart';
+import 'package:flutter/material.dart';
+import 'package:gal/gal.dart';
+import 'package:path_provider/path_provider.dart';
+
+class EmbedImages extends StatelessWidget {
+  const EmbedImages({required this.images, super.key});
+
+  final List<dynamic> images;
+
+  @override
+  Widget build(BuildContext context) {
+    if (images.isEmpty) return const SizedBox.shrink();
+
+    if (images.length == 1) {
+      return _SingleImage(image: images.first as Map<String, dynamic>);
+    }
+
+    if (images.length == 2) {
+      return Row(
+        children: [
+          Expanded(child: _SingleImage(image: images[0] as Map<String, dynamic>)),
+          const SizedBox(width: 4),
+          Expanded(child: _SingleImage(image: images[1] as Map<String, dynamic>)),
+        ],
+      );
+    }
+
+    if (images.length == 3) {
+      return Column(
+        children: [
+          _SingleImage(image: images[0] as Map<String, dynamic>),
+          const SizedBox(height: 4),
+          Row(
+            children: [
+              Expanded(child: _SingleImage(image: images[1] as Map<String, dynamic>)),
+              const SizedBox(width: 4),
+              Expanded(child: _SingleImage(image: images[2] as Map<String, dynamic>)),
+            ],
+          ),
+        ],
+      );
+    }
+
+    return Column(
+      children: [
+        Row(
+          children: [
+            Expanded(child: _SingleImage(image: images[0] as Map<String, dynamic>)),
+            const SizedBox(width: 4),
+            Expanded(child: _SingleImage(image: images[1] as Map<String, dynamic>)),
+          ],
+        ),
+        const SizedBox(height: 4),
+        Row(
+          children: [
+            Expanded(child: _SingleImage(image: images[2] as Map<String, dynamic>)),
+            const SizedBox(width: 4),
+            Expanded(child: _SingleImage(image: images[3] as Map<String, dynamic>)),
+          ],
+        ),
+      ],
+    );
+  }
+}
+
+class _SingleImage extends StatelessWidget {
+  const _SingleImage({required this.image});
+
+  final Map<String, dynamic> image;
+
+  Future<void> _downloadImage(BuildContext context, String url) async {
+    try {
+      final dio = Dio();
+      final tempDir = await getTemporaryDirectory();
+      final fileName = '${DateTime.now().millisecondsSinceEpoch}.jpg';
+      final path = '${tempDir.path}/$fileName';
+
+      await dio.download(url, path);
+      await Gal.putImage(path);
+
+      if (context.mounted) {
+        ScaffoldMessenger.of(
+          context,
+        ).showSnackBar(const SnackBar(content: Text('Image saved to gallery')));
+      }
+    } catch (e) {
+      if (context.mounted) {
+        ScaffoldMessenger.of(
+          context,
+        ).showSnackBar(SnackBar(content: Text('Failed to save image: $e')));
+      }
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final thumb = image['thumb'] as String? ?? '';
+    final fullsize = image['fullsize'] as String? ?? thumb;
+    final alt = image['alt'] as String? ?? '';
+
+    return Stack(
+      children: [
+        AspectRatio(
+          aspectRatio: 16 / 9,
+          child: Container(
+            decoration: BoxDecoration(
+              borderRadius: BorderRadius.circular(8),
+              image: DecorationImage(image: NetworkImage(thumb), fit: BoxFit.cover),
+            ),
+          ),
+        ),
+        Positioned(
+          top: 8,
+          right: 8,
+          child: Container(
+            decoration: BoxDecoration(
+              color: Colors.black.withValues(alpha: 0.5),
+              shape: BoxShape.circle,
+            ),
+            child: IconButton(
+              icon: const Icon(Icons.download, color: Colors.white, size: 20),
+              onPressed: () => _downloadImage(context, fullsize),
+              tooltip: 'Download',
+            ),
+          ),
+        ),
+        if (alt.isNotEmpty)
+          Positioned(
+            bottom: 8,
+            left: 8,
+            child: Container(
+              padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2),
+              decoration: BoxDecoration(
+                color: Colors.black.withValues(alpha: 0.7),
+                borderRadius: BorderRadius.circular(4),
+              ),
+              child: const Text(
+                'ALT',
+                style: TextStyle(color: Colors.white, fontSize: 10, fontWeight: FontWeight.bold),
+              ),
+            ),
+          ),
+      ],
+    );
+  }
+}

lib/src/features/timeline/presentation/widgets/embeds/embed_video.dart

···
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:gal/gal.dart';
+import 'package:lazurite/src/features/auth/application/auth_providers.dart';
+import 'package:lazurite/src/infrastructure/network/providers.dart';
+import 'package:path_provider/path_provider.dart';
+
+class EmbedVideo extends ConsumerWidget {
+  const EmbedVideo({
+    required this.playlist,
+    this.thumbnail,
+    this.alt,
+    this.cid,
+    this.authorDid,
+    super.key,
+  });
+
+  final String playlist;
+  final String? thumbnail;
+  final String? alt;
+  final String? cid;
+  final String? authorDid;
+
+  Future<void> _downloadVideo(BuildContext context, WidgetRef ref) async {
+    if (cid == null || authorDid == null) {
+      ScaffoldMessenger.of(context).showSnackBar(
+        const SnackBar(content: Text('Cannot download video: missing metadata (CID/DID)')),
+      );
+      return;
+    }
+
+    try {
+      String pdsUrl = 'https://bsky.social';
+      try {
+        final doc = await ref.read(identityRepositoryProvider).resolveDidDocument(authorDid!);
+        final endpoint = doc?.pdsEndpoint;
+        if (endpoint != null) {
+          pdsUrl = endpoint;
+        }
+      } catch (e) {
+        debugPrint('Failed to resolve DID, using fallback: $e');
+      }
+
+      final dio = ref.read(dioPublicProvider);
+      final tempDir = await getTemporaryDirectory();
+      final fileName = '${DateTime.now().millisecondsSinceEpoch}.mp4';
+      final path = '${tempDir.path}/$fileName';
+
+      final url = '$pdsUrl/xrpc/com.atproto.sync.getBlob?did=$authorDid&cid=$cid';
+
+      await dio.download(url, path);
+      await Gal.putVideo(path);
+
+      if (context.mounted) {
+        ScaffoldMessenger.of(
+          context,
+        ).showSnackBar(const SnackBar(content: Text('Video saved to gallery')));
+      }
+    } catch (e) {
+      if (context.mounted) {
+        ScaffoldMessenger.of(
+          context,
+        ).showSnackBar(SnackBar(content: Text('Failed to save video: $e')));
+      }
+    }
+  }
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    return Stack(
+      alignment: Alignment.center,
+      children: [
+        AspectRatio(
+          aspectRatio: 16 / 9,
+          child: Container(
+            decoration: BoxDecoration(
+              borderRadius: BorderRadius.circular(8),
+              color: Colors.black,
+              image: thumbnail != null
+                  ? DecorationImage(image: NetworkImage(thumbnail!), fit: BoxFit.cover)
+                  : null,
+            ),
+            child: thumbnail == null
+                ? const Center(child: Icon(Icons.movie, color: Colors.white54, size: 48))
+                : null,
+          ),
+        ),
+        Container(
+          padding: const EdgeInsets.all(12),
+          decoration: BoxDecoration(
+            color: Colors.black.withValues(alpha: 0.5),
+            shape: BoxShape.circle,
+          ),
+          child: const Icon(Icons.play_arrow, color: Colors.white, size: 32),
+        ),
+        Positioned(
+          top: 8,
+          right: 8,
+          child: Container(
+            decoration: BoxDecoration(
+              color: Colors.black.withValues(alpha: 0.5),
+              shape: BoxShape.circle,
+            ),
+            child: IconButton(
+              icon: const Icon(Icons.download, color: Colors.white, size: 20),
+              onPressed: () => _downloadVideo(context, ref),
+              tooltip: 'Download Video',
+            ),
+          ),
+        ),
+      ],
+    );
+  }
+}

lib/src/features/timeline/presentation/widgets/post_card.dart

···
 
 import 'post_actions_row.dart';
 import 'post_body.dart';
+import 'post_embeds.dart';
 import 'post_header.dart';
 
 class PostCard extends StatelessWidget {
···
                 crossAxisAlignment: CrossAxisAlignment.start,
                 children: [
                   PostBody(text: text),
+                  if (item.post.embed != null) ...[
+                    const SizedBox(height: 8),
+                    PostEmbeds(
+                      embed: jsonDecode(item.post.embed!) as Map<String, dynamic>,
+                      authorDid: item.author.did,
+                      record: jsonDecode(item.post.record) as Map<String, dynamic>,
+                    ),
+                  ],
                   const SizedBox(height: 12),
                   PostActionsRow(
                     replyCount: item.post.replyCount,

lib/src/features/timeline/presentation/widgets/post_embeds.dart

···
+import 'package:flutter/material.dart';
+
+import 'embeds/embed_images.dart';
+import 'embeds/embed_video.dart';
+
+class PostEmbeds extends StatelessWidget {
+  const PostEmbeds({required this.embed, required this.authorDid, this.record, super.key});
+
+  final Map<String, dynamic> embed;
+  final String authorDid;
+  final Map<String, dynamic>? record;
+
+  @override
+  Widget build(BuildContext context) {
+    final type = embed[r'$type'] as String?;
+
+    if (type == 'app.bsky.embed.images#view') {
+      final images = embed['images'] as List<dynamic>? ?? [];
+      return EmbedImages(images: images);
+    }
+
+    if (type == 'app.bsky.embed.video#view') {
+      // Extract CID from record if available
+      String? cid;
+      if (record != null &&
+          record![r'$type'] == 'app.bsky.feed.post' &&
+          record!['embed'] != null &&
+          record!['embed'][r'$type'] == 'app.bsky.embed.video') {
+        final video = record!['embed']['video'];
+        // The structure might be { ref: {$link: ...}, ... } or just blob?
+        // Usually blob is { ref: {$link: ...}, mimeType: ..., size: ...}
+        if (video != null && video['ref'] != null) {
+          cid = video['ref'][r'$link'] as String?;
+        }
+      }
+
+      return EmbedVideo(
+        playlist: embed['playlist'] as String? ?? '',
+        thumbnail: embed['thumbnail'] as String?,
+        alt: embed['alt'] as String?,
+        cid: cid,
+        authorDid: authorDid,
+      );
+    }
+
+    if (type == 'app.bsky.embed.recordWithMedia#view') {
+      final media = embed['media'] as Map<String, dynamic>?;
+      if (media != null) {
+        return PostEmbeds(embed: media, authorDid: authorDid, record: record);
+      }
+    }
+
+    //TODO: other embeds (External, Record)
+    return const SizedBox.shrink();
+  }
+}

lib/src/infrastructure/db/app_database.g.dart

···
     type: DriftSqlType.string,
     requiredDuringInsert: true,
   );
+  static const VerificationMeta _embedMeta = const VerificationMeta('embed');
+  @override
+  late final GeneratedColumn<String> embed = GeneratedColumn<String>(
+    'embed',
+    aliasedName,
+    true,
+    type: DriftSqlType.string,
+    requiredDuringInsert: false,
+  );
   static const VerificationMeta _indexedAtMeta = const VerificationMeta(
     'indexedAt',
   );
···
     cid,
     authorDid,
     record,
+    embed,
     indexedAt,
     replyCount,
     repostCount,
···
     } else if (isInserting) {
       context.missing(_recordMeta);
     }
+    if (data.containsKey('embed')) {
+      context.handle(
+        _embedMeta,
+        embed.isAcceptableOrUnknown(data['embed']!, _embedMeta),
+      );
+    }
     if (data.containsKey('indexed_at')) {
       context.handle(
         _indexedAtMeta,
···
         DriftSqlType.string,
         data['${effectivePrefix}record'],
       )!,
+      embed: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}embed'],
+      ),
       indexedAt: attachedDatabase.typeMapping.read(
         DriftSqlType.dateTime,
         data['${effectivePrefix}indexed_at'],
···
   final String cid;
   final String authorDid;
   final String record;
+  final String? embed;
   final DateTime? indexedAt;
   final int replyCount;
   final int repostCount;
···
     required this.cid,
     required this.authorDid,
     required this.record,
+    this.embed,
     this.indexedAt,
     required this.replyCount,
     required this.repostCount,
···
     map['cid'] = Variable<String>(cid);
     map['author_did'] = Variable<String>(authorDid);
     map['record'] = Variable<String>(record);
+    if (!nullToAbsent || embed != null) {
+      map['embed'] = Variable<String>(embed);
+    }
     if (!nullToAbsent || indexedAt != null) {
       map['indexed_at'] = Variable<DateTime>(indexedAt);
     }
···
       cid: Value(cid),
       authorDid: Value(authorDid),
       record: Value(record),
+      embed: embed == null && nullToAbsent
+          ? const Value.absent()
+          : Value(embed),
       indexedAt: indexedAt == null && nullToAbsent
           ? const Value.absent()
           : Value(indexedAt),
···
       cid: serializer.fromJson<String>(json['cid']),
       authorDid: serializer.fromJson<String>(json['authorDid']),
       record: serializer.fromJson<String>(json['record']),
+      embed: serializer.fromJson<String?>(json['embed']),
       indexedAt: serializer.fromJson<DateTime?>(json['indexedAt']),
       replyCount: serializer.fromJson<int>(json['replyCount']),
       repostCount: serializer.fromJson<int>(json['repostCount']),
···
       'cid': serializer.toJson<String>(cid),
       'authorDid': serializer.toJson<String>(authorDid),
       'record': serializer.toJson<String>(record),
+      'embed': serializer.toJson<String?>(embed),
       'indexedAt': serializer.toJson<DateTime?>(indexedAt),
       'replyCount': serializer.toJson<int>(replyCount),
       'repostCount': serializer.toJson<int>(repostCount),
···
     String? cid,
     String? authorDid,
     String? record,
+    Value<String?> embed = const Value.absent(),
     Value<DateTime?> indexedAt = const Value.absent(),
     int? replyCount,
     int? repostCount,
···
     cid: cid ?? this.cid,
     authorDid: authorDid ?? this.authorDid,
     record: record ?? this.record,
+    embed: embed.present ? embed.value : this.embed,
     indexedAt: indexedAt.present ? indexedAt.value : this.indexedAt,
     replyCount: replyCount ?? this.replyCount,
     repostCount: repostCount ?? this.repostCount,
···
       cid: data.cid.present ? data.cid.value : this.cid,
       authorDid: data.authorDid.present ? data.authorDid.value : this.authorDid,
       record: data.record.present ? data.record.value : this.record,
+      embed: data.embed.present ? data.embed.value : this.embed,
       indexedAt: data.indexedAt.present ? data.indexedAt.value : this.indexedAt,
       replyCount: data.replyCount.present
           ? data.replyCount.value
···
           ..write('cid: $cid, ')
           ..write('authorDid: $authorDid, ')
           ..write('record: $record, ')
+          ..write('embed: $embed, ')
           ..write('indexedAt: $indexedAt, ')
           ..write('replyCount: $replyCount, ')
           ..write('repostCount: $repostCount, ')
···
     cid,
     authorDid,
     record,
+    embed,
     indexedAt,
     replyCount,
     repostCount,
···
           other.cid == this.cid &&
           other.authorDid == this.authorDid &&
           other.record == this.record &&
+          other.embed == this.embed &&
           other.indexedAt == this.indexedAt &&
           other.replyCount == this.replyCount &&
           other.repostCount == this.repostCount &&
···
   final Value<String> cid;
   final Value<String> authorDid;
   final Value<String> record;
+  final Value<String?> embed;
   final Value<DateTime?> indexedAt;
   final Value<int> replyCount;
   final Value<int> repostCount;
···
     this.cid = const Value.absent(),
     this.authorDid = const Value.absent(),
     this.record = const Value.absent(),
+    this.embed = const Value.absent(),
     this.indexedAt = const Value.absent(),
     this.replyCount = const Value.absent(),
     this.repostCount = const Value.absent(),
···
     required String cid,
     required String authorDid,
     required String record,
+    this.embed = const Value.absent(),
     this.indexedAt = const Value.absent(),
     this.replyCount = const Value.absent(),
     this.repostCount = const Value.absent(),
···
     Expression<String>? cid,
     Expression<String>? authorDid,
     Expression<String>? record,
+    Expression<String>? embed,
     Expression<DateTime>? indexedAt,
     Expression<int>? replyCount,
     Expression<int>? repostCount,
···
       if (cid != null) 'cid': cid,
       if (authorDid != null) 'author_did': authorDid,
       if (record != null) 'record': record,
+      if (embed != null) 'embed': embed,
       if (indexedAt != null) 'indexed_at': indexedAt,
       if (replyCount != null) 'reply_count': replyCount,
       if (repostCount != null) 'repost_count': repostCount,
···
     Value<String>? cid,
     Value<String>? authorDid,
     Value<String>? record,
+    Value<String?>? embed,
     Value<DateTime?>? indexedAt,
     Value<int>? replyCount,
     Value<int>? repostCount,
···
       cid: cid ?? this.cid,
       authorDid: authorDid ?? this.authorDid,
       record: record ?? this.record,
+      embed: embed ?? this.embed,
       indexedAt: indexedAt ?? this.indexedAt,
       replyCount: replyCount ?? this.replyCount,
       repostCount: repostCount ?? this.repostCount,
···
     if (record.present) {
       map['record'] = Variable<String>(record.value);
     }
+    if (embed.present) {
+      map['embed'] = Variable<String>(embed.value);
+    }
     if (indexedAt.present) {
       map['indexed_at'] = Variable<DateTime>(indexedAt.value);
     }
···
           ..write('cid: $cid, ')
           ..write('authorDid: $authorDid, ')
           ..write('record: $record, ')
+          ..write('embed: $embed, ')
           ..write('indexedAt: $indexedAt, ')
           ..write('replyCount: $replyCount, ')
           ..write('repostCount: $repostCount, ')
···
       required String cid,
       required String authorDid,
       required String record,
+      Value<String?> embed,
       Value<DateTime?> indexedAt,
       Value<int> replyCount,
       Value<int> repostCount,
···
       Value<String> cid,
       Value<String> authorDid,
       Value<String> record,
+      Value<String?> embed,
       Value<DateTime?> indexedAt,
       Value<int> replyCount,
       Value<int> repostCount,
···
 
   ColumnFilters<String> get record => $composableBuilder(
     column: $table.record,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get embed => $composableBuilder(
+    column: $table.embed,
     builder: (column) => ColumnFilters(column),
   );
 
···
     builder: (column) => ColumnOrderings(column),
   );
 
+  ColumnOrderings<String> get embed => $composableBuilder(
+    column: $table.embed,
+    builder: (column) => ColumnOrderings(column),
+  );
+
   ColumnOrderings<DateTime> get indexedAt => $composableBuilder(
     column: $table.indexedAt,
     builder: (column) => ColumnOrderings(column),
···
 
   GeneratedColumn<String> get record =>
       $composableBuilder(column: $table.record, builder: (column) => column);
+
+  GeneratedColumn<String> get embed =>
+      $composableBuilder(column: $table.embed, builder: (column) => column);
 
   GeneratedColumn<DateTime> get indexedAt =>
       $composableBuilder(column: $table.indexedAt, builder: (column) => column);
···
                 Value<String> cid = const Value.absent(),
                 Value<String> authorDid = const Value.absent(),
                 Value<String> record = const Value.absent(),
+                Value<String?> embed = const Value.absent(),
                 Value<DateTime?> indexedAt = const Value.absent(),
                 Value<int> replyCount = const Value.absent(),
                 Value<int> repostCount = const Value.absent(),
···
                 cid: cid,
                 authorDid: authorDid,
                 record: record,
+                embed: embed,
                 indexedAt: indexedAt,
                 replyCount: replyCount,
                 repostCount: repostCount,
···
                 required String cid,
                 required String authorDid,
                 required String record,
+                Value<String?> embed = const Value.absent(),
                 Value<DateTime?> indexedAt = const Value.absent(),
                 Value<int> replyCount = const Value.absent(),
                 Value<int> repostCount = const Value.absent(),
···
                 cid: cid,
                 authorDid: authorDid,
                 record: record,
+                embed: embed,
                 indexedAt: indexedAt,
                 replyCount: replyCount,
                 repostCount: repostCount,

lib/src/infrastructure/db/daos/timeline_dao.dart

···
             cid: p.cid,
             authorDid: p.authorDid,
             record: p.record,
+            embed: Value(p.embed),
             indexedAt: Value(p.indexedAt),
             replyCount: Value(p.replyCount),
             repostCount: Value(p.repostCount),
···
     required this.cid,
     required this.authorDid,
     required this.record,
+    this.embed,
     this.indexedAt,
     this.replyCount = 0,
     this.repostCount = 0,
···
   final String cid;
   final String authorDid;
   final String record;
+  final String? embed;
   final DateTime? indexedAt;
   final int replyCount;
   final int repostCount;

lib/src/infrastructure/db/tables.dart

···
   TextColumn get cid => text()();
   TextColumn get authorDid => text()();
   TextColumn get record => text()();
+  TextColumn get embed => text().nullable()();
   DateTimeColumn get indexedAt => dateTime().nullable()();
   IntColumn get replyCount => integer().withDefault(const Constant(0))();
   IntColumn get repostCount => integer().withDefault(const Constant(0))();

lib/src/infrastructure/network/providers.g.dart

···
 ///
 /// This client is configured for the public AppView at public.api.bsky.app.
 
-final class DioPublicProvider extends $FunctionalProvider<Dio, Dio, Dio> with $Provider<Dio> {
+final class DioPublicProvider extends $FunctionalProvider<Dio, Dio, Dio>
+    with $Provider<Dio> {
   /// Provides the public Dio client for unauthenticated API access.
   ///
   /// This client is configured for the public AppView at public.api.bsky.app.
···
 
   @$internal
   @override
-  $ProviderElement<Dio> $createElement($ProviderPointer pointer) => $ProviderElement(pointer);
+  $ProviderElement<Dio> $createElement($ProviderPointer pointer) =>
+      $ProviderElement(pointer);
 
   @override
   Dio create(Ref ref) {
···
 
   /// {@macro riverpod.override_with_value}
   Override overrideWithValue(Dio value) {
-    return $ProviderOverride(origin: this, providerOverride: $SyncValueProvider<Dio>(value));
+    return $ProviderOverride(
+      origin: this,
+      providerOverride: $SyncValueProvider<Dio>(value),
+    );
   }
 }
 
···
 /// This requires a logged-in user with a resolved PDS URL.
 /// Returns null if no user is logged in.
 
-final class DioPdsProvider extends $FunctionalProvider<Dio?, Dio?, Dio?> with $Provider<Dio?> {
+final class DioPdsProvider extends $FunctionalProvider<Dio?, Dio?, Dio?>
+    with $Provider<Dio?> {
   /// Provides the PDS Dio client for authenticated API access.
   ///
   /// This requires a logged-in user with a resolved PDS URL.
···
 
   @$internal
   @override
-  $ProviderElement<Dio?> $createElement($ProviderPointer pointer) => $ProviderElement(pointer);
+  $ProviderElement<Dio?> $createElement($ProviderPointer pointer) =>
+      $ProviderElement(pointer);
 
   @override
   Dio? create(Ref ref) {
···
 
   /// {@macro riverpod.override_with_value}
   Override overrideWithValue(Dio? value) {
-    return $ProviderOverride(origin: this, providerOverride: $SyncValueProvider<Dio?>(value));
+    return $ProviderOverride(
+      origin: this,
+      providerOverride: $SyncValueProvider<Dio?>(value),
+    );
   }
 }
 
···
 /// This client automatically routes requests to the correct host
 /// based on endpoint metadata in the registry.
 
-final class XrpcClientProvider extends $FunctionalProvider<XrpcClient, XrpcClient, XrpcClient>
+final class XrpcClientProvider
+    extends $FunctionalProvider<XrpcClient, XrpcClient, XrpcClient>
     with $Provider<XrpcClient> {
   /// Provides the XRPC client for making API requests.
   ///

pubspec.lock

···
       url: "https://pub.dev"
     source: hosted
     version: "4.0.0"
+  gal:
+    dependency: "direct main"
+    description:
+      name: gal
+      sha256: "969598f986789127fd407a750413249e1352116d4c2be66e81837ffeeaafdfee"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.3.2"
   glob:
     dependency: transitive
     description:
···
       url: "https://pub.dev"
     source: hosted
     version: "1.0.4"
+  mocktail_image_network:
+    dependency: "direct dev"
+    description:
+      name: mocktail_image_network
+      sha256: a1fccbba780343517cfc552e0af2b3834d8bdb8f9f55a746c4d495ed1a8d50d6
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.2.0"
   node_preamble:
     dependency: transitive
     description:

pubspec.yaml

···
 name: lazurite
-description: "A new Flutter project."
-# The following line prevents the package from being accidentally published to
-# pub.dev using `flutter pub publish`. This is preferred for private packages.
-publish_to: "none" # Remove this line if you wish to publish to pub.dev
+description: A material BlueSky client.
+publish_to: "none"
 
-# The following defines the version and build number for your application.
-# A version number is three numbers separated by dots, like 1.2.43
-# followed by an optional build number separated by a +.
-# Both the version and the builder number may be overridden in flutter
-# build by specifying --build-name and --build-number, respectively.
+# Version number can be overriden by specifying --build-name and --build-number, respectively.
+#
 # In Android, build-name is used as versionName while build-number used as versionCode.
 # Read more about Android versioning at https://developer.android.com/studio/publish/versioning
+#
 # In iOS, build-name is used as CFBundleShortVersionString while build-number is used as CFBundleVersion.
 # Read more about iOS versioning at
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
+#
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
 version: 1.0.0+1
···
   sqlite3_flutter_libs: ^0.5.0
   path_provider: ^2.1.2
   path: ^1.9.0
+  gal: ^2.3.0
 
 dev_dependencies:
   flutter_test:
···
   # Mocking
   http_mock_adapter: ^0.6.1
   mocktail: ^1.0.4
+  mocktail_image_network: ^1.2.0
 
 flutter:
   uses-material-design: true
···
   # For details regarding adding assets from package dependencies, see
   # https://flutter.dev/to/asset-from-package
 
-  # To add custom fonts to your application, add a fonts section here,
-  # in this "flutter" section. Each entry in this list should have a
-  # "family" key with the font family name, and a "fonts" key with a
-  # list giving the asset and other descriptors for the font. For
-  # example:
+  # Custom fonts. Example:
   # fonts:
   #   - family: Schyler
   #     fonts:

test/helpers/test_http_overrides.dart

···
+import 'dart:io';
+
+class TestHttpOverrides extends HttpOverrides {
+  @override
+  HttpClient createHttpClient(SecurityContext? context) {
+    return _TestHttpClient();
+  }
+}
+
+class _TestHttpClient implements HttpClient {
+  @override
+  dynamic noSuchMethod(Invocation invocation) {
+    throw UnimplementedError();
+  }
+}

test/src/features/timeline/presentation/widgets/embeds/embed_images_test.dart

···
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:lazurite/src/features/timeline/presentation/widgets/embeds/embed_images.dart';
+import 'package:mocktail/mocktail.dart';
+import 'package:mocktail_image_network/mocktail_image_network.dart';
+
+void main() {
+  setUpAll(() {
+    registerFallbackValue(const MaterialApp());
+  });
+
+  group('EmbedImages', () {
+    testWidgets('renders single image', (tester) async {
+      await mockNetworkImages(() async {
+        await tester.pumpWidget(
+          const MaterialApp(
+            home: Scaffold(
+              body: EmbedImages(
+                images: [
+                  {'thumb': 'https://example.com/1.jpg', 'fullsize': 'https://example.com/1.jpg'},
+                ],
+              ),
+            ),
+          ),
+        );
+      });
+
+      expect(find.byType(AspectRatio), findsOneWidget);
+      expect(find.byIcon(Icons.download), findsOneWidget);
+    });
+
+    testWidgets('renders two images', (tester) async {
+      await mockNetworkImages(() async {
+        await tester.pumpWidget(
+          const MaterialApp(
+            home: Scaffold(
+              body: EmbedImages(
+                images: [
+                  {'thumb': '1.jpg'},
+                  {'thumb': '2.jpg'},
+                ],
+              ),
+            ),
+          ),
+        );
+      });
+      expect(find.byIcon(Icons.download), findsNWidgets(2));
+    });
+
+    testWidgets('renders download button', (tester) async {
+      await mockNetworkImages(() async {
+        await tester.pumpWidget(
+          const MaterialApp(
+            home: Scaffold(
+              body: EmbedImages(
+                images: [
+                  {'thumb': '1.jpg'},
+                ],
+              ),
+            ),
+          ),
+        );
+      });
+      expect(find.byType(IconButton), findsOneWidget);
+    });
+  });
+}

test/src/features/timeline/presentation/widgets/embeds/embed_video_test.dart

···
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:lazurite/src/features/timeline/presentation/widgets/embeds/embed_video.dart';
+import 'package:mocktail_image_network/mocktail_image_network.dart';
+
+void main() {
+  group('EmbedVideo', () {
+    testWidgets('renders placeholder and play button', (tester) async {
+      await mockNetworkImages(() async {
+        await tester.pumpWidget(
+          const ProviderScope(
+            child: MaterialApp(
+              home: Scaffold(body: EmbedVideo(playlist: 'video.m3u8')),
+            ),
+          ),
+        );
+      });
+
+      expect(find.byIcon(Icons.play_arrow), findsOneWidget);
+      expect(find.byIcon(Icons.download), findsOneWidget);
+    });
+
+    testWidgets('shows thumbnail if provided', (tester) async {
+      await mockNetworkImages(() async {
+        await tester.pumpWidget(
+          const ProviderScope(
+            child: MaterialApp(
+              home: Scaffold(
+                body: EmbedVideo(
+                  playlist: 'video.m3u8',
+                  thumbnail: 'https://example.com/thumb.jpg',
+                ),
+              ),
+            ),
+          ),
+        );
+      });
+      expect(find.byType(Container), findsWidgets);
+    });
+  });
+}

test/src/features/timeline/presentation/widgets/post_embeds_test.dart

···
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:lazurite/src/features/timeline/presentation/widgets/embeds/embed_images.dart';
+import 'package:lazurite/src/features/timeline/presentation/widgets/embeds/embed_video.dart';
+import 'package:lazurite/src/features/timeline/presentation/widgets/post_embeds.dart';
+
+void main() {
+  group('PostEmbeds', () {
+    testWidgets('renders specific embed types correctly', (tester) async {
+      await tester.pumpWidget(
+        const ProviderScope(
+          child: MaterialApp(
+            home: Scaffold(
+              body: PostEmbeds(
+                embed: {r'$type': 'app.bsky.embed.images#view', 'images': []},
+                authorDid: 'did:example:123',
+              ),
+            ),
+          ),
+        ),
+      );
+      expect(find.byType(EmbedImages), findsOneWidget);
+
+      await tester.pumpWidget(
+        const ProviderScope(
+          child: MaterialApp(
+            home: Scaffold(
+              body: PostEmbeds(
+                authorDid: 'did:example:123',
+                embed: {
+                  r'$type': 'app.bsky.embed.video#view',
+                  'playlist': 'http://example.com/playlist.m3u8',
+                },
+              ),
+            ),
+          ),
+        ),
+      );
+      expect(find.byType(EmbedVideo), findsOneWidget);
+    });
+
+    testWidgets('handles nested recordWithMedia', (tester) async {
+      await tester.pumpWidget(
+        const ProviderScope(
+          child: MaterialApp(
+            home: Scaffold(
+              body: PostEmbeds(
+                authorDid: 'did:example:123',
+                embed: {
+                  r'$type': 'app.bsky.embed.recordWithMedia#view',
+                  'media': {r'$type': 'app.bsky.embed.images#view', 'images': []},
+                },
+              ),
+            ),
+          ),
+        ),
+      );
+      expect(find.byType(EmbedImages), findsOneWidget);
+    });
+
+    testWidgets('returns empty for unknown types', (tester) async {
+      await tester.pumpWidget(
+        const ProviderScope(
+          child: MaterialApp(
+            home: Scaffold(
+              body: PostEmbeds(
+                embed: {r'$type': 'app.bsky.embed.unknown#view'},
+                authorDid: 'did:example:123',
+              ),
+            ),
+          ),
+        ),
+      );
+      expect(find.byType(SizedBox), findsOneWidget);
+    });
+  });
+}