scrcpy-option-ui-builder
This skill should modify the category screens and add the requested scrcpy options to the UI, depending on the type of the option (text, toggle, dropdown, etc.). Use this skill for adding new scrcpy options in the UI.
When & Why to Use This Skill
This Claude skill is a specialized UI automation tool designed to streamline the development of scrcpy configuration screens. It automates the process of adding new scrcpy options—such as toggles, text fields, and dropdowns—by modifying Flutter-based category screens, updating navigation routes, and managing internationalization (i18n) files. By following project-specific architectural patterns, it ensures that new UI components are consistent, maintainable, and correctly mapped to their corresponding CLI arguments.
Use Cases
- Adding new configuration toggles or text inputs to existing scrcpy settings screens to support updated command-line arguments.
- Creating entirely new configuration category screens with scrollable layouts and integrating them into the application's main navigation pane.
- Automating the boilerplate code for UI widgets and ensuring that all necessary translations are added to the localization files for a consistent user experience.
- Mapping new scrcpy CLI argument classes to UI controls to enable real-time updates and persistence of user settings.
| name | scrcpy-option-ui-builder |
|---|---|
| description | This skill should modify the category screens and add the requested scrcpy options to the UI, depending on the type of the option (text, toggle, dropdown, etc.). Use this skill for adding new scrcpy options in the UI. |
Scrcpy option UI builder
Working directory: /lib/presentation/scrcpy_config/
UI option screens are present in @lib/presentation/scrcpy_config.
Common, re-usable widgets are present in @lib/presentation/scrcpy_config/widgets.
Steps
- Gather information
- Extend or create UI code in the
<category_screen>.dartfile - Create necessary translations for the the UI Control
1. Gather information
- Refer to /docs/scrcpy_options to find information about the scrcpy option (Argument, name, description, is advanced).
- Find the corresponding argument class in /lib/application/model/scrcpy/arguments/
- If the argument class doesn't exist, first create it using this skill
- Use this argument class in the UI code to get existing value and to update it.
2. Create <category_screen>.dart
- Refer to /lib/presentation/scrcpy_config/video_screen.dart
- Create a similar scrollable screen with necessary dependencies for the new category screen.
- Create a new route inside routes.dart
- Introduce new
NavigationPaneIteminside home_screen.dart using the new route - Follow the next section to extend the screen code with UI controls.
2. Extend existing UI Code
- If the
<category_screen>.dartfile for requested scrcpy option and the respective category already exists, then extend the ScrollableColumn, with the new control(s)
Use /lib/presentation/scrcpy_config/widgets/config_item.dart for wrapping the actual UI control.
- The
ConfigItemwidget expects:
label(key and translation label) to show title, description and argument tooltip.childthe actual control widget (toggle/switch/text input/comboBox/etc.)
- Use
ConfigTextBoxfor text input controls
3. Create translations
- Currently, the project only supports english language.
- The translation file is present here
- Refer to the existing translations under this path inside the JSON: e.g.
confg/video/noVideo - Expected path:
config/<category>/<argument.label> - Required translations:
title,description,arg - Optional:
default(default value for the control e.g. for comboBox)