[appview] generate database schema for clips and tags

.idea/dataSources.xml

···
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="DataSourceManagerImpl" format="xml" multifile-model="true">
+    <data-source source="LOCAL" name="Backend DB" read-only="true" uuid="befffb07-c652-4b9d-8f1c-31a01590f686">
+      <driver-ref>sqlite.xerial</driver-ref>
+      <synchronize>true</synchronize>
+      <jdbc-driver>org.sqlite.JDBC</jdbc-driver>
+      <jdbc-url>jdbc:sqlite:backend/clippr.db</jdbc-url>
+      <working-dir>$ProjectFileDir$</working-dir>
+    </data-source>
+  </component>
+</project>

.idea/dictionaries/project.xml

···
       <w>clippr</w>
       <w>dids</w>
       <w>jetstream</w>
+      <w>multiformats</w>
+      <w>rkey</w>
     </words>
   </dictionary>
 </component>

.idea/libraries/Dart_Packages.xml

···
         <entry key="build">
           <value>
             <list>
-              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build-2.5.0/lib" />
+              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build-2.5.1/lib" />
             </list>
           </value>
         </entry>
···
         <entry key="build_resolvers">
           <value>
             <list>
-              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_resolvers-2.5.0/lib" />
+              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_resolvers-2.5.1/lib" />
             </list>
           </value>
         </entry>
         <entry key="build_runner">
           <value>
             <list>
-              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner-2.5.0/lib" />
+              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner-2.5.1/lib" />
             </list>
           </value>
         </entry>
         <entry key="build_runner_core">
           <value>
             <list>
-              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner_core-9.0.0/lib" />
+              <option value="$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner_core-9.0.1/lib" />
             </list>
           </value>
         </entry>
···
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/base_codecs-1.0.1/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/boolean_selector-2.1.2/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/buffer-1.2.3/lib" />
-      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build-2.5.0/lib" />
+      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build-2.5.1/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_config-1.1.2/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_daemon-4.0.4/lib" />
-      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_resolvers-2.5.0/lib" />
-      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner-2.5.0/lib" />
-      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner_core-9.0.0/lib" />
+      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_resolvers-2.5.1/lib" />
+      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner-2.5.1/lib" />
+      <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/build_runner_core-9.0.1/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/built_collection-5.1.1/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/built_value-8.10.1/lib" />
       <root url="file://$PROJECT_DIR$/../.pub-cache/hosted/pub.dev/cbor-6.3.7/lib" />

.idea/sqldialects.xml

···
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="SqlDialectMappings">
+    <file url="PROJECT" dialect="SQLite" />
+  </component>
+</project>

backend/.gitignore

···
 # Created by `dart pub`
 .dart_tool/
 config.yaml
+*.db

backend/CHANGELOG.md

···
-## 1.0.0
-
+# clippr-be changelog
+## 0.1.0
 - Initial version.

backend/README.md

···
 ```bash
 cp config.example.yaml config.yaml
 vi config.yaml # modify settings here
-dart run
+chmod +x tools/build_and_run.sh
+./tools/build_and_run.sh
 ```

backend/bin/clippr.dart

···
   Logger.logInfo("${ClipprPubspec.getName()} ${ClipprPubspec.getVersion()}");
   Logger.logInfo("Initializing config...");
   Config(); // initialize config
+  Logger.logInfo("Initializing database at ${Config.getDatabaseName()}...");
+  launchDatabase();
+  Logger.logInfo("Initializing firehose...");
+  launchFirehose();
   Logger.logInfo("Starting server at ${Config.getHostname()}:${Config.getPort()}");
-  launchServer();
+  launchWebServer();
   Logger.logInfo("Server launched!");
 }

backend/config.example.yaml

···
 server:
   hostname: localhost
   port: 9090
+  database_name: "clippr.db"
 
 ## General AT Protocol settings (relay communication for the moment)
 network:

backend/lib/config/config.dart

···
     File file = File('config.yaml');
     if (file.existsSync()) {
       yamlDoc = loadYaml(file.readAsStringSync()) as Map;
-    } else {
-      Logger.logSevere("Failed to read config.yaml");
-      exit(1);
+      return;
+    }
+
+    file = File('config.yml');
+    if (file.existsSync()) {
+      yamlDoc = loadYaml(file.readAsStringSync()) as Map;
+      return;
     }
+
+    Logger.logSevere("Failed to read config.yaml");
+    exit(1);
   }
 
   static int getPort() {
···
     return yamlDoc?['server']['hostname'];
   }
 
+  static String getDatabaseName() {
+    return yamlDoc?['server']['database_name'];
+  }
+
   static String getFirehoseProvider() {
     return yamlDoc?['network']['firehose_provider'];
   }
-}
+}

backend/lib/db/database.dart

