Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-design

hyper-design

Verified

[Hyper] Use this skill when the user wants interface design work that must not look AI-generated - designing a new screen, page, or component, restyling an existing UI, building faux product UI for a hero, feature card, or demo, or auditing, cleaning, or verifying generic template patterns in an interface - driven by a written design direction, a numeric craft floor, static detection, and evidence-separated review, with briefs and reports saved under `.hyper/design/[slug]/`. Do not use it for backend or data work with no visual surface, accessibility-only or performance-only QA, brand strategy with no interface, or a reusable skill folder.

FileKindSize
SKILL.ko.mdmarkdown24.9 KB
SKILL.mdskill md22.7 KB
assets/design-brief-template.ko.mdmarkdown2.4 KB
assets/design-brief-template.mdmarkdown2.2 KB
assets/detector-config.schema.jsonconfig1.9 KB
assets/evals/contract-cases.jsonlother3.5 KB
assets/evals/detector-cases.jsonlother10.2 KB
assets/evals/hyper-design-cases.jsonlother23.3 KB
assets/fixtures/context/brand-gradient/DESIGN.ko.mdmarkdown170 B
assets/fixtures/context/brand-gradient/DESIGN.mdmarkdown164 B
assets/fixtures/context/brand-gradient/hero.htmlother181 B
assets/fixtures/context/pricing-comparison/pricing.htmlother467 B
assets/fixtures/context/real-status/status.htmlother112 B
assets/fixtures/context/reduced-motion-project/accessibility.cssother75 B
assets/fixtures/context/reduced-motion-project/animation.cssother117 B
assets/fixtures/detector-negative.htmlother352 B
assets/fixtures/detector-positive.htmlother401 B
assets/fixtures/rendered-evidence/dimension-mismatch.jsonconfig557 B
assets/fixtures/rendered-evidence/fresh.jsonconfig582 B
assets/fixtures/rendered-evidence/invalid.jsonconfig253 B
assets/fixtures/rendered-evidence/measurements.jsonconfig1.3 KB
assets/fixtures/rendered-evidence/no-measurements.jsonconfig367 B
assets/fixtures/rendered-evidence/signature-mismatch.jsonconfig557 B
assets/fixtures/rendered-evidence/stale.jsonconfig556 B
assets/fixtures/rendered-evidence/valid.jsonconfig515 B
assets/fixtures/rendered-evidence/window-frame.jsonconfig558 B
assets/fixtures/reports/all-ids-one-row.ko.mdmarkdown644 B
assets/fixtures/reports/all-ids-one-row.mdmarkdown651 B
assets/fixtures/reports/authorship-claim.ko.mdmarkdown417 B
assets/fixtures/reports/authorship-claim.mdmarkdown403 B
assets/fixtures/reports/empty-reason-evidence.ko.mdmarkdown1.4 KB
assets/fixtures/reports/empty-reason-evidence.mdmarkdown1.3 KB
assets/fixtures/reports/empty-section.ko.mdmarkdown354 B
assets/fixtures/reports/empty-section.mdmarkdown350 B
assets/fixtures/reports/invalid-static-claim.ko.mdmarkdown345 B
assets/fixtures/reports/invalid-static-claim.mdmarkdown341 B
assets/fixtures/reports/missing-wcag-table.ko.mdmarkdown411 B
assets/fixtures/reports/missing-wcag-table.mdmarkdown419 B
assets/fixtures/reports/passing-no-wcag-table.ko.mdmarkdown364 B
assets/fixtures/reports/passing-no-wcag-table.mdmarkdown360 B
assets/fixtures/reports/valid-v2.ko.mdmarkdown379 B
assets/fixtures/reports/valid-v2.mdmarkdown377 B
assets/fixtures/reports/valid-wcag-table.ko.mdmarkdown1.4 KB
assets/fixtures/reports/valid-wcag-table.mdmarkdown1.4 KB
assets/fixtures/reports/wcag-list-no-table.ko.mdmarkdown484 B
assets/fixtures/reports/wcag-list-no-table.mdmarkdown483 B
assets/fixtures/reports/wrong-criterion-id.ko.mdmarkdown1.4 KB
assets/fixtures/reports/wrong-criterion-id.mdmarkdown1.4 KB
assets/fixtures/rules/border-shadow.cssother100 B
assets/fixtures/rules/brand-monospace.htmlother182 B
assets/fixtures/rules/clickable-div.htmlother102 B
assets/fixtures/rules/dead-anchor.htmlother66 B
assets/fixtures/rules/declaration-rules-negative.cssother113 B
assets/fixtures/rules/declaration-rules.cssother91 B
assets/fixtures/rules/decorative-monospace.htmlother125 B
assets/fixtures/rules/decorative-pulse.cssother120 B
assets/fixtures/rules/detector-config-allow.jsonconfig155 B
assets/fixtures/rules/detector-config-invalid.jsonconfig63 B
assets/fixtures/rules/detector-config-motion-off.jsonconfig74 B
assets/fixtures/rules/detector-config-nonstring-allowlist.jsonconfig40 B
assets/fixtures/rules/detector-config-nonstring-rule-value.jsonconfig52 B
assets/fixtures/rules/detector-config-rules.jsonconfig85 B
assets/fixtures/rules/detector-config-unknown-rule.jsonconfig59 B
assets/fixtures/rules/em-dash.htmlother106 B
assets/fixtures/rules/generic-cta.htmlother171 B
assets/fixtures/rules/gradient-border-image-negative.cssother96 B
assets/fixtures/rules/gradient-border-image.cssother131 B
assets/fixtures/rules/grid-background.cssother151 B
assets/fixtures/rules/hard-stop-band-negative.cssother78 B
assets/fixtures/rules/hard-stop-band.cssother86 B
assets/fixtures/rules/identical-icon-cards.htmlother458 B
assets/fixtures/rules/ignore-slop.htmlother286 B
assets/fixtures/rules/inset-stripe-negative.cssother93 B
assets/fixtures/rules/inset-stripe.cssother84 B
assets/fixtures/rules/media-unsized.htmlother132 B
assets/fixtures/rules/motion-without-reduced-motion.cssother121 B
assets/fixtures/rules/naming-rules-negative.htmlother273 B
assets/fixtures/rules/naming-rules.htmlother291 B
assets/fixtures/rules/numbered-section-labels.htmlother275 B
assets/fixtures/rules/pseudo-stripe-negative.cssother209 B
assets/fixtures/rules/pseudo-stripe.cssother181 B
assets/fixtures/rules/radial-glow.cssother100 B
assets/fixtures/rules/repeated-eyebrows.htmlother292 B
assets/fixtures/rules/skipped-heading.htmlother113 B
assets/fixtures/rules/thin-side-stripe-negative.cssother73 B
assets/fixtures/rules/thin-side-stripe.cssother81 B
assets/fixtures/rules/viewport-height.cssother65 B
assets/fixtures/rules/zoom-blocked.htmlother206 B
assets/fixtures/unsupported.txtmarkdown57 B
assets/fixtures/waivers/invalid-global.jsonconfig197 B
assets/report-template.ko.mdmarkdown3.0 KB
assets/report-template.mdmarkdown3.0 KB
assets/waiver.example.jsonconfig280 B
assets/waiver.schema.jsonconfig871 B
references/accessible-interaction.ko.mdmarkdown8.8 KB
references/accessible-interaction.mdmarkdown7.6 KB
references/anti-pattern-catalog.ko.mdmarkdown17.0 KB
references/anti-pattern-catalog.mdmarkdown16.4 KB
references/browser-evidence-schema.ko.mdmarkdown3.2 KB
references/browser-evidence-schema.mdmarkdown2.9 KB
references/chart-artifact.ko.mdmarkdown3.7 KB
references/chart-artifact.mdmarkdown3.2 KB
references/context-signals.ko.mdmarkdown3.0 KB
references/context-signals.mdmarkdown2.8 KB
references/contrast-check.ko.mdmarkdown4.5 KB
references/contrast-check.mdmarkdown4.3 KB
references/eval-rubric.ko.mdmarkdown1.9 KB
references/eval-rubric.mdmarkdown1.8 KB
references/fix-playbook.ko.mdmarkdown5.4 KB
references/fix-playbook.mdmarkdown5.3 KB
references/korean-break-quality.ko.mdmarkdown4.0 KB
references/korean-break-quality.mdmarkdown3.4 KB
references/mockup-craft.ko.mdmarkdown7.4 KB
references/mockup-craft.mdmarkdown6.1 KB
references/native-platforms.ko.mdmarkdown6.8 KB
references/native-platforms.mdmarkdown5.9 KB
references/performance-baseline.ko.mdmarkdown4.2 KB
references/performance-baseline.mdmarkdown3.6 KB
references/print-paged.ko.mdmarkdown4.8 KB
references/print-paged.mdmarkdown4.4 KB
references/rendered-measurements.ko.mdmarkdown4.4 KB
references/rendered-measurements.mdmarkdown3.9 KB
references/replacement-patterns.ko.mdmarkdown2.6 KB
references/replacement-patterns.mdmarkdown2.5 KB
references/responsive-reflow.ko.mdmarkdown7.1 KB
references/responsive-reflow.mdmarkdown6.1 KB
references/screen-patterns.ko.mdmarkdown9.5 KB
references/screen-patterns.mdmarkdown8.1 KB
references/ui-copy.ko.mdmarkdown5.1 KB
references/ui-copy.mdmarkdown4.7 KB
rules/craft-floor.ko.mdmarkdown18.6 KB
rules/craft-floor.mdmarkdown16.2 KB
rules/delivery-gate.ko.mdmarkdown10.5 KB
rules/delivery-gate.mdmarkdown9.4 KB
rules/design-direction.ko.mdmarkdown11.9 KB
rules/design-direction.mdmarkdown10.2 KB
rules/evidence-and-severity.ko.mdmarkdown3.2 KB
rules/evidence-and-severity.mdmarkdown3.2 KB
rules/independent-review.ko.mdmarkdown9.1 KB
rules/independent-review.mdmarkdown8.1 KB
rules/rendered-evidence.ko.mdmarkdown6.3 KB
rules/rendered-evidence.mdmarkdown5.7 KB
rules/safe-editing.ko.mdmarkdown2.9 KB
rules/safe-editing.mdmarkdown2.8 KB
rules/slop-taxonomy.ko.mdmarkdown6.4 KB
rules/slop-taxonomy.mdmarkdown5.9 KB
rules/validation-and-reporting.ko.mdmarkdown6.0 KB
rules/validation-and-reporting.mdmarkdown5.5 KB
rules/waivers-and-baselines.ko.mdmarkdown5.1 KB
rules/waivers-and-baselines.mdmarkdown4.6 KB
rules/workflow.ko.mdmarkdown8.4 KB
rules/workflow.mdmarkdown7.5 KB
scripts/analyze-structure.shexecutablescript3.6 KB
scripts/collect-rendered-evidence.shexecutablescript16.9 KB
scripts/detect-slop.shexecutablescript21.2 KB
scripts/engine-css.shexecutablescript517 B
scripts/engine-markup.shexecutablescript3.7 KB
scripts/engine-text.shexecutablescript563 B
scripts/resolve-context.shexecutablescript3.5 KB
scripts/rule-registry.shexecutablescript15.4 KB
scripts/rule-shared.shexecutablescript20.3 KB
scripts/run-contract-evals.shexecutablescript5.7 KB
scripts/run-detector-evals.shexecutablescript6.9 KB
scripts/validate-report.shexecutablescript12.2 KB
scripts/validate-waivers.shexecutablescript4.5 KB

