Skip to content

[Proposal] UX, Error Handling, and Onboarding Improvements for Complex Instruments #3131

@Diksha-MukherjeeAgarwal

Description

Hi FOSSASIA team! 👋

After contributing a few PRs recently, I spent some time exploring the PSLab app from a first-time user’s perspective to better understand the overall experience. The ecosystem is really impressive, but I noticed a few friction points—especially around UX, onboarding, and error handling for more complex instruments.

Before drafting a more detailed proposal (potentially for GSoC), I wanted to check whether these observations align with the current direction of the project and get your feedback.

🛑 Observations

1. Silent Failures & Limited UI Feedback
In some cases, the app does not provide feedback when an action fails.

Example:

  1. Open the Gas Sensor.
  2. Keep the hardware disconnected.
  3. Try interacting with the interface.

Current behavior:
•No visible feedback is shown to the user.

•Additionally, some interactive elements lack clear tap states (e.g., ripple effects or visual response), which can make the UI feel unresponsive.

2. Limited Onboarding for Complex Instruments
While tools like Oscilloscope and Multimeter are well-supported with documentation, more advanced instruments such as:

•Logic Analyzer,
•Gas Sensor,
do not currently have step-by-step guides that help users move from hardware setup to actual usage.

  1. Steeper Learning Curve for Beginners
    Some instrument dashboards can be difficult to interpret for first-time users (e.g., early undergraduate students or those without prior hardware experience), which may limit accessibility.

💡 Potential Directions (Open to Feedback)

Improved Error Handling & Feedback

•Introduce Toasts/Snackbars for disconnected devices or failed actions.
•Add visual tap states to interactive UI elements.

Guided Onboarding

•Add beginner-friendly, step-by-step experiment guides in the incomplete documention of these instruments.
•Possibly integrate them in-app or via Markdown-based documentation.
•Enhanced UI Feedback & Responsiveness.

Improve visual feedback for user interactions (e.g., button states, loading indicators)

Add subtle animations (e.g., transitions, active states, or even a more dynamic splash/logo experience).

Ensure the interface clearly reflects system state (connected, disconnected, processing, etc.).

🟨Feedback Request

I’d really appreciate your guidance on:

Whether these areas align with current priorities.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions