Skip to content
CAI
Software that uses CAICheck a score

fossasia/badgemagic-app

63.6

Adequate · 17 November 2026

17.8k

lines of production code

Dart

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add custom animation transfer library

The \lib/others/custom\_transfers\ directory now provides a library of custom LED badge animations, including Beating Hearts, Broken Hearts, Chevron, Cupid, Cycle, Diagonal, Diamond, Emergency, Equalizer, Feet, Fireworks, Fish, GIF, and Pacman. These modules generate frame bitmaps and handle the data transfer to the badge hardware, with a shared \common.dart\ utility managing the animation constants and transfer logic.

_lib/others/custom\transfers · high confidence

Added web app manifest and entry point for PWA support

The web entry point (index.html) and web app manifest (manifest.json) have been added to the project. This enables the application to function as a Progressive Web App (PWA) by defining the app name, theme colors, and providing the necessary icon assets for installation and display on home screens.

web · high confidence

Automated decryption of encrypted build secrets for CI pipelines

New shell scripts (prep-android-key.sh, prep-ios-key.sh) and a .gitignore file have been added to the scripts directory to support CI/CD workflows. These scripts automatically decrypt and extract encrypted Android and iOS build secrets (stored as .tar.enc files) using OpenSSL AES-256-CBC, placing the resulting artifacts into the respective platform directories. The .gitignore ensures that sensitive files like secrets.tar, fastlane.json, and \*.jks are not committed to version control.

scripts · high confidence

Initial Android app structure and USB firmware update support

The Android application has been initialized with the necessary configuration to support Bluetooth Low Energy (BLE) connectivity and, notably, firmware updates via USB. The main AndroidManifest declares permissions for Bluetooth scanning and connection, camera access (required for QR code features), and foreground services. A new MainActivity implements a native MethodChannel that handles USB device discovery, permission requests, and the execution of WCH ISP firmware flashing commands, enabling users to update the badge hardware directly through a USB connection.

android/app · high confidence

Initial Debian packaging support for Badge Magic

Added the necessary configuration files to build a Debian package for the Badge Magic application. This includes a build definition specifying the binary name, architecture, and dependencies (such as libgtk-3-0 and bluez), as well as a desktop entry file to enable integration with Linux desktop environments.

debian · high confidence

Initial Linux desktop support for BadgeMagic

BadgeMagic is now available as a native Linux desktop application. This change introduces the necessary build infrastructure (CMakeLists.txt), the GTK-based application entry point (main.cc, my\_application.cc), and the desktop integration files (badgemagic.desktop, metainfo.xml) required to run the Flutter app on Linux via GTK. Users can now install and launch BadgeMagic directly on Linux desktop environments.

linux · high confidence

Initial Windows desktop platform support

The application now supports Windows desktop, allowing users to run the app natively on Windows 7 and later. This change introduces the CMake build configuration, a Win32 window runner with high-DPI and dark-mode support, and the necessary resource files to build and install the executable.

windows · high confidence

Initial iOS project structure for Badge Magic

The iOS directory now contains the complete native project scaffolding for the Badge Magic app, including the Xcode project, workspace, and scheme configurations. The app bundle is configured with the display name "Badge Magic" and declares necessary permissions for Bluetooth (to control BLE Badges), the photo library, and the camera (to scan badge QR codes). The UI is set up to support multiple interface orientations on both iPhone and iPad, and the application lifecycle is managed via UISceneDelegate to ensure compatibility with modern iOS windowing.

iOS · high confidence

Initial localization files for Hindi, Italian, and Russian

The app now includes initial translation support for Hindi, Italian, and Russian. Users can select these languages in the settings to see the interface in their preferred language, although the translations are currently empty placeholders for most strings.

lib/l10n · high confidence

Initial macOS project structure added

The macOS platform support is now available for the Badge Magic application. This change introduces the complete Xcode project structure, including the main application entry point (AppDelegate), the Flutter window configuration, and the native menu bar interface. It also includes the necessary configuration files for build settings, app metadata (Info.plist), and security entitlements for Bluetooth, USB, and network access, along with the standard app icon assets.

macos · high confidence

Initial project structure and core application setup

This change introduces the foundational structure for the application, including the main entry point (main.dart) which configures the Flutter app with Material 3 theming, localization support for English, Hindi, and Italian, and dependency injection via Provider for features like animations, fonts, and USB transfer. It also adds core configuration files: constants.dart defining animation/effect assets and URL launching utilities, and theme files (color.dart, app\_radius.dart) establishing the app's visual design system.

lib · high confidence

Initial project structure and documentation for Badge Magic

The repository has been initialized with the core structure for the Badge Magic Flutter application, including the \lib/\ directory containing the main entry point, state management providers, and localization files. Essential configuration files such as \pubspec.yaml\, \analysis\_options.yaml\, and \l10n.yaml\ are present to define dependencies and build settings. The project is now documented with a comprehensive \README.md\ detailing features like text and drawing modes, animation effects, and Bluetooth connectivity, alongside an \AGENTS.md\ file outlining coding standards and repository structure. A \.gitignore\ file has been added to exclude build artifacts and generated files, and the project license has been set to Apache 2.0.