references/native-platforms.md

View on GitHub
# Native Platforms

Read when the work is an iOS or Android screen — SwiftUI, UIKit, Jetpack Compose, or the platform views — instead of a web page. The platform replaces the web rules in this package: system type styles and Dynamic Type replace CSS type tokens, safe areas replace viewport padding, navigation stacks and tabs replace page routing, and platform colors replace hex tokens. The brief, the tokens, and the delivery gate do not change; only the surface does.

## Contents

- 1. Type and scaling
- 2. Safe areas and insets
- 3. Navigation and structure
- 4. Touch and controls
- 5. Color and appearance
- 6. Evidence for a native screen
- 7. Web rules that transfer only as principles

## 1. Type and scaling

| Tell | Why | Fix |
|---|---|---|
| Fixed text sizes tuned for one device | Users raise or lower the text size; fixed values overflow or crowd at other settings | Start from the platform text styles and let the system scale them; check the smallest and largest sizes before delivery |
| A size list copied from a CSS scale (16/20/24/32px) | The app reads as a web page squeezed into a phone | Map each role to the nearest system style, then break ties with the token plan |
| Text that clips at the largest size | The layout has no room to grow | Let containers grow or wrap; keep lines of text out of fixed-height boxes |

## 2. Safe areas and insets

| Tell | Why | Fix |
|---|---|---|
| Content pinned to the screen edges | The notch, the status bar, the home indicator, or the gesture area covers it | Inset to the safe area; the platform layout primitives do this by default, so never ignore the insets |
| A fixed header that ignores the status bar and home indicator | Text and controls sit under system chrome | Let the platform place its own chrome; add a custom bar below it |
| One layout for phone, tablet, foldable, and split-screen windows | The phone layout stretched looks like a mistake | Treat the compact and regular widths as different layouts, the way `responsive-reflow.md` treats the phone and the desktop |

