fossasia/badgemagic-app
63.6
Adequate · 17 November 2026
17.8k
lines of production code
Dart
primary language
5
measurements over time
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.