Skip to content
CAI
Software that uses CAICheck a score

fossasia/pslab-app

58.5

Adequate · 17 November 2026

63.3k

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 Cargokit build tooling for Rust integration

The \rust\_builder\ directory now includes the Cargokit build tool (a Dart application under \cargokit/build\_tool\) to seamlessly integrate Rust crates with Flutter. This tool handles building Rust code for Android (via Gradle/CMake), iOS, and macOS (via CocoaPods), manages NDK and toolchain setup, and supports downloading and verifying precompiled binaries. This change provides the necessary glue code to build and link Rust libraries within Flutter plugins.

_rust\_builder, rust\_builder/cargokit/build\tool · high confidence

Add SCPI protocol support for PSLab Mini and Pico devices

The communication layer now supports the SCPI command set for PSLab Mini and Pico devices, enabling users to interact with these hardware variants using standard instrument commands. This change introduces a new \BoardType\ enum and detection logic in \PacketHandler\ to identify SCPI-based boards, alongside a new \ScpiCommands\ class defining the command dictionary and \CommandsProto\ for legacy binary protocol constants. Users can now utilize features like oscilloscope, logic analyzer, and multimeter functions on SCPI-compatible hardware through the existing \ScienceLab\ interface.

lib/communication · high confidence

Add support for Labrador hardware device

The app now supports the EspoTek Labrador hardware device. This includes new firmware binaries for the device, a cross-platform communication layer (native via Rust/USB, web via WebUSB, and stubs), and a new Hardware Abstraction Layer (HAL) exposing the device's oscilloscope, multimeter, wave generator, power source, and logic analyzer capabilities to the rest of the application.

(repo-wide) · high confidence

Added I2C communication and DAC channel support

The peripherals library now includes a new DACChannel class for managing digital-to-analog converter settings and a comprehensive I2C interface. The I2C implementation supports both standard PSLab board communication and SCPI-based devices, providing methods to initialize the bus, configure frequency, and perform read/write operations including bulk transfers.

lib/communication/peripherals · high confidence

Added YamNet sound classification map for Sound Meter

The application now includes a comprehensive sound classification capability by adding the YamNet class map asset (assets/yamnet\_class\_map.csv). This CSV file defines 522 distinct sound categories—ranging from human speech and laughter to animal sounds, musical instruments, and environmental noises—enabling the Sound Meter instrument to identify and classify audio inputs into these specific semantic labels.

assets · high confidence

Added build and signing automation scripts

New shell scripts have been added to the \scripts\ directory to support the CI/CD pipeline. \prep-android-key.sh\ and \prep-ios-key.sh\ decrypt and extract platform-specific signing secrets (JKS and iOS certificates) from encrypted archives using environment variables, enabling signed builds. \generate-app-download-page.sh\ creates an HTML index page linking to development build artifacts (APK, AAB, IPA, etc.) hosted on the \app\ branch. A \.gitignore\ file ensures sensitive files like \.jks\ and \secrets.tar\ are not committed.

scripts · high confidence

Added macOS Flutter build configuration files

The macOS Flutter project now includes \Flutter-Debug.xcconfig\ and \Flutter-Release.xcconfig\ files. These configurations establish the build settings for debug and release modes by including the ephemeral Flutter-generated configuration and conditionally including CocoaPods support files, enabling the macOS target to build correctly within the Flutter framework.

macos/Flutter · high confidence

Added macOS project configuration for the pslab app

The macOS build configuration has been initialized, adding the Xcode project files (project.pbxproj, workspace, and scheme) required to build and run the 'pslab.app' on macOS. This includes the standard Flutter macOS runner structure with AppDelegate, MainFlutterWindow, and associated build targets for development, testing, and distribution.

macos/Runner.xcodeproj · high confidence

Added support for multiple new I2C sensors

The sensor communication layer now includes drivers for a wide range of new hardware, allowing users to interface with additional scientific instruments. New capabilities include the ADS1115 16-bit ADC, APDS9960 gesture/color/proximity sensor, BH1750 and TSL2561 light sensors, BMP180 barometer/altimeter, CCS811 air quality sensor, HMC5883L magnetometer, MAX30102 heart rate/SpO2 sensor, MLX90614 non-contact thermometer, MPU6050 and MPU925X IMUs (accelerometer/gyroscope), and SHT21 temperature/humidity sensor. These drivers handle I2C communication, initialization, and data retrieval for their respective devices.