## 3. Navigation and structure

| Tell | Why | Fix |
|---|---|---|
| A web-style top menu rendered inside the app | The user has to learn the site again | Use the platform containers: navigation stacks for drill-down, tabs for the few primary destinations, a sheet for a bounded task |
| Back buttons that go nowhere or just close the app | The stack was never modeled | The top of the stack is the list; every pushed screen can return to its parent |
| Every screen a modal | Sheets promise a short task and a clear exit | Push for hierarchy, and reserve sheets for bounded tasks |

## 4. Touch and controls

| Tell | Why | Fix |
|---|---|---|
| Controls smaller than the touch floor | A finger is not a cursor | 44pt on iOS and 48dp on Android as the minimum, with padding or a larger hit area when the visual is smaller. The evidence and the reason are in `responsive-reflow.md` §5 |
| Two adjacent targets that read as one | The thumb touches the wrong one | A clear gap so one press area never covers the next |
| Anything that exists only on hover | There is no hover on a touchscreen | A tap equivalent for every hover interaction, with visible pressed feedback |
| Gestures without a visible alternative | Some users cannot perform the gesture | A button or menu path for the same action |

## 5. Color and appearance

| Tell | Why | Fix |
|---|---|---|
| Hard-coded hex colors everywhere | Dark mode, forced colors, and higher-contrast settings break the screen | Semantic platform colors (label, secondary label, background, separators, and the Android equivalents); they carry the light and dark values and the accessibility settings with them |
| Every theme re-tuned by hand after switching | Each value drifted from its role | Name the role once, then resolve it per appearance |
| Dark mode chosen because it "looks tech" | A trend, not a product decision | Both appearances work, unless the brief pins one; verify both before delivery |