(repo-wide) · high confidence

Introduce next-generation firmware update protocol with hardware variant selection

The app now supports a next-generation communication protocol for badge interactions, including firmware updates. Users can select their specific hardware variant (e.g., 4 buttons USB-C, 2 buttons USB-Micro) in the Settings screen before initiating a firmware update, ensuring the correct binary is applied. This change introduces new data models for hardware variants, message modes, and speeds, and integrates a USB HID transfer option alongside existing BLE methods for more reliable device communication.

lib/view · high confidence

New badge animations and GIF support

The badge animation library now includes a wide variety of new visual effects, such as beating hearts, broken hearts, chevrons, Cupid, cycles, diagonals, diamonds, equalizers, feet, fireworks, fish, lasers, Pac-Man, snowflakes, and splitting patterns, alongside scrolling (up, down, left, right) and fixed display modes. Additionally, the library now supports preset animated GIFs, allowing users to display custom GIF content on the badge.

_lib/badge\animation · high confidence

New badge effects, font selection, and USB HID transfer support

Users can now apply visual effects (Flash, Marquee, and Invert LED) to their badge animations, choose from a set of Google Fonts (Roboto, Open Sans, Lato, Poppins, Montserrat, Orbitron, Lexend) for text display, and transfer content to compatible badges via USB HID in addition to the existing Bluetooth connection. The app also introduces a badge scan mode that allows filtering by specific badge names and supports streaming mode, while firmware updates can now be performed over USB using the WCH ISP tool on Linux.

lib/providers · high confidence

Redesigned badge creation interface with new widget components

The badge creation experience has been rebuilt using a new set of modular widgets in lib/view/widgets. This includes a new tabbed control interface (BadgeControlTabBar) for navigating Speed, Transition, Effects, and Animation settings, alongside a dedicated animation container (AniContainer) for selecting and previewing effects. The text input area now supports font selection and restricts unsupported emojis, while a new clipart picker and list view allow users to manage saved images. Additionally, the update introduces a PIN authentication dialog for secure badge connections, a standardized progress dialog for BLE operations, and a settings widget for configuring badge scan modes.

lib/view/widgets · high confidence

Behavioural changes

1 commit (0 fixes) modifying assets/usb-c-4key