···
+/*
+ * clippr: a social bookmarking service for the AT Protocol
+ * Copyright (c) 2025 clippr contributors.
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:atproto/atproto.dart';
+import 'package:clippr/config/config.dart';
+import 'package:drift/drift.dart';
+import 'package:drift/native.dart';
+
+part 'database.g.dart';
+
+class Clips extends Table {
+  DateTimeColumn get timestamp =>
+      dateTime().named("time_us").withDefault(currentDateAndTime)();
+  TextColumn get did => text()();
+  TextColumn get recordKey => text().named("rkey")();
+  TextColumn get url => text()();
+  TextColumn get title => text()();
+  TextColumn get description => text()();
+  TextColumn get notes => text().nullable()();
+  TextColumn get tags => text().map(const StrongRefConverter()).nullable()();
+  BoolColumn get unlisted => boolean()();
+  BoolColumn get unread => boolean().nullable()();
+  TextColumn get languages =>
+      text().map(const StringArrayConverter()).nullable()();
+  DateTimeColumn get createdAt => dateTime()();
+  @override
+  Set<Column<Object>> get primaryKey => {timestamp};
+}
+
+class Tags extends Table {
+  DateTimeColumn get timestamp =>
+      dateTime().named("time_us").withDefault(currentDateAndTime)();
+  TextColumn get did => text()();
+  TextColumn get recordKey => text().named('rkey')();
+  TextColumn get name => text()();
+  TextColumn get color => text().nullable()();
+  DateTimeColumn get createdAt => dateTime()();
+  @override
+  Set<Column<Object>> get primaryKey => {timestamp};
+}
+
+@DriftDatabase(tables: [Clips])
+class AppDatabase extends _$AppDatabase {
+  AppDatabase([QueryExecutor? executor]) : super(executor ?? _openConnection());
+
+  @override
+  int get schemaVersion => 1;
+
+  static QueryExecutor _openConnection() {
+    return NativeDatabase.createInBackground(File(Config.getDatabaseName()));
+  }
+}
+
+/// Convert an array of strings to and from JSON for Drift.
+class StringArrayConverter extends TypeConverter<List<String>, String> {
+  const StringArrayConverter();
+
+  @override
+  List<String> fromSql(String fromDb) {
+    return (jsonDecode(fromDb) as List<dynamic>).cast<String>();
+  }
+
+  @override
+  String toSql(List<String> value) {
+    return jsonEncode(value);
+  }
+}
+
+/// Convert [StrongRef] to and from JSON for Drift.
+class StrongRefConverter extends TypeConverter<StrongRef, String> {
+  const StrongRefConverter();
+
+  @override
+  StrongRef fromSql(String fromDb) {
+    final map = jsonDecode(fromDb);
+    return StrongRef.fromJson(map);
+  }
+
+  @override
+  String toSql(StrongRef value) {
+    return jsonEncode(value.toJson());
+  }
+}

backend/lib/db/database.g.dart

···
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'database.dart';
+
+// ignore_for_file: type=lint
+class $ClipsTable extends Clips with TableInfo<$ClipsTable, Clip> {
+  @override
+  final GeneratedDatabase attachedDatabase;
+  final String? _alias;
+  $ClipsTable(this.attachedDatabase, [this._alias]);
+  static const VerificationMeta _timestampMeta = const VerificationMeta(
+    'timestamp',
+  );
+  @override
+  late final GeneratedColumn<DateTime> timestamp = GeneratedColumn<DateTime>(
+    'time_us',
+    aliasedName,
+    false,
+    type: DriftSqlType.dateTime,
+    requiredDuringInsert: false,
+    defaultValue: currentDateAndTime,
+  );
+  static const VerificationMeta _didMeta = const VerificationMeta('did');
+  @override
+  late final GeneratedColumn<String> did = GeneratedColumn<String>(
+    'did',
+    aliasedName,
+    false,
+    type: DriftSqlType.string,
+    requiredDuringInsert: true,
+  );
+  static const VerificationMeta _recordKeyMeta = const VerificationMeta(
+    'recordKey',
+  );
+  @override
+  late final GeneratedColumn<String> recordKey = GeneratedColumn<String>(
+    'rkey',
+    aliasedName,
+    false,
+    type: DriftSqlType.string,
+    requiredDuringInsert: true,
+  );
+  static const VerificationMeta _urlMeta = const VerificationMeta('url');
+  @override
+  late final GeneratedColumn<String> url = GeneratedColumn<String>(
+    'url',
+    aliasedName,
+    false,
+    type: DriftSqlType.string,
+    requiredDuringInsert: true,
+  );
+  static const VerificationMeta _titleMeta = const VerificationMeta('title');
+  @override
+  late final GeneratedColumn<String> title = GeneratedColumn<String>(
+    'title',
+    aliasedName,
+    false,
+    type: DriftSqlType.string,
+    requiredDuringInsert: true,
+  );
+  static const VerificationMeta _descriptionMeta = const VerificationMeta(
+    'description',
+  );
+  @override
+  late final GeneratedColumn<String> description = GeneratedColumn<String>(
+    'description',
+    aliasedName,
+    false,
+    type: DriftSqlType.string,
+    requiredDuringInsert: true,
+  );
+  static const VerificationMeta _notesMeta = const VerificationMeta('notes');
+  @override
+  late final GeneratedColumn<String> notes = GeneratedColumn<String>(
+    'notes',
+    aliasedName,
+    true,
+    type: DriftSqlType.string,
+    requiredDuringInsert: false,
+  );
+  @override
+  late final GeneratedColumnWithTypeConverter<StrongRef?, String> tags =
+      GeneratedColumn<String>(
+        'tags',
+        aliasedName,
+        true,
+        type: DriftSqlType.string,
+        requiredDuringInsert: false,
+      ).withConverter<StrongRef?>($ClipsTable.$convertertagsn);
+  static const VerificationMeta _unlistedMeta = const VerificationMeta(
+    'unlisted',
+  );
+  @override
+  late final GeneratedColumn<bool> unlisted = GeneratedColumn<bool>(
+    'unlisted',
+    aliasedName,
+    false,
+    type: DriftSqlType.bool,
+    requiredDuringInsert: true,
+    defaultConstraints: GeneratedColumn.constraintIsAlways(
+      'CHECK ("unlisted" IN (0, 1))',
+    ),
+  );
+  static const VerificationMeta _unreadMeta = const VerificationMeta('unread');
+  @override
+  late final GeneratedColumn<bool> unread = GeneratedColumn<bool>(
+    'unread',
+    aliasedName,
+    true,
+    type: DriftSqlType.bool,
+    requiredDuringInsert: false,
+    defaultConstraints: GeneratedColumn.constraintIsAlways(
+      'CHECK ("unread" IN (0, 1))',
+    ),
+  );
+  @override
+  late final GeneratedColumnWithTypeConverter<List<String>?, String> languages =
+      GeneratedColumn<String>(
+        'languages',
+        aliasedName,
+        true,
+        type: DriftSqlType.string,
+        requiredDuringInsert: false,
+      ).withConverter<List<String>?>($ClipsTable.$converterlanguagesn);
+  static const VerificationMeta _createdAtMeta = const VerificationMeta(
+    'createdAt',
+  );
+  @override
+  late final GeneratedColumn<DateTime> createdAt = GeneratedColumn<DateTime>(
+    'created_at',
+    aliasedName,
+    false,
+    type: DriftSqlType.dateTime,
+    requiredDuringInsert: true,
+  );
+  @override
+  List<GeneratedColumn> get $columns => [
+    timestamp,
+    did,
+    recordKey,
+    url,
+    title,
+    description,
+    notes,
+    tags,
+    unlisted,
+    unread,
+    languages,
+    createdAt,
+  ];
+  @override
+  String get aliasedName => _alias ?? actualTableName;
+  @override
+  String get actualTableName => $name;
+  static const String $name = 'clips';
+  @override
+  VerificationContext validateIntegrity(
+    Insertable<Clip> instance, {
+    bool isInserting = false,
+  }) {
+    final context = VerificationContext();
+    final data = instance.toColumns(true);
+    if (data.containsKey('time_us')) {
+      context.handle(
+        _timestampMeta,
+        timestamp.isAcceptableOrUnknown(data['time_us']!, _timestampMeta),
+      );
+    }
+    if (data.containsKey('did')) {
+      context.handle(
+        _didMeta,
+        did.isAcceptableOrUnknown(data['did']!, _didMeta),
+      );
+    } else if (isInserting) {
+      context.missing(_didMeta);
+    }
+    if (data.containsKey('rkey')) {
+      context.handle(
+        _recordKeyMeta,
+        recordKey.isAcceptableOrUnknown(data['rkey']!, _recordKeyMeta),
+      );
+    } else if (isInserting) {
+      context.missing(_recordKeyMeta);
+    }
+    if (data.containsKey('url')) {
+      context.handle(
+        _urlMeta,
+        url.isAcceptableOrUnknown(data['url']!, _urlMeta),
+      );
+    } else if (isInserting) {
+      context.missing(_urlMeta);
+    }
+    if (data.containsKey('title')) {
+      context.handle(
+        _titleMeta,
+        title.isAcceptableOrUnknown(data['title']!, _titleMeta),
+      );
+    } else if (isInserting) {
+      context.missing(_titleMeta);
+    }
+    if (data.containsKey('description')) {
+      context.handle(
+        _descriptionMeta,
+        description.isAcceptableOrUnknown(
+          data['description']!,
+          _descriptionMeta,
+        ),
+      );
+    } else if (isInserting) {
+      context.missing(_descriptionMeta);
+    }
+    if (data.containsKey('notes')) {
+      context.handle(
+        _notesMeta,
+        notes.isAcceptableOrUnknown(data['notes']!, _notesMeta),
+      );
+    }
+    if (data.containsKey('unlisted')) {
+      context.handle(
+        _unlistedMeta,
+        unlisted.isAcceptableOrUnknown(data['unlisted']!, _unlistedMeta),
+      );
+    } else if (isInserting) {
+      context.missing(_unlistedMeta);
+    }
+    if (data.containsKey('unread')) {
+      context.handle(
+        _unreadMeta,
+        unread.isAcceptableOrUnknown(data['unread']!, _unreadMeta),
+      );
+    }
+    if (data.containsKey('created_at')) {
+      context.handle(
+        _createdAtMeta,
+        createdAt.isAcceptableOrUnknown(data['created_at']!, _createdAtMeta),
+      );
+    } else if (isInserting) {
+      context.missing(_createdAtMeta);
+    }
+    return context;
+  }
+
+  @override
+  Set<GeneratedColumn> get $primaryKey => {timestamp};
+  @override
+  Clip map(Map<String, dynamic> data, {String? tablePrefix}) {
+    final effectivePrefix = tablePrefix != null ? '$tablePrefix.' : '';
+    return Clip(
+      timestamp: attachedDatabase.typeMapping.read(
+        DriftSqlType.dateTime,
+        data['${effectivePrefix}time_us'],
+      )!,
+      did: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}did'],
+      )!,
+      recordKey: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}rkey'],
+      )!,
+      url: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}url'],
+      )!,
+      title: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}title'],
+      )!,
+      description: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}description'],
+      )!,
+      notes: attachedDatabase.typeMapping.read(
+        DriftSqlType.string,
+        data['${effectivePrefix}notes'],
+      ),
+      tags: $ClipsTable.$convertertagsn.fromSql(
+        attachedDatabase.typeMapping.read(
+          DriftSqlType.string,
+          data['${effectivePrefix}tags'],
+        ),
+      ),
+      unlisted: attachedDatabase.typeMapping.read(
+        DriftSqlType.bool,
+        data['${effectivePrefix}unlisted'],
+      )!,
+      unread: attachedDatabase.typeMapping.read(
+        DriftSqlType.bool,
+        data['${effectivePrefix}unread'],
+      ),
+      languages: $ClipsTable.$converterlanguagesn.fromSql(
+        attachedDatabase.typeMapping.read(
+          DriftSqlType.string,
+          data['${effectivePrefix}languages'],
+        ),
+      ),
+      createdAt: attachedDatabase.typeMapping.read(
+        DriftSqlType.dateTime,
+        data['${effectivePrefix}created_at'],
+      )!,
+    );
+  }
+
+  @override
+  $ClipsTable createAlias(String alias) {
+    return $ClipsTable(attachedDatabase, alias);
+  }
+
+  static TypeConverter<StrongRef, String> $convertertags =
+      const StrongRefConverter();
+  static TypeConverter<StrongRef?, String?> $convertertagsn =
+      NullAwareTypeConverter.wrap($convertertags);
+  static TypeConverter<List<String>, String> $converterlanguages =
+      const StringArrayConverter();
+  static TypeConverter<List<String>?, String?> $converterlanguagesn =
+      NullAwareTypeConverter.wrap($converterlanguages);
+}
+
+class Clip extends DataClass implements Insertable<Clip> {
+  final DateTime timestamp;
+  final String did;
+  final String recordKey;
+  final String url;
+  final String title;
+  final String description;
+  final String? notes;
+  final StrongRef? tags;
+  final bool unlisted;
+  final bool? unread;
+  final List<String>? languages;
+  final DateTime createdAt;
+  const Clip({
+    required this.timestamp,
+    required this.did,
+    required this.recordKey,
+    required this.url,
+    required this.title,
+    required this.description,
+    this.notes,
+    this.tags,
+    required this.unlisted,
+    this.unread,
+    this.languages,
+    required this.createdAt,
+  });
+  @override
+  Map<String, Expression> toColumns(bool nullToAbsent) {
+    final map = <String, Expression>{};
+    map['time_us'] = Variable<DateTime>(timestamp);
+    map['did'] = Variable<String>(did);
+    map['rkey'] = Variable<String>(recordKey);
+    map['url'] = Variable<String>(url);
+    map['title'] = Variable<String>(title);
+    map['description'] = Variable<String>(description);
+    if (!nullToAbsent || notes != null) {
+      map['notes'] = Variable<String>(notes);
+    }
+    if (!nullToAbsent || tags != null) {
+      map['tags'] = Variable<String>($ClipsTable.$convertertagsn.toSql(tags));
+    }
+    map['unlisted'] = Variable<bool>(unlisted);
+    if (!nullToAbsent || unread != null) {
+      map['unread'] = Variable<bool>(unread);
+    }
+    if (!nullToAbsent || languages != null) {
+      map['languages'] = Variable<String>(
+        $ClipsTable.$converterlanguagesn.toSql(languages),
+      );
+    }
+    map['created_at'] = Variable<DateTime>(createdAt);
+    return map;
+  }
+
+  ClipsCompanion toCompanion(bool nullToAbsent) {
+    return ClipsCompanion(
+      timestamp: Value(timestamp),
+      did: Value(did),
+      recordKey: Value(recordKey),
+      url: Value(url),
+      title: Value(title),
+      description: Value(description),
+      notes: notes == null && nullToAbsent
+          ? const Value.absent()
+          : Value(notes),
+      tags: tags == null && nullToAbsent ? const Value.absent() : Value(tags),
+      unlisted: Value(unlisted),
+      unread: unread == null && nullToAbsent
+          ? const Value.absent()
+          : Value(unread),
+      languages: languages == null && nullToAbsent
+          ? const Value.absent()
+          : Value(languages),
+      createdAt: Value(createdAt),
+    );
+  }
+
+  factory Clip.fromJson(
+    Map<String, dynamic> json, {
+    ValueSerializer? serializer,
+  }) {
+    serializer ??= driftRuntimeOptions.defaultSerializer;
+    return Clip(
+      timestamp: serializer.fromJson<DateTime>(json['timestamp']),
+      did: serializer.fromJson<String>(json['did']),
+      recordKey: serializer.fromJson<String>(json['recordKey']),
+      url: serializer.fromJson<String>(json['url']),
+      title: serializer.fromJson<String>(json['title']),
+      description: serializer.fromJson<String>(json['description']),
+      notes: serializer.fromJson<String?>(json['notes']),
+      tags: serializer.fromJson<StrongRef?>(json['tags']),
+      unlisted: serializer.fromJson<bool>(json['unlisted']),
+      unread: serializer.fromJson<bool?>(json['unread']),
+      languages: serializer.fromJson<List<String>?>(json['languages']),
+      createdAt: serializer.fromJson<DateTime>(json['createdAt']),
+    );
+  }
+  @override
+  Map<String, dynamic> toJson({ValueSerializer? serializer}) {
+    serializer ??= driftRuntimeOptions.defaultSerializer;
+    return <String, dynamic>{
+      'timestamp': serializer.toJson<DateTime>(timestamp),
+      'did': serializer.toJson<String>(did),
+      'recordKey': serializer.toJson<String>(recordKey),
+      'url': serializer.toJson<String>(url),
+      'title': serializer.toJson<String>(title),
+      'description': serializer.toJson<String>(description),
+      'notes': serializer.toJson<String?>(notes),
+      'tags': serializer.toJson<StrongRef?>(tags),
+      'unlisted': serializer.toJson<bool>(unlisted),
+      'unread': serializer.toJson<bool?>(unread),
+      'languages': serializer.toJson<List<String>?>(languages),
+      'createdAt': serializer.toJson<DateTime>(createdAt),
+    };
+  }
+
+  Clip copyWith({
+    DateTime? timestamp,
+    String? did,
+    String? recordKey,
+    String? url,
+    String? title,
+    String? description,
+    Value<String?> notes = const Value.absent(),
+    Value<StrongRef?> tags = const Value.absent(),
+    bool? unlisted,
+    Value<bool?> unread = const Value.absent(),
+    Value<List<String>?> languages = const Value.absent(),
+    DateTime? createdAt,
+  }) => Clip(
+    timestamp: timestamp ?? this.timestamp,
+    did: did ?? this.did,
+    recordKey: recordKey ?? this.recordKey,
+    url: url ?? this.url,
+    title: title ?? this.title,
+    description: description ?? this.description,
+    notes: notes.present ? notes.value : this.notes,
+    tags: tags.present ? tags.value : this.tags,
+    unlisted: unlisted ?? this.unlisted,
+    unread: unread.present ? unread.value : this.unread,
+    languages: languages.present ? languages.value : this.languages,
+    createdAt: createdAt ?? this.createdAt,
+  );
+  Clip copyWithCompanion(ClipsCompanion data) {
+    return Clip(
+      timestamp: data.timestamp.present ? data.timestamp.value : this.timestamp,
+      did: data.did.present ? data.did.value : this.did,
+      recordKey: data.recordKey.present ? data.recordKey.value : this.recordKey,
+      url: data.url.present ? data.url.value : this.url,
+      title: data.title.present ? data.title.value : this.title,
+      description: data.description.present
+          ? data.description.value
+          : this.description,
+      notes: data.notes.present ? data.notes.value : this.notes,
+      tags: data.tags.present ? data.tags.value : this.tags,
+      unlisted: data.unlisted.present ? data.unlisted.value : this.unlisted,
+      unread: data.unread.present ? data.unread.value : this.unread,
+      languages: data.languages.present ? data.languages.value : this.languages,
+      createdAt: data.createdAt.present ? data.createdAt.value : this.createdAt,
+    );
+  }
+
+  @override
+  String toString() {
+    return (StringBuffer('Clip(')
+          ..write('timestamp: $timestamp, ')
+          ..write('did: $did, ')
+          ..write('recordKey: $recordKey, ')
+          ..write('url: $url, ')
+          ..write('title: $title, ')
+          ..write('description: $description, ')
+          ..write('notes: $notes, ')
+          ..write('tags: $tags, ')
+          ..write('unlisted: $unlisted, ')
+          ..write('unread: $unread, ')
+          ..write('languages: $languages, ')
+          ..write('createdAt: $createdAt')
+          ..write(')'))
+        .toString();
+  }
+
+  @override
+  int get hashCode => Object.hash(
+    timestamp,
+    did,
+    recordKey,
+    url,
+    title,
+    description,
+    notes,
+    tags,
+    unlisted,
+    unread,
+    languages,
+    createdAt,
+  );
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      (other is Clip &&
+          other.timestamp == this.timestamp &&
+          other.did == this.did &&
+          other.recordKey == this.recordKey &&
+          other.url == this.url &&
+          other.title == this.title &&
+          other.description == this.description &&
+          other.notes == this.notes &&
+          other.tags == this.tags &&
+          other.unlisted == this.unlisted &&
+          other.unread == this.unread &&
+          other.languages == this.languages &&
+          other.createdAt == this.createdAt);
+}
+
+class ClipsCompanion extends UpdateCompanion<Clip> {
+  final Value<DateTime> timestamp;
+  final Value<String> did;
+  final Value<String> recordKey;
+  final Value<String> url;
+  final Value<String> title;
+  final Value<String> description;
+  final Value<String?> notes;
+  final Value<StrongRef?> tags;
+  final Value<bool> unlisted;
+  final Value<bool?> unread;
+  final Value<List<String>?> languages;
+  final Value<DateTime> createdAt;
+  final Value<int> rowid;
+  const ClipsCompanion({
+    this.timestamp = const Value.absent(),
+    this.did = const Value.absent(),
+    this.recordKey = const Value.absent(),
+    this.url = const Value.absent(),
+    this.title = const Value.absent(),
+    this.description = const Value.absent(),
+    this.notes = const Value.absent(),
+    this.tags = const Value.absent(),
+    this.unlisted = const Value.absent(),
+    this.unread = const Value.absent(),
+    this.languages = const Value.absent(),
+    this.createdAt = const Value.absent(),
+    this.rowid = const Value.absent(),
+  });
+  ClipsCompanion.insert({
+    this.timestamp = const Value.absent(),
+    required String did,
+    required String recordKey,
+    required String url,
+    required String title,
+    required String description,
+    this.notes = const Value.absent(),
+    this.tags = const Value.absent(),
+    required bool unlisted,
+    this.unread = const Value.absent(),
+    this.languages = const Value.absent(),
+    required DateTime createdAt,
+    this.rowid = const Value.absent(),
+  }) : did = Value(did),
+       recordKey = Value(recordKey),
+       url = Value(url),
+       title = Value(title),
+       description = Value(description),
+       unlisted = Value(unlisted),
+       createdAt = Value(createdAt);
+  static Insertable<Clip> custom({
+    Expression<DateTime>? timestamp,
+    Expression<String>? did,
+    Expression<String>? recordKey,
+    Expression<String>? url,
+    Expression<String>? title,
+    Expression<String>? description,
+    Expression<String>? notes,
+    Expression<String>? tags,
+    Expression<bool>? unlisted,
+    Expression<bool>? unread,
+    Expression<String>? languages,
+    Expression<DateTime>? createdAt,
+    Expression<int>? rowid,
+  }) {
+    return RawValuesInsertable({
+      if (timestamp != null) 'time_us': timestamp,
+      if (did != null) 'did': did,
+      if (recordKey != null) 'rkey': recordKey,
+      if (url != null) 'url': url,
+      if (title != null) 'title': title,
+      if (description != null) 'description': description,
+      if (notes != null) 'notes': notes,
+      if (tags != null) 'tags': tags,
+      if (unlisted != null) 'unlisted': unlisted,
+      if (unread != null) 'unread': unread,
+      if (languages != null) 'languages': languages,
+      if (createdAt != null) 'created_at': createdAt,
+      if (rowid != null) 'rowid': rowid,
+    });
+  }
+
+  ClipsCompanion copyWith({
+    Value<DateTime>? timestamp,
+    Value<String>? did,
+    Value<String>? recordKey,
+    Value<String>? url,
+    Value<String>? title,
+    Value<String>? description,
+    Value<String?>? notes,
+    Value<StrongRef?>? tags,
+    Value<bool>? unlisted,
+    Value<bool?>? unread,
+    Value<List<String>?>? languages,
+    Value<DateTime>? createdAt,
+    Value<int>? rowid,
+  }) {
+    return ClipsCompanion(
+      timestamp: timestamp ?? this.timestamp,
+      did: did ?? this.did,
+      recordKey: recordKey ?? this.recordKey,
+      url: url ?? this.url,
+      title: title ?? this.title,
+      description: description ?? this.description,
+      notes: notes ?? this.notes,
+      tags: tags ?? this.tags,
+      unlisted: unlisted ?? this.unlisted,
+      unread: unread ?? this.unread,
+      languages: languages ?? this.languages,
+      createdAt: createdAt ?? this.createdAt,
+      rowid: rowid ?? this.rowid,
+    );
+  }
+
+  @override
+  Map<String, Expression> toColumns(bool nullToAbsent) {
+    final map = <String, Expression>{};
+    if (timestamp.present) {
+      map['time_us'] = Variable<DateTime>(timestamp.value);
+    }
+    if (did.present) {
+      map['did'] = Variable<String>(did.value);
+    }
+    if (recordKey.present) {
+      map['rkey'] = Variable<String>(recordKey.value);
+    }
+    if (url.present) {
+      map['url'] = Variable<String>(url.value);
+    }
+    if (title.present) {
+      map['title'] = Variable<String>(title.value);
+    }
+    if (description.present) {
+      map['description'] = Variable<String>(description.value);
+    }
+    if (notes.present) {
+      map['notes'] = Variable<String>(notes.value);
+    }
+    if (tags.present) {
+      map['tags'] = Variable<String>(
+        $ClipsTable.$convertertagsn.toSql(tags.value),
+      );
+    }
+    if (unlisted.present) {
+      map['unlisted'] = Variable<bool>(unlisted.value);
+    }
+    if (unread.present) {
+      map['unread'] = Variable<bool>(unread.value);
+    }
+    if (languages.present) {
+      map['languages'] = Variable<String>(
+        $ClipsTable.$converterlanguagesn.toSql(languages.value),
+      );
+    }
+    if (createdAt.present) {
+      map['created_at'] = Variable<DateTime>(createdAt.value);
+    }
+    if (rowid.present) {
+      map['rowid'] = Variable<int>(rowid.value);
+    }
+    return map;
+  }
+
+  @override
+  String toString() {
+    return (StringBuffer('ClipsCompanion(')
+          ..write('timestamp: $timestamp, ')
+          ..write('did: $did, ')
+          ..write('recordKey: $recordKey, ')
+          ..write('url: $url, ')
+          ..write('title: $title, ')
+          ..write('description: $description, ')
+          ..write('notes: $notes, ')
+          ..write('tags: $tags, ')
+          ..write('unlisted: $unlisted, ')
+          ..write('unread: $unread, ')
+          ..write('languages: $languages, ')
+          ..write('createdAt: $createdAt, ')
+          ..write('rowid: $rowid')
+          ..write(')'))
+        .toString();
+  }
+}
+
+abstract class _$AppDatabase extends GeneratedDatabase {
+  _$AppDatabase(QueryExecutor e) : super(e);
+  $AppDatabaseManager get managers => $AppDatabaseManager(this);
+  late final $ClipsTable clips = $ClipsTable(this);
+  @override
+  Iterable<TableInfo<Table, Object?>> get allTables =>
+      allSchemaEntities.whereType<TableInfo<Table, Object?>>();
+  @override
+  List<DatabaseSchemaEntity> get allSchemaEntities => [clips];
+}
+
+typedef $$ClipsTableCreateCompanionBuilder =
+    ClipsCompanion Function({
+      Value<DateTime> timestamp,
+      required String did,
+      required String recordKey,
+      required String url,
+      required String title,
+      required String description,
+      Value<String?> notes,
+      Value<StrongRef?> tags,
+      required bool unlisted,
+      Value<bool?> unread,
+      Value<List<String>?> languages,
+      required DateTime createdAt,
+      Value<int> rowid,
+    });
+typedef $$ClipsTableUpdateCompanionBuilder =
+    ClipsCompanion Function({
+      Value<DateTime> timestamp,
+      Value<String> did,
+      Value<String> recordKey,
+      Value<String> url,
+      Value<String> title,
+      Value<String> description,
+      Value<String?> notes,
+      Value<StrongRef?> tags,
+      Value<bool> unlisted,
+      Value<bool?> unread,
+      Value<List<String>?> languages,
+      Value<DateTime> createdAt,
+      Value<int> rowid,
+    });
+
+class $$ClipsTableFilterComposer extends Composer<_$AppDatabase, $ClipsTable> {
+  $$ClipsTableFilterComposer({
+    required super.$db,
+    required super.$table,
+    super.joinBuilder,
+    super.$addJoinBuilderToRootComposer,
+    super.$removeJoinBuilderFromRootComposer,
+  });
+  ColumnFilters<DateTime> get timestamp => $composableBuilder(
+    column: $table.timestamp,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get did => $composableBuilder(
+    column: $table.did,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get recordKey => $composableBuilder(
+    column: $table.recordKey,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get url => $composableBuilder(
+    column: $table.url,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get title => $composableBuilder(
+    column: $table.title,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get description => $composableBuilder(
+    column: $table.description,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<String> get notes => $composableBuilder(
+    column: $table.notes,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnWithTypeConverterFilters<StrongRef?, StrongRef, String> get tags =>
+      $composableBuilder(
+        column: $table.tags,
+        builder: (column) => ColumnWithTypeConverterFilters(column),
+      );
+
+  ColumnFilters<bool> get unlisted => $composableBuilder(
+    column: $table.unlisted,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnFilters<bool> get unread => $composableBuilder(
+    column: $table.unread,
+    builder: (column) => ColumnFilters(column),
+  );
+
+  ColumnWithTypeConverterFilters<List<String>?, List<String>, String>
+  get languages => $composableBuilder(
+    column: $table.languages,
+    builder: (column) => ColumnWithTypeConverterFilters(column),
+  );
+
+  ColumnFilters<DateTime> get createdAt => $composableBuilder(
+    column: $table.createdAt,
+    builder: (column) => ColumnFilters(column),
+  );
+}
+
+class $$ClipsTableOrderingComposer
+    extends Composer<_$AppDatabase, $ClipsTable> {
+  $$ClipsTableOrderingComposer({
+    required super.$db,
+    required super.$table,
+    super.joinBuilder,
+    super.$addJoinBuilderToRootComposer,
+    super.$removeJoinBuilderFromRootComposer,
+  });
+  ColumnOrderings<DateTime> get timestamp => $composableBuilder(
+    column: $table.timestamp,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get did => $composableBuilder(
+    column: $table.did,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get recordKey => $composableBuilder(
+    column: $table.recordKey,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get url => $composableBuilder(
+    column: $table.url,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get title => $composableBuilder(
+    column: $table.title,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get description => $composableBuilder(
+    column: $table.description,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get notes => $composableBuilder(
+    column: $table.notes,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get tags => $composableBuilder(
+    column: $table.tags,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<bool> get unlisted => $composableBuilder(
+    column: $table.unlisted,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<bool> get unread => $composableBuilder(
+    column: $table.unread,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<String> get languages => $composableBuilder(
+    column: $table.languages,
+    builder: (column) => ColumnOrderings(column),
+  );
+
+  ColumnOrderings<DateTime> get createdAt => $composableBuilder(
+    column: $table.createdAt,
+    builder: (column) => ColumnOrderings(column),
+  );
+}
+
+class $$ClipsTableAnnotationComposer
+    extends Composer<_$AppDatabase, $ClipsTable> {
+  $$ClipsTableAnnotationComposer({
+    required super.$db,
+    required super.$table,
+    super.joinBuilder,
+    super.$addJoinBuilderToRootComposer,
+    super.$removeJoinBuilderFromRootComposer,
+  });
+  GeneratedColumn<DateTime> get timestamp =>
+      $composableBuilder(column: $table.timestamp, builder: (column) => column);
+
+  GeneratedColumn<String> get did =>
+      $composableBuilder(column: $table.did, builder: (column) => column);
+
+  GeneratedColumn<String> get recordKey =>
+      $composableBuilder(column: $table.recordKey, builder: (column) => column);
+
+  GeneratedColumn<String> get url =>
+      $composableBuilder(column: $table.url, builder: (column) => column);
+
+  GeneratedColumn<String> get title =>
+      $composableBuilder(column: $table.title, builder: (column) => column);
+
+  GeneratedColumn<String> get description => $composableBuilder(
+    column: $table.description,
+    builder: (column) => column,
+  );
+
+  GeneratedColumn<String> get notes =>
+      $composableBuilder(column: $table.notes, builder: (column) => column);
+
+  GeneratedColumnWithTypeConverter<StrongRef?, String> get tags =>
+      $composableBuilder(column: $table.tags, builder: (column) => column);
+
+  GeneratedColumn<bool> get unlisted =>
+      $composableBuilder(column: $table.unlisted, builder: (column) => column);
+
+  GeneratedColumn<bool> get unread =>
+      $composableBuilder(column: $table.unread, builder: (column) => column);
+
+  GeneratedColumnWithTypeConverter<List<String>?, String> get languages =>
+      $composableBuilder(column: $table.languages, builder: (column) => column);
+
+  GeneratedColumn<DateTime> get createdAt =>
+      $composableBuilder(column: $table.createdAt, builder: (column) => column);
+}
+
+class $$ClipsTableTableManager
+    extends
+        RootTableManager<
+          _$AppDatabase,
+          $ClipsTable,
+          Clip,
+          $$ClipsTableFilterComposer,
+          $$ClipsTableOrderingComposer,
+          $$ClipsTableAnnotationComposer,
+          $$ClipsTableCreateCompanionBuilder,
+          $$ClipsTableUpdateCompanionBuilder,
+          (Clip, BaseReferences<_$AppDatabase, $ClipsTable, Clip>),
+          Clip,
+          PrefetchHooks Function()
+        > {
+  $$ClipsTableTableManager(_$AppDatabase db, $ClipsTable table)
+    : super(
+        TableManagerState(
+          db: db,
+          table: table,
+          createFilteringComposer: () =>
+              $$ClipsTableFilterComposer($db: db, $table: table),
+          createOrderingComposer: () =>
+              $$ClipsTableOrderingComposer($db: db, $table: table),
+          createComputedFieldComposer: () =>
+              $$ClipsTableAnnotationComposer($db: db, $table: table),
+          updateCompanionCallback:
+              ({
+                Value<DateTime> timestamp = const Value.absent(),
+                Value<String> did = const Value.absent(),
+                Value<String> recordKey = const Value.absent(),
+                Value<String> url = const Value.absent(),
+                Value<String> title = const Value.absent(),
+                Value<String> description = const Value.absent(),
+                Value<String?> notes = const Value.absent(),
+                Value<StrongRef?> tags = const Value.absent(),
+                Value<bool> unlisted = const Value.absent(),
+                Value<bool?> unread = const Value.absent(),
+                Value<List<String>?> languages = const Value.absent(),
+                Value<DateTime> createdAt = const Value.absent(),
+                Value<int> rowid = const Value.absent(),
+              }) => ClipsCompanion(
+                timestamp: timestamp,
+                did: did,
+                recordKey: recordKey,
+                url: url,
+                title: title,
+                description: description,
+                notes: notes,
+                tags: tags,
+                unlisted: unlisted,
+                unread: unread,
+                languages: languages,
+                createdAt: createdAt,
+                rowid: rowid,
+              ),
+          createCompanionCallback:
+              ({
+                Value<DateTime> timestamp = const Value.absent(),
+                required String did,
+                required String recordKey,
+                required String url,
+                required String title,
+                required String description,
+                Value<String?> notes = const Value.absent(),
+                Value<StrongRef?> tags = const Value.absent(),
+                required bool unlisted,
+                Value<bool?> unread = const Value.absent(),
+                Value<List<String>?> languages = const Value.absent(),
+                required DateTime createdAt,
+                Value<int> rowid = const Value.absent(),
+              }) => ClipsCompanion.insert(
+                timestamp: timestamp,
+                did: did,
+                recordKey: recordKey,
+                url: url,
+                title: title,
+                description: description,
+                notes: notes,
+                tags: tags,
+                unlisted: unlisted,
+                unread: unread,
+                languages: languages,
+                createdAt: createdAt,
+                rowid: rowid,
+              ),
+          withReferenceMapper: (p0) => p0
+              .map((e) => (e.readTable(table), BaseReferences(db, table, e)))
+              .toList(),
+          prefetchHooksCallback: null,
+        ),
+      );
+}
+
+typedef $$ClipsTableProcessedTableManager =
+    ProcessedTableManager<
+      _$AppDatabase,
+      $ClipsTable,
+      Clip,
+      $$ClipsTableFilterComposer,
+      $$ClipsTableOrderingComposer,
+      $$ClipsTableAnnotationComposer,
+      $$ClipsTableCreateCompanionBuilder,
+      $$ClipsTableUpdateCompanionBuilder,
+      (Clip, BaseReferences<_$AppDatabase, $ClipsTable, Clip>),
+      Clip,
+      PrefetchHooks Function()
+    >;
+
+class $AppDatabaseManager {
+  final _$AppDatabase _db;
+  $AppDatabaseManager(this._db);
+  $$ClipsTableTableManager get clips =>
+      $$ClipsTableTableManager(_db, _db.clips);
+}

backend/lib/lexicons/social/clippr/clips/item.json backend/lexicons/social/clippr/clips/item.json

···
             "description": "An array of tags. A format of solely alphanumeric characters and dashes should be used.",
             "items": {
               "type": "ref",
-              "ref": "social.clippr.clips.tag"
+              "ref": "com.atproto.repo.strongRef"
             }
           },
           "unlisted": {

backend/lib/server/firehose.dart

···
 /// As such, new instances should be created as little as possible.
 class Firehose {
   /// [Uri] containing a link to the firehose's WebSocket subscription link.
-  late final Uri firehoseProvider;
+  static late final Uri firehoseProvider;
   /// Raw WebSocket stream
-  late final WebSocketChannel _channel;
+  static late final WebSocketChannel _channel;
   /// Controllable version of stream
-  final StreamController<Map<String, dynamic>> _messageController =
+  static final StreamController<Map<String, dynamic>> _messageController =
       StreamController.broadcast();
   /// Stream of messages to access from other places
-  Stream<Map<String, dynamic>> get messageStream => _messageController.stream;
+  static Stream<Map<String, dynamic>> get messageStream => _messageController.stream;
 
   /// Create a new [Firehose] instance using a provided URL string.
   Firehose(String firehoseUrl) {

backend/lib/server/server.dart

···
  */
 
 import 'dart:io';
