smartisan-inspired-ui

Smartisan-Inspired UI

中文说明

An installable Codex plugin and Agent Skill for designing, reviewing, and planning raster assets in an independent cold-mist porcelain interface language inspired by J1Assistant and the restrained tactility associated with Smartisan-era UI.

This is a clean-room design project. It is not an official Smartisan product and contains no firmware, decompiled code, official icons, proprietary fonts, or extracted system assets.

What the Skill does

• Turns a product brief or existing screen into a cross-platform design specification.
• Reviews UI hierarchy, tokens, components, states, motion, accessibility, and style drift.
• Produces image-generation prompts and QA steps for medallions, state illustrations, textures, wallpapers, and concept previews.
• Separates code-native functional UI from raster-suitable generated assets.
• Applies clean-room and non-affiliation boundaries when a request mentions firmware or official material.

The Skill is framework-neutral. Its machine-readable tokens describe color, spacing, radius, borders, shadows, typography, motion, target sizes, and states without binding the output to Flutter, Android, iOS, or Web.

Install as a Codex plugin

Add this repository as a marketplace source:

codex plugin marketplace add jcx396905-gif/smartisan-inspired-ui

Install the plugin:

codex plugin add smartisan-inspired-ui@smartisan-ui

Start a new task after installation so Codex can discover the Skill.

Install only the Skill

Copy plugins/smartisan-inspired-ui/skills/smartisan-inspired-ui into ~/.agents/skills/smartisan-inspired-ui, then restart Codex if it does not appear automatically.

Use it

Invoke it explicitly:

$smartisan-inspired-ui Design a mobile settings page with a central voice ripple and five destinations.

It can also trigger from requests such as:

把这个设置页改成冷雾灰、瓷面轻拟物的锤子/J1Assistant 风格。
Review this screen for Smartisan-inspired style drift and accessibility issues.
Create a production prompt for a cohesive set of porcelain Agent medallions.

The Skill intentionally does not trigger for generic Material UI work, firmware extraction, reverse engineering, or copying official assets.

Design summary

The style is quiet at rest and tactile on press:

• Cold-mist paper #E3E9EC, porcelain #EFF3F7, compact nav white #F6F8FB.
• Orange #FF6D30 for the current action; blue-gray #8295C6 for calm selection.
• Thin low-contrast hairlines, 8–10 radius paper cards, 24 radius capsules, circular porcelain medallions.
• Grouped rows with rounded exposed ends, compact centered top bars, five-entry navigation, and an optional central ripple connected to Agent nodes.
• 80–90 ms press response, 140 ms surface changes, 180 ms controls, 240 ms page motion, with a no-translation reduced-motion fallback.
• 44-unit minimum targets, visible focus, non-color-only state cues, screen-reader semantics, and 200% text scaling.

The full contract lives in design-tokens.json and the focused references beside the Skill.

Image-generation guidance

Use raster generation for illustrations, textures, wallpapers, concept previews, and organically rendered medallions. Build functional controls and exact UI geometry in code or vector.

For simple transparent assets, the default workflow is a 1024-square master on flat #FF00FF, followed by local soft-matte removal, despill, and alpha-edge inspection. Complex transparency such as hair, glass, smoke, or liquids requires an explicitly confirmed native-transparency path. Validate final assets at 20, 24, 44, and 56 pixels.

Repository layout

.agents/plugins/marketplace.json        Marketplace entry
plugins/smartisan-inspired-ui/          Installable plugin
  .codex-plugin/plugin.json             Plugin metadata
  skills/smartisan-inspired-ui/         Skill, references, tokens, assets
scripts/                                Deterministic validation and artwork rendering
tests/                                  Validator, renderer, and Skill evaluations
docs/research-methodology.md             Clean-room research method

Validate

The repository validator uses only the Python standard library. Artwork regeneration requires Pillow.

python -m unittest discover -s tests -v
python scripts/render_assets.py
python scripts/validate_repo.py .

Validation rejects private absolute paths and common firmware, archive, bytecode, font, and decompilation file types.

Contributing

See CONTRIBUTING.md. Keep contributions original, framework-neutral, progressively disclosed, and free of proprietary source material.

License and trademarks

Original project material is available under the MIT License. Smartisan, 锤子, 坚果, and related marks belong to their respective owners. The license does not grant rights to third-party trademarks, firmware, code, fonts, or visual assets. See NOTICE.md.