decent-app

Your response is missing the required `status` and `message` fields.

51|20|Updated Jan 29, 2025
One-click install
npx skills add https://github.com/tadelv/reaprime --skill decent-app
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decent-app
Source: https://github.com/tadelv/reaprime/tree/main/.agents/skills/decent-app
Command: npx skills add https://github.com/tadelv/reaprime --skill decent-app

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

It eliminates the friction of manually starting, stopping, and validating a Decent Flutter app by providing a repeatable shell-driven workflow for exercising its REST and WebSocket surfaces against simulated devices or real BLE/USB hardware.

Core Features & Use Cases

  • Lifecycle control: start, stop, reload, hot-restart, and restart a running Decent instance using the repo’s deterministic helper script.
  • REST API execution: quickly call endpoints with curl for device state, machine control, profiles, shots, and settings.
  • WebSocket stream verification: subscribe to live channels with websocat for real-time telemetry and structured connection status.
  • Simulated device workflows: run MockDe1 and MockScale flows by default, including common integration-style smoke tests.
  • Hardware exercise mode: opt into real device transport with --real (and adb port forwarding for Android) to validate real-world behavior.

Quick Start

Start the app in simulate mode, verify REST is reachable, then stop it by running: scripts/sb-dev.sh start --connect-machine MockDe1; curl -sf http://localhost:8080/api/v1/devices | jq .; scripts/sb-dev.sh stop

Frequently Asked Questions about decent-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate REST API testing and WebSocket verification for a Flutter app?

You can automate REST API testing and WebSocket verification for a Flutter app by driving its endpoints with curl and websocat from the shell. This provides a repeatable workflow for exercising device state, telemetry streams, and lifecycle control.

Can I run simulated device workflows and smoke tests without real BLE or USB hardware?

Yes, you can run simulated device workflows without real hardware by starting the app in simulate mode. This executes MockDe1 and MockScale flows by default, enabling common integration-style smoke tests directly from the shell.

What shell tools do I need to execute e2e verification scenarios against a running app instance?

To execute e2e verification scenarios you need bash, curl, jq, and websocat installed. These shell tools interact with the app's REST and WebSocket APIs to validate real-time telemetry and structured connection status.

How do I start, stop, and reload a running Flutter app instance deterministically?

You can start, stop, and reload a running Flutter app instance deterministically by using a dedicated shell script. This script manages the app lifecycle, including hot-restart functionality, for reliable development workflows.

Does this workflow support validating real-world behavior on Android devices with real hardware?

Yes, it supports validating real-world behavior on Android devices by opting into real device transport with a flag. This requires adb port forwarding to exercise the real BLE and USB hardware connections.

Can I treat REST and WebSocket API definitions as authoritative contracts for guided testing?

Yes, you can treat REST and WebSocket API definitions as authoritative contracts for guided testing. The provided YAML contract files define the exact endpoints and channels used for validating machine control, shots, and settings.