lib/communication/sensors · high confidence

Added web app manifest and HTML entry point for PSLab

The web platform now includes the necessary \index.html\ and \manifest.json\ files to support the PSLab application as a standalone web app. This enables proper branding, including the app title, description, and theme colors, as well as support for adding the app to home screens with appropriate icons and display settings.

web · high confidence

Android home screen widget for saved logs

Android users can now view a summary of their saved logs directly on the home screen via a new widget. The widget displays a list of recent log files along with the associated instrument name; tapping any item or the header opens the main application. This feature is currently available only for Android devices.

app · high confidence

App initialization and core instrument infrastructure

The application now initializes the Rust communication library on startup and supports printing the app version via the -v/--version CLI flag. It introduces a new analog acquisition channel system for handling sensor data calibration and a digital channel system for logic analyzer-style signal plotting. The main entry point registers core providers (settings, board state, hardware filter, SHT21) and defines the complete navigation structure for all instrument screens, including the new Logic Analyzer, Gas Sensor, and OLED Display.

lib · high confidence

Generated Rust bindings for audio, bootloader, and serial communication

The \lib/src/rust\ directory now contains auto-generated Flutter Rust Bridge (version 2.13.0) bindings that expose Rust-side capabilities to the Dart application. These bindings provide a \FlashState\ stream for monitoring in-app firmware updates (connecting, erasing, writing, verifying, finished, error) and enable desktop audio capture via microphone start/stop functions. Additionally, they expose a comprehensive serial communication API supporting USB and Wi-Fi connections, device initialization, data read/write operations, and SCPI command queries, along with utilities for port detection and device presence checks.

lib/src · high confidence

Initial Android app configuration and native integration

The Android application has been initialized with the necessary native infrastructure to support core features. This includes configuring the AndroidManifest with required permissions (location, storage, audio) and intent filters for USB device attachment, enabling communication with hardware via a device filter for FTDI, CP210x, and other serial adapters. The main activity has been migrated to Kotlin to handle USB events, ambient temperature sensor readings, and permission requests via Flutter channels. Additionally, an Android home widget for saved logs has been added, along with adaptive launcher icons supporting monochrome themes.

android/app · high confidence

Initial Flutter project scaffolding and configuration

The repository is initialized as a Flutter application, adding the standard project structure and configuration files required for development. This includes the \.metadata\ file for Flutter tooling, \analysis\_options.yaml\ for Dart linting, \l10n.yaml\ for localization, and \flutter\_rust\_bridge.yaml\ to configure the Rust bridge integration. The setup also introduces a \.codacy.yaml\ file to exclude Rust-related directories from code quality checks, an \appdmg.json\ for macOS DMG packaging, and a \LICENSE\ file under the Apache License 2.0. Additionally, the \README.md\ is added to document the app's features, supported devices, and platform-specific setup instructions, while the \.gitignore\ is updated to handle Flutter-specific build artifacts and generated files.

(repo-wide) · high confidence

Initial Linux desktop support for PSLab

The PSLab application is now available on Linux, enabling users to run the Pocket Science Lab suite on desktop environments. This release includes the native GTK-based Flutter runner, CMake build configuration, and desktop integration files (including a Flatpak metadata manifest and udev rules for PSLab hardware), allowing the app to function as a standard Linux desktop application.

linux, windows · high confidence

Initial localization resource files added for multiple languages

The app now includes localization resource files (ARB format) for English, Hindi, Italian, German, and Hebrew, providing translated strings for instruments like the Oscilloscope, Multimeter, and Wave Generator, as well as connection and settings screens. Placeholder files have also been added for other supported languages (such as Spanish, French, and Chinese) to establish the localization structure, though their content is currently empty.

lib/l10n · high confidence

Initial macOS platform support with native permission handling

The macOS runner is introduced, providing the core application entry point and window configuration. To support device connectivity and data capture features, the app now requests and manages native permissions for microphone access (required for the oscilloscope), location services, and serial/USB device access. These capabilities are enabled via specific entitlements and Info.plist usage descriptions, with a native Swift channel handling permission status checks and requests.

