fossasia/magic-epaper-app
61.3
Adequate · 17 November 2026
44.5k
lines of production code
Dart
primary language
5
measurements over time
What this system is
Features
Add Hindi localization and initial sketch filter support
The app now includes a complete Hindi (hi) translation file, enabling users to interact with the interface in Hindi. Additionally, a new Sketch Filter feature has been introduced, implemented via a new \SketchFilterService\ that downloads an ONNX model from Hugging Face and applies a pencil-sketch effect to images using Rust-based inference.
lib/l10n · high confidence
Add NFC command console for raw hex and APDU interactions
A new Command Console screen has been added to the app, providing a text-based interface for interacting with NFC tags. Users can now connect to and disconnect from tags, view tag information, and send raw hex commands (transceive) or read specific blocks from ISO15693 tags. The console supports commands like 'help', 'connect', 'disconnect', 'info', 'tx \<hex\>', and 'readblock \<n\>', allowing for low-level debugging and direct communication with NFC badges.
_lib/command\console · high confidence
Add Rust build integration via Cargokit
The rust\_builder directory now includes the Cargokit toolchain, providing the build scripts and Dart tooling required to compile Rust code for Android (via Gradle/CMake) and iOS/macOS (via CocoaPods). This adds the necessary glue to integrate Rust libraries into the Flutter build process, including environment setup, artifact provisioning, and precompiled binary support.
_rust\builder · high confidence
Android app initialization with NFC support and branding
The Android application package is established with the new app ID magic.epaper and branding (launcher icon, splash screen, and label "Magic ePaper"). The app declares necessary permissions for NFC, internet, and media access, and configures the MainActivity to handle NFC reader mode silently to prevent UI freezes and allow seamless handoff to NFC devices.
android/app/src · high confidence
Bulk card generation from CSV files
Users can now import data via CSV to generate multiple cards at once. The new bulk workflow includes a CSV import screen with automatic column mapping and the ability to rename columns, a generation screen that renders and captures high-resolution card images, and a results screen where generated badges can be edited, saved to the library, or transferred to a device. The feature supports predefined templates (employee ID, price tag, event badge) as well as dynamic templates that auto-detect column roles (title, photo, QR code) from the CSV headers, and handles photo references from URLs, data URIs, or local paths.
_lib/card\templates/bulk · high confidence
Image processing and dithering moved to Rust with new filter support
The image processing pipeline, including dithering algorithms (Floyd-Steinberg, Stucki, Atkinson, Bayer, Sierra-2, Burkes) and color modes (Black & White, Black & White Red, Black & White Red Yellow), has been implemented in Rust to improve performance. This change introduces a new pencil sketch filter using ONNX inference and adds support for the GDEY029F51 e-paper screen with yellow color. The Rust code is exposed to the Flutter app via flutter\_rust\_bridge (upgraded to 2.13.0), enabling faster image manipulation and new visual effects.
rust · high confidence
Initial Linux desktop platform support
This change adds the foundational Linux build configuration and native application entry point for the Magic ePaper app. It introduces the CMake build scripts (CMakeLists.txt) required to compile the Flutter engine and bundle assets, along with the GTK-based C++ source files (main.cc, my\_application.cc) that initialize the window, register plugins, and set the application title to "Magic ePaper".
linux · high confidence
Initial Windows desktop support for Magic ePaper
This change introduces the native Windows runner for the Magic ePaper application, enabling users to build and run the app on Windows 10 and 11. The implementation includes a CMake build configuration, a Win32 window wrapper that handles high-DPI scaling and system theme integration (dark/light mode), and a resource script that sets the application icon and version metadata. The window is created with a default size of 1280x720 pixels and displays the title "Magic ePaper".
windows · high confidence
Initial app shell with multi-provider state management and localized routing
The application now initializes with a structured entry point that integrates Rust-based libraries, manages app-wide state via Provider (including locale, image loading, and developer options), and supports internationalization through AppLocalizations. The main widget configures a MaterialApp with a defined set of routes for core screens such as display selection, NFC read/write, command console, settings, and FAQ, ensuring consistent theming and localization across the app.
lib · high confidence
Initial iOS project scaffolding for Magic ePaper
This change introduces the foundational iOS project structure for the Magic ePaper application. It includes the Xcode project configuration, workspace settings, and build schemes required to compile the app. The entry point is defined in AppDelegate.swift, which implements the FlutterImplicitEngineDelegate to initialize the Flutter engine and register plugins. The Info.plist configures the app bundle with the display name 'Magic ePaper', declares usage descriptions for camera and photo library access, and sets up the scene configuration to use a custom FlutterSceneDelegate. Additionally, standard assets such as the app icon set and launch screen storyboard are included to provide the initial visual identity of the app.
ios · high confidence
Initial implementation of the image library provider
This change introduces the core provider logic for the new Image Library feature. It enables users to save, load, and manage saved images by handling local file storage (creating directories for images and metadata), persisting image data as PNG files, and maintaining a JSON metadata index. The provider also supports filtering images by search query and source, clearing all saved data, and includes basic error handling and logging for these operations.
_lib/image\library/provider · high confidence
Initial macOS platform support added
The macOS platform is now supported, introducing the native Xcode project structure, build configurations, and application entry points required to run the Flutter app on macOS. This includes the main application window, menu bar integration, and sandbox entitlements for file and network access.
macos · high confidence
Initial web app entry point and PWA configuration
Added the core web entry files for the Flutter application: index.html serves as the main HTML shell, configuring the base href for routing, including meta tags for iOS web-app capability, and linking the Flutter bootstrap script; manifest.json defines the Progressive Web App (PWA) settings, including the app name, display mode, theme colors, and icon assets for various sizes and purposes.
web · high confidence
Introduce NDEF read/write screen with vCard and app launcher support
The app now includes a dedicated NDEF screen that allows users to read, write, and clear NFC tags. This update adds support for writing vCard contact data and Android app launcher records to NFC tags, alongside standard text and URL records. The service layer handles tag detection, session management, and localized feedback for operations, including specific handling for IsoDep badges with YZRCOS chips.
_lib/ndef\screen/services · high confidence
Introduce core data models for image library and native canvas
This change adds the foundational data models for the image library and native canvas features. In the image library, it introduces \ImageProperties\ for displaying image metadata (size, resolution, format) and \SavedImage\ for managing saved assets, including support for loading canvas documents, QR tags, and template data. In the native canvas, it defines \CanvasDocument\, \CanvasElement\, \Stroke\, and \CanvasController\ to handle the structure, serialization, and interactive state (including undo/redo) of canvas drawings.
_lib/image\library/models · high confidence
Introduce dedicated UI widgets for the Image Library
The Image Library screen now uses a set of new, dedicated Flutter widgets to render its interface. This includes a responsive app bar with delete mode and clear-all actions, a grid layout for displaying saved images, and specific components for empty states, error handling, and search/filter controls. The UI now supports localized strings, consistent spacing via Dimens constants, and visual overlays for image sources and selection status.
_lib/image\library/widgets · high confidence
Introduce native canvas editor with template support and sticker vault
Users can now create and edit designs using a new native canvas editor component. This editor supports pre-configured templates (such as QR codes, weather snapshots, and restaurant menus) and includes a sticker vault for adding icons. It also provides tools for drawing, erasing, and customizing elements like brush color and width, allowing for more flexible design creation directly within the application.
_lib/native\canvas · high confidence
Introduction of the Image Library feature
Users now have access to a new Image Library screen that allows them to view, search, and filter saved images. This feature includes the ability to preview images, rename or delete them individually, and clear all images at once. Additionally, users can re-edit specific saved items such as QR tags, weather snapshots, contact cards, and restaurant menu boards directly from the library, with changes persisted back to the saved image.
_lib/image\library · high confidence
New NDEF NFC read and write screens with app launcher support
This change introduces the core UI components for the new NDEF screen area, including \NDEFScreen\, \NFCReadScreen\, and \NFCWriteScreen\. Users can now read NFC tags, write text, URLs, Wi-Fi credentials, and vCards, and write app launcher data to tags. The implementation adds an \AppLauncherCard\ for selecting and writing app launcher records, a base state class \NFCBaseScreenState\ to manage NFC availability polling and lifecycle events, and localized strings for all operations.
_lib/ndef\screen · high confidence
New NDEF screen UI with NFC status, read, write, and vCard support
The NDEF screen now features a redesigned interface composed of four new widgets: NFCStatusCard displays the current NFC availability (available, disabled, or not supported) with a refresh action; NFCReadCard allows users to read NDEF tags, verify content, and clear previous results; NFCWriteCard enables writing text, URLs, Wi-Fi credentials, and vCards to NFC tags; and NFCDisabledCard provides a clear warning when NFC is unavailable. The vCard writing capability includes a dedicated VCardFormWidget for entering contact details such as name, organization, and contact information.
_lib/ndef\screen/widgets · high confidence
New NFC controller for reading and writing NDEF records
The NFC controller in the NDEF screen now supports writing multiple record types to NFC tags, including text, URLs, Wi-Fi credentials, app launchers, and vCards. Users can also read existing NDEF data and clear tags. The controller manages the NFC availability check and provides localized status messages for scanning and writing operations.
_lib/ndef\screen/controller · high confidence
New Sticker Vault with offline caching and recent items
The native canvas editor now includes a Sticker Vault, allowing users to browse, search, and insert stickers from various categories (such as Popular, Faces, and Weather). The feature supports offline usage by caching SVG assets to disk and maintains a list of recently used stickers for quick access. Users can search for specific icons, view them in categorized lists, and select them to add to their canvas.
_lib/native\_canvas/sticker\vault · high confidence
New badge canvas widgets and barcode editor
The native canvas now supports badge-style layouts and barcode elements. A new BadgeCanvasView renders elements on a colored background, while BadgeColorPicker lets users select background colors. A comprehensive BarcodeEditor widget allows users to create, scan, and edit barcodes (including QR, Data Matrix, and EAN formats) with format-specific validation, and EditableElement provides the interactive handles for moving, scaling, and rotating these elements on the canvas.
_lib/native\canvas/widgets · high confidence
New card templates and barcode scanning capability
Users can now generate several new card templates including a Calendar (with month, week, and day views), Contact Card (with vCard or link QR modes), Employee ID, Entry Pass Tag, Event Badge, Price Tag, QR Tag, Weather Snapshot, and Restaurant Menu. The Contact Card and Employee ID forms also support bulk CSV import for creating multiple cards at once. Additionally, a new barcode scanner utility allows users to scan codes from the camera or gallery to populate fields like links or QR data in the templates.
_lib/card\templates · high confidence
New e-paper display support and image processing utilities
This update introduces support for several new e-paper displays, including Goodisplay models (1.54", 2.13", 2.9", 4.2" in B/W, 3-color, and 4-color variants) and Fossasia models (3.1" B/W and 3.7" WBR/BW). It also adds a configurable e-paper export feature for custom displays, a new UC8253 driver with quick waveform support, and utility classes for color handling and application logging.
lib/utils · high confidence
New image library services for saving, editing, and managing saved images
This change introduces the core service layer for the new Image Library feature. The \ImageSaveHandler\ now manages the workflow for saving new images and updating existing ones, including support for canvas designs and templates. The \ImageOperationsService\ provides user-facing actions for the library, such as renaming, deleting, and clearing all saved images, with localized feedback messages. Additionally, \ImageFilterHelper\ maps internal image processing methods to their localized display names, ensuring consistent labeling in the UI.
_lib/image\library/services · high confidence
New informational screens and updated image editing workflow
The app now includes dedicated screens for About Us, Buying Badges, and an in-app FAQ (10 Q&As) accessible from the side menu, all fully localized. The image editing experience has been overhauled: the previous editor is replaced by a new canvas-based editor supporting templates, native canvas designs, and a pencil sketch filter using ONNX inference. Image cropping now uses the cross-platform crop\_your\_image package, and the text editor validates for non-empty input before saving. Additionally, the Settings screen now gates the Command Console behind a Developer Options toggle and supports runtime language switching between English and Hindi.
lib/view · high confidence
New provider layer for state management and persistence
This change introduces a new set of provider classes in the \lib/provider\ directory to manage application state and persist user preferences. The \LocaleProvider\ now handles switching the app language and saves the selection to local storage so it persists across restarts. The \DeveloperOptionsProvider\ manages a toggle for developer features, also persisting its state. The \ImageLoader\ provider handles picking, cropping, and decoding images (off the main thread), as well as saving and loading the last finalized image to disk. Additionally, a \ColorPaletteProvider\ is added to manage color lists, and the \getitlocator\ is updated to register these providers and app localizations.
lib/provider · high confidence
Support for Waveshare 4-color (G) NFC displays alongside existing black/white models
The Waveshare NFC integration now supports 4-color (G) e-paper displays in addition to the existing black/white (BW) models. This change introduces a new image codec (\WaveshareGImageCodec\) that encodes images into the specific black, white, yellow, and red palette required by G-series screens, and a dedicated NFC protocol handler (\WaveshareGNfcProtocol\) to manage the communication with these devices. The service layer (\WaveshareGNfcServices\) orchestrates the NFC session, image encoding, and display flashing for the new hardware, while the existing \WaveshareNfcServices\ and \WaveshareNfcProtocol\ continue to handle the standard black/white displays, ensuring both display types are supported within the same application.
lib/waveshare · high confidence
Behavioural changes
Added ProGuard rules for ML Kit language recognizers
A new ProGuard configuration file was added to suppress warnings for optional ML Kit text recognition language modules (Chinese, Devanagari, Japanese, Korean). This ensures that the build process does not fail or warn about missing dependencies for these specific language recognizers, which are not bundled by default.
android/app · high confidence
Automated decryption of encrypted signing secrets for Android and iOS builds
The build process now automatically decrypts and extracts platform-specific signing artifacts (Android keystores and iOS secrets) during the preparation phase. New shell scripts (\prep-android-key.sh\ and \prep-ios-key.sh\) use OpenSSL to decrypt encrypted tar archives stored in the repository, extracting the contents into the respective \android/\ and \iOS/\ directories. A \.gitignore\ file has been added to ensure that the decrypted secrets and encrypted archives are not committed to version control, securing the signing keys used for app distribution.
scripts · high confidence
Centralize app constants into dedicated modules
The application's hardcoded values have been organized into specific constant files to improve maintainability and consistency. API endpoints for Open-Meteo are now defined in \api\_constants.dart\. UI spacing, sizing, and font metrics are managed via the new \Dimens\ class in \dimens.dart\, replacing scattered hardcoded values. User-facing text, including NFC operation messages and UI labels, is centralized in \string\_constants.dart\. Asset paths for images and icons are consolidated in \asset\_paths.dart\, and color definitions are re-exported from the theme layer via \color\_constants.dart\ for backward compatibility.
lib/constants · high confidence
Introduce image library utility helpers for dates, device mapping, filters, and sources
New utility classes have been added to the image library to improve metadata handling and display. DateUtils provides human-readable relative date formatting for older images, while EpdUtils resolves e-paper display models from metadata, including support for known aliases and custom device reconstruction. FilterUtils extracts filter names from image metadata, and SourceUtils maps image sources (imported, editor, unknown) to consistent labels and colors.
_lib/image\library/utils · high confidence
Redesigned home screen with new display selection and transfer UI components
The home screen experience has been redesigned to improve device selection and image transfer workflows. A new \DisplayCard\ widget provides a visual, scalable representation of supported e-paper displays, showing model images, resolution, color capabilities, and SDK type (Waveshare, Goodisplay, or Custom) to help users identify their hardware. The app now includes dedicated transfer dialogs for different connection methods: \OeplTransferDialog\ for BLE-based OpenEPaperLink badges, \GoodisplayTransferDialog\ for NFC-based Good Display badges, and \WaveshareTransferDialog\ for Waveshare NFC displays, each handling their specific scanning, connection, and progress states. A \ConfigurableEpdDialog\ allows users to define custom display presets for Arduino export, while a \CommonScaffold\ standardizes the app's navigation drawer and app bar layout across all screens.
lib/view/widgets · high confidence
Redesigned image library dialogs with consistent theming and localization
The image library dialogs (preview, rename, save, properties, and delete confirmations) have been completely rewritten to use a unified, modern design system. All dialogs now support full localization via AppLocalizations, display accurate image metadata and counts, and enforce consistent max-width constraints for better responsiveness. The delete confirmation dialog now supports both single and batch deletion with image previews, while the rename and save dialogs properly manage text controllers to prevent memory leaks. The clear-all confirmation dialog provides a distinct, high-visibility warning for bulk removal.
_lib/image\library/widgets/dialogs · high confidence
Updated Rust bridge bindings to version 2.13.0
The auto-generated Flutter-Rust bridge files in lib/src/rust have been regenerated using flutter\_rust\_bridge 2.13.0. This update refreshes the FFI bindings for the Rust library, ensuring compatibility with the latest bridge protocol and incorporating the new dithering methods (Bayer, Sierra-2, Burkes) and the pencil sketch filter exposed by the Rust backend.
lib/src · high confidence
Test coverage
Added integration test for Rust library initialization; Added integration tests for app screenshots and barcode workflow; Added test coverage for new and existing card templates; Added tests for canvas document serialization and card layout logic; Added tests for text editor validation, Waveshare image codec, and app scaffolding.
Dependencies
Android Gradle wrapper updated to version 9.8.0
The Android build system now uses Gradle 9.8.0, replacing the previous version. This update ensures that local builds and CI pipelines utilize the newer Gradle distribution, which may include performance improvements, bug fixes, and compatibility updates for the Android build tools. Also in this area: 1 commit (0 fixes) modifying android.
android/gradle · low confidence · unverified
Initial project scaffolding and dependency configuration
This change establishes the foundational build configuration for the Magic E-paper Label Customization App. It introduces the Flutter SDK (version 3.47.5) and a suite of Dart dependencies for NFC communication, image processing, and UI components, alongside a new Rust-based native library for performance-critical tasks. The Android build environment is configured with Gradle 9.4.1, Kotlin 2.4.20, and Java 17, while iOS and macOS platforms are set up with CocoaPods and specific deployment targets.
(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 61.8 → 61.3 (-0.5)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 77.9 → 74.7 (-3.2)
- Architecture 96.6 → 94.6 (-2.0)
- Maturity 66.4 → 68.6 (+2.2)
- Readiness 65.2 → 63.3 (-1.9)
- Security 56.2 → 56.2 (0.0)
- Domain Modelling 100.0 → 100.0 (0.0)
- Performance 60.9 → 60.0 (-0.9)
Resolved (16)
- Duplicated block (10–17 lines × 3) (lib/view/display_selection_screen.dart)
- Duplicated block (11 lines × 2) (lib/native_canvas/models/card_layout.dart)
- Duplicated block (14–16 lines × 5) (lib/ndef_screen/app_launcher_card.dart)
- Duplicated block (15 lines × 4) (lib/image_library/widgets/dialogs/clear_all_confirmation_dialog.dart)
- Duplicated block (18 lines × 2) (lib/image_library/widgets/dialogs/clear_all_confirmation_dialog.dart)
- Duplicated block (20–21 lines × 2) (lib/utils/epd/goodisplay_nfc_protocol.dart)
- Duplicated block (23 lines × 5) (lib/card_templates/contact_card_form.dart)
- Duplicated block (63 lines × 4) (lib/card_templates/contact_card_form.dart)
- Duplicated block (8 lines × 2) (lib/card_templates/entry_pass_tag_form.dart)
- Hotspot: lib/waveshare/services/waveshare_nfc_protocol.dart (lib/waveshare/services/waveshare_nfc_protocol.dart)
- Near-duplicate member family (5 members, 76 shared lines) (lib/card_templates/contact_card_form.dart)
- No ADRs found
- Off-boarding risk: anonymized user #1
- Off-boarding risk: anonymized user #2
- Projects may be oversized for their cohesion
- Repeated repair: lib/waveshare/services/waveshare_nfc_services.dart (lib/waveshare/services/waveshare_nfc_services.dart)
New (73)
- Documentation: no build, run or usage example (rust_builder/cargokit/build_tool/README.md)
- Duplicated block (10–17 lines × 3) (lib/view/display_selection_screen.dart)
- Duplicated block (11 lines × 2) (lib/native_canvas/models/card_layout.dart)
- Duplicated block (14–16 lines × 5) (lib/ndef_screen/app_launcher_card.dart)
- Duplicated block (15 lines × 4) (lib/image_library/widgets/dialogs/clear_all_confirmation_dialog.dart)
- Duplicated block (18 lines × 2) (lib/image_library/widgets/dialogs/clear_all_confirmation_dialog.dart)
- Duplicated block (20–21 lines × 2) (lib/utils/epd/goodisplay_nfc_protocol.dart)
- Duplicated block (8 lines × 2) (lib/card_templates/entry_pass_tag_form.dart)
- Edited copies of one member (3 members, 11+ corresponding lines) (lib/santek/services/santek_nfc_services.dart)
- Edited copies of one member (3 members, 22+ corresponding lines) (lib/image_library/services/image_operations_service.dart)
- Edited copies of one member (3 members, 36+ corresponding lines) (lib/ndef_screen/app_launcher_card.dart)
- Edited copies of one member (3 members, 7+ corresponding lines) (lib/card_templates/contact_card_form.dart)
- Edited copies of one member (3 members, 9+ corresponding lines) (lib/command_console/console_nfc_service.dart)
- Edited copies of one member (4 members, 11+ corresponding lines) (lib/ndef_screen/controller/nfc_controller.dart)
- Edited copies of one member (4 members, 23+ corresponding lines) (lib/card_templates/utils/responsive_layout_util.dart)
- Edited copies of one member (4 members, 42+ corresponding lines) (lib/image_library/widgets/dialogs/clear_all_confirmation_dialog.dart)
- Edited copies of one member (5 members, 21+ corresponding lines) (lib/card_templates/contact_card_form.dart)
- Edited copies of one member (7 members, 17+ corresponding lines) (lib/image_library/services/image_operations_service.dart)
- Edited copy of a member (10 corresponding lines) (lib/ndef_screen/ndef_screen.dart)
- Edited copy of a member (11 corresponding lines) (lib/card_templates/entry_pass_tag_form.dart)
- …and 53 more
Changes since last survey
- 11 commits — 11 feature/other, 0 fixes
By area
- (root) — 7 commits
- android/gradle — 2 commits
- android/settings.gradle — 1 commit
- lib/card_templates — 1 commit
Notable commits
- change: chore(deps): upgrade Flutter to 3.50.0 (#741)
- 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
- change: chore: Bump flutter_svg from 2.3.2 to 2.4.0
- change: chore: Bump google_mlkit_text_recognition from 0.17.1 to 1.0.1
- change: chore: Bump google_mlkit_text_recognition from 1.0.1 to 1.0.3
- 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 (#734)
- change: chore: Bump universal_ble from 3.2.0 to 3.3.0
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/magic-epaper-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 af6ae5a6e7f9613dc94ee8be945d37d593cdd804 — 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.