A change to existing behaviour in assets/usb-c-4key — 1 commit, 2 files: “feat: BLE firmware update (\#1875)” (refs \#1875).

assets/usb-c-4key · medium confidence · unverified

Refactored core utilities and consolidated logging

The \lib/others\ directory has been restructured to improve code organization and maintainability. A shared \app\_logger\ instance is now used across the codebase for consistent logging. Utility classes such as \FileHelper\, \Converters\, and \ImageUtils\ have been refactored into focused, standalone components (e.g., \byte\_array\_utils.dart\, \clipart\_image\_processor.dart\) to reduce coupling and improve clarity. Additionally, a new \LocalizationService\ has been introduced to manage app locale persistence and access globally without requiring a \BuildContext\.

lib/others · high confidence

Restructured BLE communication with retry logic and PIN support

The BLE communication layer in lib/communication has been refactored into a state-machine architecture (base\_ble\_state, scan\_state, connect\_state, write\_state, ng\_command\_state) to improve reliability and user feedback. This change introduces automatic retry logic for connection and data transfer failures, ensuring that transient errors do not immediately abort the process. It also adds support for PIN-protected badges, where the app now prompts for a PIN before connecting if required. Additionally, the system now distinguishes between legacy and next-generation badge protocols, keeping the GATT connection alive for next-gen devices to support streaming commands, while properly disconnecting legacy devices after transfer.

lib/communication · high confidence

Fixes

Fix macOS CI builds by patching hid\_tool's hidapi path

A new shell script, tool/patch\_hid\_tool\_macos\_spm.sh, has been added to resolve macOS build failures caused by Flutter's plugin symlinking structure. The script automatically rewrites the relative hidapi path in hid\_tool's SwiftPM Package.swift to an absolute path pointing to the vendored package in the pub cache, ensuring the dependency resolves correctly during CI runs.

tool · high confidence

Test coverage

Added automated end-to-end screenshot tests; Added unit tests for BadgeLoaderHelper; Added unit tests for core badge data processing and conversion utilities.

Dependencies

Initial project scaffolding and dependency configuration

The project is initialized with a new Flutter structure, including the core \pubspec.yaml\ defining the app dependencies (such as \universal\_ble\, \go\_router\, and \file\_picker\), the \pubspec.lock\ pinning specific package versions, and platform-specific build configurations for Android (\build.gradle\, \settings.gradle\) and iOS (\Podfile\). This establishes the foundational build environment and dependency graph required to run the application.

(dependencies) · high confidence

Updated Gradle wrapper to version 9.8.0

The Android build system now uses Gradle 9.8.0, as defined in the gradle-wrapper.properties file. This ensures that the project builds with the specified Gradle distribution, which may include performance improvements, bug fixes, or new features compared to previous versions.

android/gradle · 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 64.4 → 63.6 (-0.8)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 75.8 → 74.5 (-1.3)
  • Architecture 94.5 → 94.9 (+0.4)
  • Maturity 67.2 → 67.0 (-0.2)
  • Readiness 65.2 → 63.8 (-1.4)
  • Security 64.9 → 64.9 (0.0)
  • Performance 60.9 → 60.0 (-0.9)

Resolved (8)

  • Duplicated block (16–19 lines × 2) (lib/badge_animation/ani_fish.dart)
  • Duplicated block (19 lines × 2) (lib/view/about_us_screen.dart)
  • Hotspot: lib/communication/write_state.dart (lib/communication/write_state.dart)
  • Off-boarding risk: anonymized user #1
  • Off-boarding risk: anonymized user #2
  • Projects may be oversized for their cohesion
  • Repeated repair: lib/main.dart (lib/main.dart)
  • Repeated repair: lib/view/widgets/speed_dial.dart (lib/view/widgets/speed_dial.dart)

New (24)

  • Duplicated block (22 lines × 2) (lib/view/about_us_screen.dart)
  • Edited copies of one member (3 members, 16+ corresponding lines) (lib/badge_animation/ani_fixed.dart)
  • Edited copies of one member (4 members, 11+ corresponding lines) (lib/badge_animation/ani_emergency.dart)
  • Edited copies of one member (4 members, 8+ corresponding lines) (lib/view/widgets/draw_badge.dart)
  • Edited copy of a member (12 corresponding lines) (lib/providers/badge_scan_provider.dart)
  • Edited copy of a member (14 corresponding lines) (lib/providers/badge_message_provider.dart)
  • Edited copy of a member (15 corresponding lines) (lib/others/file_helper.dart)
  • Edited copy of a member (17 corresponding lines) (lib/badge_animation/ani_cycle.dart)
  • Edited copy of a member (20 corresponding lines) (lib/badge_animation/ani_diagonal.dart)
  • Edited copy of a member (22 corresponding lines) (lib/others/file_helper.dart)
  • Edited copy of a member (26 corresponding lines) (lib/others/image_utils.dart)
  • Edited copy of a member (28 corresponding lines) (lib/providers/font_provider.dart)
  • Edited copy of a member (4 corresponding lines) (lib/view/settings_screen.dart)
  • Edited copy of a member (56 corresponding lines) (lib/view/settings_screen.dart)
  • Edited copy of a member (58 corresponding lines) (lib/badge_animation/ani_down.dart)
  • Edited copy of a member (58 corresponding lines) (lib/view/settings_screen.dart)
  • Edited copy of a member (8 corresponding lines) (lib/others/data_to_bytearray_converter.dart)
  • Further sole-owners (lower concentration)
  • Off-boarding risk: anonymized user #1
  • Orphaned file (lib/storage/badge_text_storage.dart)
  • …and 4 more

Changes since last survey

  • 16 commits — 13 feature/other, 3 fixes

By area

  • (root) — 8 commits
  • android/gradle — 2 commits
  • lib/providers — 2 commits
  • lib/view — 2 commits
  • android/settings.gradle — 1 commit
  • lib/l10n — 1 commit

Notable commits

  • fix: fix: Remove looping Animation Index log (#2049)
  • fix: fix: Stop duplicate Undo after drawing shapes (#2044)
  • fix: fix: localize hardcoded UI strings (#2045)
  • change: chore(deps): upgrade Flutter to 3.50.0 (#2053)
  • change: chore: Bump com.android.application from 9.5.0 to 9.5.1 in /android
  • change: chore: Bump file_picker from 13.3.0 to 13.3.2
  • change: chore: Bump file_picker from 13.3.2 to 13.3.3 (#2052)
  • change: chore: Bump flutter_svg from 2.3.2 to 2.4.0 (#2055)
  • change: chore: Bump go_router from 18.1.2 to 18.1.3 (#2047)
  • change: chore: Bump go_router from 18.1.3 to 18.1.4 (#2051)
  • change: chore: Bump gradle-wrapper from 9.8.2 to 9.9.0 in /android
  • change: chore: Bump gradle-wrapper from 9.9.0 to 9.9.1 in /android
  • change: chore: Bump mobile_scanner from 7.4.2 to 7.5.0
  • change: chore: Bump universal_ble from 3.2.0 to 3.3.0 (#2056)
  • change: docs: Fix broken links and typos in README (#2041)
  • change: fix(l10n): correct English typos and key naming (#2037)

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

Survey your own repository

fossasia/badgemagic-app 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 90b4b8d199499329833bf87792045fc46cc02211 — 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.