macos/Runner · high confidence

Initial macOS project scaffolding for PSLab

This change introduces the foundational macOS application structure for the PSLab project. It establishes the Xcode workspace and project references, defines the main menu interface with standard application actions (such as About, Preferences, Services, and Quit), and configures build settings including the bundle identifier (io.pslab.pslab), application name, and copyright information. Additionally, it sets up build configurations for Debug and Release modes and enables a comprehensive set of compiler warnings to improve code quality.

macos/Runner.xcworkspace, macos/Runner/Base.lproj, macos/Runner/Configs · high confidence

Introduce Rust backend for device communication, audio capture, and firmware updates

The application now uses a new Rust-based backend (via flutter\_rust\_bridge 2.13.0) to handle core device interactions. This adds support for the PSLab Mini oscilloscope and the EspoTek Labrador hardware, including specific APIs for oscilloscope, multimeter, and logic analyzer modes. It also introduces in-app firmware flashing capabilities for both PSLab and Labrador devices, desktop microphone audio capture using the cpal library, and WebSocket-based Wi-Fi communication for the PSLab Web interface.

rust · high confidence

Introduce new instrument and oscilloscope UI widgets

Added a suite of new view widgets to support instrument screens and oscilloscope controls, including accelerometer, barometer, compass, and analog waveform controls, alongside layout components for channel parameters, data analysis, and data charts. These widgets provide the visual interface for sensor readings, waveform generation, and signal analysis features.

lib/view/widgets · high confidence

Introduces configurable settings and structured data models for instruments

This change adds a comprehensive set of configuration models (e.g., AccelerometerConfig, OscilloscopeConfig, SettingsConfig) and dedicated configuration screens (e.g., AccelerometerConfigScreen) for various instruments. Users can now adjust specific parameters such as update periods, sensor gain, and data export formats (CSV, TXT, JSON) through a new Settings screen. The update also introduces an Experiment framework with dedicated config models, allowing for structured experimental workflows.

lib/view · high confidence

New provider architecture for sensor instruments and device connection

The app introduces a new state management structure in the \lib/providers\ directory, adding dedicated configuration and state providers for multiple instruments including the Accelerometer, Barometer, Compass, and various external sensors (ADS1115, APDS9960, BMP180, CCS811, Gas Sensor). These providers handle data collection, charting, and persistent settings. Additionally, the \BoardStateProvider\ has been updated to support dynamic USB port detection on desktop platforms via a Rust API and includes logic to monitor and report unresponsive devices.

lib/providers · high confidence

New scientific experiments, instrument support, and data analysis tools

This update introduces two new guided experiments—Light Intensity vs. Distance and Pressure vs. Altitude—along with support for new hardware instruments including an OLED display, a barometer, and a thermometer. It also adds a new Audio Jack interface for desktop audio capture, a configurable data export service supporting CSV, TXT, and JSON formats, and a scientific data analyzer that computes metrics and charts for logged instrument data.

lib/others · high confidence

iOS app initialization and native permission handling

The iOS project has been initialized with a complete Flutter-native setup, including the Xcode workspace, build schemes, and asset catalogs. A key behavioral addition is the native \AppDelegate\ implementation, which now directly handles microphone and location permission requests and status checks via a method channel, ensuring the app can properly request and verify access to these device features before use.

ios · high confidence

Removals

Removed obsolete boilerplate activities, fragments, and resources

The app's main entry point and navigation structure have been cleaned up by removing the \SplashActivity\, \MainActivity\, and their associated UI layouts (\activity\_main.xml\, \app\_bar\_main.xml\, \nav\_header\_main.xml\). Several empty placeholder components—\AboutUs\, \HelpAndFeedback\, \ReportUs\, \HomeFragment\, \SavedExperiments\, \DesignExperiments\, and \SettingsFragment\—have been deleted, along with their corresponding menu items and string resources. Additionally, legacy USB communication stubs (\CommunicationHandler\, \CommandsProto\) and unused test files have been removed, leaving the \app/src\ directory free of these initial scaffolding artifacts.

app/src · high confidence

Behavioural changes

1 commit (0 fixes) modifying macos/assets

