Skip to content
CAI
Software that uses CAICheck a score

v-modal/vmodal_sdk_flutter

63.8

Adequate · 17 November 2026

19.2k

lines of production code

Dart

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is the VModal Flutter SDK, a client library for interacting with the VModal video search platform. It provides core capabilities for authentication, adaptive video upload, and searching through indexed video frames using various modalities. The SDK supports multi-tenant architectures with isolated user sessions and includes comprehensive tooling for release validation and performance benchmarking.

Features

Add Framebase video search example

Introduces the Framebase example app, a Flutter application that demonstrates natural-language visual search within a small video library. The example includes the complete mobile flow: runtime authentication, streamed uploads, asynchronous indexing, grouped frame results, and playback of the source video at the returned timestamp. It bundles three city-street video clips and provides the necessary Android and iOS project scaffolding, assets, and documentation to run and validate the feature.

_example/05\framebase · high confidence

Added Framebase user login example project

This change introduces the \example/05\_framebase\_userlogin\ Flutter application, which demonstrates the SDK's \UserSessionManager\ for handling host sign-in and tenant-based API access. The project includes the full native scaffolding for Android and iOS, configuration files, and documentation detailing how to integrate a trusted issuer to map Firebase UIDs to VModal principals, allowing multiple app users to share a tenant key while maintaining separate sessions and archives.

_example/05\_framebase\userlogin · high confidence

Flutter SDK v1.3.0 introduces opt-in app-user sessions with tenant credential isolation

The Flutter SDK now supports an opt-in session interface that allows applications to share a single tenant API key across multiple app users. This change introduces immutable app-user contexts, guarded session operations, and synchronous account-switch invalidation to ensure data isolation. Tenant credential rotation is now coordinated independently from app-user identity, and checkpoints and Framebase archives are partitioned by service, tenant, user, and scope to prevent cross-user data leakage while maintaining backward compatibility with the existing tenant-scoped API.

(repo-wide) · high confidence

Initial commit of the Sightline Flutter example app

This change introduces the complete source code and configuration for the Sightline example application, a Flutter app demonstrating the VModal Flutter SDK for video search on iOS and Android. The addition includes the full project structure with Android and iOS platform configurations, analysis options, and a comprehensive README detailing the two demo modes (traffic camera and media archive). It also provides integration tests for both the traffic and archive tabs, including automated walkthroughs that capture screenshots and human-paced demo scripts for screen recordings.

_example/04\example · high confidence

Initial release of the Vmodal Dart SDK (v1.3.0)

This change introduces the core library for the Vmodal Dart SDK, establishing the foundational client and resource layer for interacting with the Vmodal platform. It adds the \VmodalClient\ entry point, which manages configuration, authentication, and resource access (auth, search, collections, indexes, admin, R2, and images). The update includes a comprehensive error handling hierarchy (\SdkException\ and subclasses), a flexible API key provider system supporting rotation and tenant credentials, and an adaptive multipart upload policy that automatically tunes part size and concurrency based on device memory and network conditions. It also defines the data models for search requests and responses, along with the HTTP transport layer and configuration parsing.

lib/src · high confidence

New Android example app and user-scoped organization examples

The \example/01\_full\_app/android\ directory now includes the standard Flutter Android project scaffolding (manifests, MainActivity, and launch themes), enabling the full app example to run on Android devices. Additionally, the \example/02\_users\ directory introduces a new set of compile-checked Flutter examples that demonstrate four ways to organize searchable content: a shared global search index, a private index per application user, multiple streams for a single user, and a business-domain product catalog. These examples include local validation for user identifiers and are accompanied by unit tests verifying the correct project, collection, and stream scoping for each organization pattern.

_example/01\_full\_app/android, example/02\users · high confidence

The \example/03\_cctv\ directory now provides a complete, compile-checked demonstration of the Flutter SDK's CCTV input contract. This example guides users through a progressive workflow: authenticating, listing project collections and index jobs, uploading timestamped CCTV footage (preserving the camera's original timestamp and metadata tags), creating a frame index, and performing metadata searches within absolute time ranges. It includes the \CctvUploadInput\ and \CctvSearchInput\ helper classes to map user-provided data to SDK options, along with unit tests verifying that upload fields are correctly mapped and that caller-provided lists are not mutated.