+import 'package:clippr/db/database.dart';
 import 'package:clippr/server/firehose.dart';
 import 'package:clippr/server/logger.dart';
 import 'package:clippr/server/routes.dart';
···
 import 'package:shelf_router/shelf_router.dart';
 import 'package:shelf_router_classes/shelf_router_classes.dart';
 
-void launchServer() async {
+void launchWebServer() async {
   Router router = getRoutersByClass([MiscRouter, OAuthRouter, XrpcRouter]);
   final app = const Pipeline()
       .addMiddleware(serverLogger())
       .addHandler(router.call);
 
   HttpServer _ = await io.serve(app, Config.getHostname(), Config.getPort());
+}
 
+void launchDatabase() {
+  var database = AppDatabase();
+}
+
+void launchFirehose() {
   var firehose = Firehose(Config.getFirehoseProvider());
   firehose.connect();
-  firehose.messageStream.listen((message) {
-    print(message);
-  });
+  // Firehose.messageStream.listen((message) {
+  //   print(message);
+  // });
 }
 
 Middleware serverLogger() {
···
         final response = await innerHandler(request);
         final endTime = DateTime.now();
         final duration = endTime.difference(startTime); // Time to serve route
-        Logger.logFine('${request.method} ${request.requestedUri.path} [${response.statusCode}] in $duration');
+        Logger.logFine(
+          '${request.method} ${request.requestedUri.path} [${response.statusCode}] in $duration',
+        );
         return response;
       } catch (e, stackTrace) {
-        Logger.logSevere('Error handling ${request.method} ${request.requestedUri.path}', e, stackTrace);
+        Logger.logSevere(
+          'Error handling ${request.method} ${request.requestedUri.path}',
+          e,
+          stackTrace,
+        );
         rethrow;
       }
     };
   };