A change to existing behaviour in macos/assets — 1 commit, 1 file: “chore: build DMG for macOS (\#2954)” (refs \#2954).

macos/assets · low confidence · unverified

Theme system refactored to use Material 3 and centralized color definitions

The application's visual presentation has been updated to use Material 3, with the theme configuration now explicitly set to \useMaterial3: true\. To support this and improve maintainability, hardcoded color values have been extracted from the theme file into a dedicated \colors.dart\ file, which defines specific colors for UI components like checkboxes, radios, and various instrument-specific elements (e.g., oscilloscope, multimeter, logic analyzer). The app now defaults to a light theme with a white scaffold background, and the previous dark mode support has been removed.

lib/theme · high confidence

Unified communication handler with platform-specific implementations

The communication layer has been refactored to use a single \CommunicationHandler\ interface with distinct implementations for each platform: \PSLabCommunicationHandler\ for native desktop and Android (using Rust bindings for USB access), \WebCommsHandler\ for the web version (using the Web Serial API), and \WifiCommsHandler\ for Wi-Fi connections (using WebSockets). A router (\platform\_handler.dart\) automatically selects the correct handler based on the runtime environment, ensuring consistent behavior across iOS (stubbed), Android, desktop, and web targets.

lib/communication/handler · high confidence

Test coverage

1 commit adding/updating tests in test/others; Added E2E screenshot integration tests; Added initial macOS test suite scaffold; Added integration tests for Rust library initialization; Added tests for app version resolution, data chart analysis, and sensor controls.

Dependencies

Gradle wrapper upgraded to version 9.8.0 and relocated to Android module

The Gradle wrapper has been updated from version 3.3 to 9.8.0, introducing a significantly newer build toolchain for the Android project. Additionally, the wrapper configuration file has been moved from the project root to the android/gradle/wrapper directory, and a network timeout setting has been added to improve build stability.

android/gradle · high confidence

Migrated Android build to Flutter and added Rust native library support

The Android build system has been completely replaced, removing the legacy Gradle configuration (Android Gradle Plugin 2.2.3, compileSdk 25) and replacing it with the Flutter Gradle plugin (version 1.0.0) and Android Gradle Plugin 9.4.1. This change introduces a new Rust native library (\rust\_lib\_pslab\) integrated via Cargokit, enabling cross-platform FFI capabilities. The project now targets Android SDK 34, requires Java 17, and includes updated dependency manifests for both the Flutter application (\pubspec.yaml\) and the Rust crate (\Cargo.toml\).

(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 58.9 → 58.5 (-0.4)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 73.5 → 68.5 (-5.0)
  • Architecture 95.8 → 94.4 (-1.4)
  • Maturity 66.4 → 68.7 (+2.3)
  • Readiness 66.2 → 64.9 (-1.3)
  • Security 51.2 → 51.2 (0.0)
  • Performance 60.9 → 60.0 (-0.9)

Resolved (29)

  • Duplicated block (10 lines × 2) (rust/src/api/common.rs)
  • Duplicated block (10–11 lines × 4) (lib/communication/pslab_communication/pslab_functions.dart)
  • Duplicated block (11–13 lines × 2) (lib/view/connect_device_screen.dart)
  • Duplicated block (12 lines × 2) (lib/communication/pslab_communication/pslab_functions.dart)
  • Duplicated block (128–129 lines × 2) (lib/view/widgets/accelerometer_card.dart)
  • Duplicated block (13 lines × 2) (lib/view/accelerometer_config_screen.dart)
  • Duplicated block (13 lines × 2) (lib/view/accelerometer_config_screen.dart)
  • Duplicated block (14 lines × 2) (lib/view/widgets/accelerometer_card.dart)
  • Duplicated block (14 lines × 8) (lib/view/widgets/data_analysis_widget.dart)
  • Duplicated block (15 lines × 5) (lib/view/widgets/data_analysis_widget.dart)
  • Duplicated block (17 lines × 2) (lib/providers/barometer_state_provider.dart)
  • Duplicated block (18 lines × 2) (rust/src/api/common.rs)
  • Duplicated block (19 lines × 7) (lib/view/ads1115_screen.dart)
  • Duplicated block (21 lines × 2) (lib/view/accelerometer_config_screen.dart)
  • Duplicated block (25 lines × 3) (lib/providers/logic_analyzer_state_provider.dart)
  • Duplicated block (39 lines × 6) (lib/view/ads1115_screen.dart)
  • Duplicated block (41 lines × 2) (lib/communication/pslab_communication/pslab_functions.dart)
  • Duplicated block (5 lines × 2) (lib/providers/logic_analyzer_state_provider.dart)
  • Duplicated block (60 lines × 2) (lib/view/widgets/accelerometer_card.dart)
  • Duplicated block (9 lines × 2) (lib/communication/analytics_class.dart)
  • …and 9 more

New (116)

  • Documentation: no build, run or usage example (rust_builder/cargokit/build_tool/README.md)
  • Duplicated block (10–11 lines × 4) (lib/communication/pslab_communication/pslab_functions.dart)
  • Duplicated block (11–13 lines × 2) (lib/view/connect_device_screen.dart)
  • Duplicated block (12 lines × 2) (lib/communication/pslab_communication/pslab_functions.dart)
  • Duplicated block (12 lines × 2) (lib/providers/compass_provider.dart)
  • Duplicated block (12 lines × 2) (rust/src/api/common.rs)
  • Duplicated block (13 lines × 2) (lib/view/accelerometer_config_screen.dart)
  • Duplicated block (13 lines × 2) (lib/view/accelerometer_config_screen.dart)
  • Duplicated block (14 lines × 8) (lib/view/widgets/data_analysis_widget.dart)
  • Duplicated block (15 lines × 5) (lib/view/widgets/data_analysis_widget.dart)
  • Duplicated block (17 lines × 2) (lib/providers/barometer_state_provider.dart)
  • Duplicated block (19 lines × 7) (lib/view/ads1115_screen.dart)
  • Duplicated block (21 lines × 2) (lib/view/accelerometer_config_screen.dart)
  • Duplicated block (39 lines × 6) (lib/view/ads1115_screen.dart)
  • Duplicated block (41 lines × 2) (lib/communication/pslab_communication/pslab_functions.dart)
  • Duplicated block (8–9 lines × 2) (lib/communication/sensors/vl53l0x.dart)
  • Edited copies of one member (3 members, 11+ corresponding lines) (lib/others/temperature_service.dart)
  • Edited copies of one member (3 members, 15+ corresponding lines) (lib/models/accelerometer_config.dart)
  • Edited copies of one member (3 members, 47+ corresponding lines) (lib/view/logic_analyzer_config_screen.dart)
  • Edited copies of one member (3 members, 9+ corresponding lines) (lib/models/accelerometer_config.dart)
  • …and 96 more

Changes since last survey

  • 13 commits — 11 feature/other, 2 fixes

By area

  • lib/view — 4 commits
  • (root) — 3 commits
  • .github/workflows — 2 commits
  • android/gradle — 2 commits
  • android/settings.gradle — 1 commit
  • lib/main.dart — 1 commit

Notable commits

  • fix: fix: broken locatisation after Flutter upgrade
  • fix: fix: match scoped feat commits for minor version bump
  • change: chore(deps): upgrade Flutter to 3.50.0 (#3713)
  • change: chore: Bump com.android.application from 9.5.0 to 9.5.1 in /android (#3701)
  • change: chore: Bump file_picker from 13.3.0 to 13.3.2 (#3702)
  • change: chore: Bump fl_chart from 1.3.0 to 1.3.1 (#3711)
  • change: chore: Bump flutter_litert from 3.10.0 to 4.1.1
  • change: chore: Bump gradle-wrapper from 9.8.2 to 9.9.0 in /android (#3705)
  • change: chore: Bump gradle-wrapper from 9.9.0 to 9.9.1 in /android
  • change: chore: make sure that tag has expected format for release (#3708)
  • change: feat(accessibility): add localized semantics and tests for MultimeterKnob (#3703)
  • change: feat(accessibility): add localized semantics and tests for PowerSourceKnob (#3704)
  • change: feat(accessibility): add localized semantics for CompassScreen and CompassDial (#3706)

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

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/pslab-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 135ea3aa87c83511e2e9f6b745b179c1337e5980 — 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.