## 6. Evidence for a native screen

A CSS token, a Lighthouse report, or a browser screenshot never proves anything about an app. Proof for a native screen is one of:

- A simulator or device capture at the checked size classes, with the text-size setting stated.
- The accessibility inspector output for the screen: labels, roles, and states, not the builder's impression.
- The platform preview or screenshot tests the project already runs, named with their output.

Without a simulator or device, mark the rendered items `static_only` or `unavailable` with the reason, exactly as a missing browser is reported in the web path. Never report a visual or accessibility pass from the source alone.

## 7. Web rules that transfer only as principles

Contrast, the purpose test, honest placeholders, and the delivery gate transfer unchanged — they are about the product, not the medium. What does not transfer: CSS tokens, breakpoint names, hover and cursor behavior, browser chrome, Lighthouse numbers, and any viewport claim. When a web rule and a platform rule disagree, the platform rule wins for the app, and the disagreement is written down in the brief.

## Sources

> Checked 2026-11-09.

| Claim | Source |
|---|---|
| System text styles are the starting point for type on Apple platforms, and the styles scale with the preferred text size | <https://developer.apple.com/design/human-interface-guidelines/typography> |
| The Compose Material 3 type scale, and building app UI in Compose | <https://developer.android.com/develop/ui/compose>, <https://m3.material.io/styles/typography/overview> |
| The idea and the section shape (platform rules replace web rules; proof is a simulator or device capture, not a browser mockup) | `dbc-hbin/omp-ulw @ 74df40f` (2026-11-09), re-authored in this package's own words; the source repository has no license and no text or code was copied |

### Evidence grade

The platform facts come from the vendor guidance above. The rest is a practitioner rule set over this package's existing rules, with no measurements taken.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall