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