Aipay Frontend Theme
Designaipay-frontend-themeAipay Frontend Theme is an Agent Skill for design published in the OpenAIPay/openaipay repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when changing AiPay iOS frontend color style, replacing blue UI to purple, updating screenshot-based Reference pages, or enforcing component theme consistency across parallel threads. Applies to SwiftUI components and Assets.xcassets *Reference.imageset image replacements.
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.
Inspect the Agent Skill at https://github.com/OpenAIPay/openaipay/blob/HEAD/skills/aipay-frontend-theme/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/aipay-frontend-theme, 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.
AiPay Frontend Theme
Overview
This skill standardizes AiPay frontend theme changes so all threads produce the same result. It enforces token-first runtime styling and direct asset replacement for screenshot-based pages.
Workflow
- Read contract:
/Users/<username>/code/openaipay/docs/frontend-theme-component-contract.md
- If changing runtime components:
- Use
AppTheme.palettetokens from:/Users/<username>/code/openaipay/ios-app/OpenAiPay/Core/AppTheme.swift - Do not add new blue hardcoded colors.
- If changing Reference pages:
- Replace pixels directly in
Assets.xcassets/*Reference.imageset/*.png. - Do not add overlay/blend/tint layers to fake recolor.
- Validate before finishing:
- Run:
scripts/check-theme-contract.sh - Build iOS app to verify no regressions.
- Report output:
- List changed files.
- Explain whether change was token-based or asset replacement.
- Provide preview screenshot path when UI changed.
Guardrails
- Prefer the smallest possible change area.
- Never introduce a new full-screen color overlay for recoloring.
- If a rule must be bypassed, add
theme-check:allowon that line and explain why.
References
references/contract.md