-}
+}

backend/pubspec.lock

···
     dependency: transitive
     description:
       name: build
-      sha256: "8295b0b6dfe00499b786718f2936a56b5e0d56d169c528472c8c1908f2b1e3ee"
+      sha256: "486337d40a48d75049f2a01efceefc1412e3a6d6342d39624753e7d5a4e70016"
       url: "https://pub.dev"
     source: hosted
-    version: "2.5.0"
+    version: "2.5.1"
   build_config:
     dependency: transitive
     description:
···
     dependency: transitive
     description:
       name: build_resolvers
-      sha256: "57fe2f9149b01d52fcd0ea7de17083739b5cf9e040dedb4e24a17c628c1e9caf"
+      sha256: abe6e4b5b36ce2bf01aec8f2a59424d1ecfc3cb340e7145a64359adc7233a0d1
       url: "https://pub.dev"
     source: hosted
-    version: "2.5.0"
+    version: "2.5.1"
   build_runner:
     dependency: "direct dev"
     description:
       name: build_runner
-      sha256: "9b196d7b629c5317dff3ec83c7e98840b773cee3b9339b646fe487048d2ebc74"
+      sha256: "398ec7898b9b60be126067835a8202240b26dc54aa34d91d0198a539dcd5942e"
       url: "https://pub.dev"
     source: hosted
-    version: "2.5.0"
+    version: "2.5.1"
   build_runner_core:
     dependency: transitive
     description:
       name: build_runner_core
-      sha256: dae6a8a5cbef6866cdfa0d96df4b0d85b9086897096270a405a44d946dafffba
+      sha256: "9821dbf604ed74a6dabeaba0c33ac58190332ea238862a62cdf25fc8eba226b8"
       url: "https://pub.dev"
     source: hosted
-    version: "9.0.0"
+    version: "9.0.1"
   built_collection:
     dependency: transitive
     description:
···
     source: hosted
     version: "0.7.2"
   json_annotation:
-    dependency: transitive
+    dependency: "direct main"
     description:
       name: json_annotation
       sha256: "1ce844379ca14835a50d2f019a3099f419082cfdd231cd86a142af94dd5c6bb1"
···
     source: hosted
     version: "1.0.6"
   multiformats:
-    dependency: transitive
+    dependency: "direct main"
     description:
       name: multiformats
       sha256: aa2fa36d2e4d0069dac993b35ee52e5165d67f15b995d68f797466065a6d05a5

backend/pubspec.yaml

···
 dependencies:
   atproto: ^0.13.3
   drift: ^2.27.0
+  json_annotation: ^4.9.0
   lexicon: ^0.2.5
   logging: ^1.3.0
+  multiformats: ^0.2.3
   oauth2: ^2.0.3
   pubspec_parse: ^1.5.0
   shelf: ^1.4.2

backend/tools/build_and_run.sh

···
+#!/bin/sh
+
+# clippr: a social bookmarking service for the AT Protocol
+# Copyright (c) 2025 clippr contributors.
+# SPDX-License-Identifier: AGPL-3.0-only
+
+dart run build_runner build
+dart run bin/clippr.dart