_example/03\cctv · high confidence

New internal tooling for release validation, live testing, and performance benchmarking

The \tool\ directory now includes several new Dart scripts to support the SDK's release and quality processes. \release\_manifest.dart\ handles release metadata checks, source exports, and SHA-256 manifest generation. \check\_route\_sync.dart\ validates that the Flutter SDK's route contract matches the upstream Python API definitions. \live\_test.dart\ and \live\_cctv\_test.dart\ provide end-to-end integration tests for authentication, video upload, indexing, and search functionality against a live backend. Additionally, \perf\_benchmark.dart\ measures upload performance and memory usage, and \flutter\_checksums.txt\ records the SHA-256 hashes for the Flutter SDK 3.44.6 binaries.

tool · high confidence

Fixes

Fixes for search candidate modality and image loading in the VModal example app

The \example/01\_full\_app\ Flutter application now uses the \vid\_img\ modality for search candidates and ensures filenames are non-empty, correcting previous search behavior. Additionally, the app loads search result frames using the image bytes API instead of \NetworkImage\, which improves reliability for displaying search results.

_example/01\_full\app · high confidence

Test coverage

Added comprehensive test suite for vmodal\_sdk\_flutter

Added tests in the test directory covering the adaptive upload policy selection logic, HTTP authentication and key rotation, backend token envelope parsing and validation, CCTV upload contract and validation, client initialization and transport lifecycle, route configuration and normalization, generated documentation integrity, and error message redaction to prevent leaking sensitive paths or endpoints.

test · high confidence

Dependencies

Updated example apps to Flutter 3.44 and Android Gradle Plugin 9.0.1

The example applications (01\_full\_app, 02\_users, 03\_cctv, 04\_example, 05\_framebase, 05\_framebase\_userlogin) have been updated to target Flutter 3.44 and use the Android Gradle Plugin version 9.0.1 (with Kotlin 2.3.20). This migration includes new Gradle build files (build.gradle.kts, settings.gradle.kts) and updated pubspec.lock files reflecting the new dependency versions, ensuring compatibility with the latest Flutter SDK release.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 63.9 → 63.8 (-0.1)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 86.0 → 83.5 (-2.5)
  • Architecture 84.1 → 95.6 (+11.5)
  • Maturity 72.5 → 76.3 (+3.8)
  • Readiness 67.2 → 63.4 (-3.8)
  • Security 61.1 → 61.1 (0.0)
  • Performance 60.0 → 60.0 (0.0)

Resolved (4)

  • Duplicated block (10 lines × 4) (example/01_full_app/ios/Runner/AppDelegate.swift)
  • Duplicated block (8 lines × 2) (example/05_framebase/lib/main.dart)
  • Off-boarding risk: anonymized user #1
  • Projects may be oversized for their cohesion

New (20)

  • Duplicated block (10 lines × 4) (example/01_full_app/ios/Runner/AppDelegate.swift)
  • Duplicated block (8 lines × 2) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (10 corresponding lines) (example/02_users/lib/global_search_index.dart)
  • Edited copy of a member (11 corresponding lines) (example/05_framebase/lib/data/archive_controller.dart)
  • Edited copy of a member (11 corresponding lines) (example/05_framebase/lib/data/archive_controller.dart)
  • Edited copy of a member (11 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (124 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (14 corresponding lines) (example/01_full_app/lib/main.dart)
  • Edited copy of a member (14 corresponding lines) (example/04_example/lib/console_view.dart)
  • Edited copy of a member (22 corresponding lines) (example/05_framebase/lib/data/archive_controller.dart)
  • Edited copy of a member (26 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (29 corresponding lines) (lib/src/http.dart)
  • Edited copy of a member (34 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (35 corresponding lines) (example/05_framebase/lib/data/archive_controller.dart)
  • Edited copy of a member (4 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (53 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (6 corresponding lines) (example/05_framebase/lib/main.dart)
  • Edited copy of a member (66 corresponding lines) (example/05_framebase/lib/data/archive_controller.dart)
  • Edited copy of a member (8 corresponding lines) (lib/src/backend_auth.dart)
  • Off-boarding risk: anonymized user #1

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

v-modal/vmodal_sdk_flutter was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 84339245d6130fabfb09cb4df7aa8daeac4bb102 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.