Nipaplay Theme UI
Designnipaplay-theme-uiNipaplay Theme UI is an Agent Skill for design published in the AimesSoft/NipaPlay-Reload repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when creating, refactoring, or reviewing UI for the Nipaplay Flutter theme. Always inspect the developer-options Nipaplay UI preview and reuse controls from lib/themes/nipaplay/widgets before writing new UI.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/AimesSoft/NipaPlay-Reload/blob/HEAD/skills/nipaplay-theme-ui/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/nipaplay-theme-ui, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Nipaplay Theme UI
Use this skill for any task that creates, changes, or reviews UI in the Nipaplay theme.
Required Workflow
- Inspect the UI reference page first:
lib/themes/nipaplay/pages/settings/nipaplay_ui_preview_window.dart- In the app, it is opened from Developer Options as
Nipaplay 设计 UI 预览.
- Identify the UI pattern needed from the preview:
- Main tabs
- Fluent-style switches
- Project dropdowns
- Hover-scale text/icon buttons
- Settings rows
- Settings cards and divided containers
- Nipaplay windows/dialogs
- Find and reuse the matching widget under:
lib/themes/nipaplay/widgets/
- Only create a new widget when no suitable widget exists.
- If a missing pattern is reusable, add it under
lib/themes/nipaplay/widgets/first, then use it from the page.
Reuse Rules
- Do not hand-write a duplicate
MouseRegion + GestureDetector + AnimatedScalebutton in a page. UseHoverScaleTextButton. - Do not use Flutter default
TabBarstyling directly for Nipaplay UI. UseNipaplayMainTabBarandHoverZoomTab. - Do not inline settings-row/card visuals in pages when
SettingsItem,SettingsCard,NipaplayDemoSection, or existing Nipaplay widgets cover the pattern. - Do not keep one-off UI state in a page solely for hover color/scale if an existing widget already handles it.
- All Nipaplay-theme-specific reusable controls must live in
lib/themes/nipaplay/widgets/.
Common Widgets
- Tabs:
NipaplayMainTabBar,HoverZoomTab - Hover text/icon button:
HoverScaleTextButton - Dropdown:
BlurDropdown - Switch:
FluentSettingsSwitch - Settings rows:
SettingsItem - Settings cards/containers:
SettingsCard,NipaplayDemoSection - Windows/dialog shells:
NipaplayWindow,NipaplayWindowScaffold,BlurDialog
Review Checklist
- Did the implementation check the developer-options UI preview first?
- Does the page import reusable widgets from
lib/themes/nipaplay/widgets/? - Are there duplicated hover buttons, tabs, cards, switches, or dropdowns?
- If a new widget was added, is it under
lib/themes/nipaplay/widgets/? - Does the UI preview need to be updated to show the new reusable component?