Skip to content

nexu-io/open-design / plugins/community/hallmark

hallmark

Flagged

Anti-AI-slop design skill for greenfield pages, audits, redesigns, and design extraction from URLs or screenshots. Use when the user asks to build a new app or landing page, wants to redesign something, invokes Hallmark by name, or uses audit/redesign/study.

FileKindSize
LICENSEother1.1 KB
SKILL.mdskill md61.5 KB
open-design.jsonconfig1.4 KB
references/anti-patterns.mdmarkdown24.6 KB
references/assets.mdmarkdown24.7 KB
references/color.mdmarkdown4.2 KB
references/component-cookbook.mdmarkdown27.9 KB
references/components/c1-outlined-chip.mdmarkdown464 B
references/components/c2-inline-form-as-cta.mdmarkdown672 B
references/components/c3-typographic-link.mdmarkdown280 B
references/components/c4-sticky-bottom-bar.mdmarkdown671 B
references/components/f1-bento-grid.mdmarkdown782 B
references/components/f2-sticky-scroll-stack.mdmarkdown899 B
references/components/f3-tabular-spec-sheet.mdmarkdown419 B
references/components/f4-step-sequence.mdmarkdown448 B
references/components/f5-annotated-screenshot.mdmarkdown410 B
references/components/f6-product-card-grid.mdmarkdown2.7 KB
references/components/ft1-mast-headed.mdmarkdown501 B
references/components/ft2-inline-rule-single-line.mdmarkdown362 B
references/components/ft3-index-style-category-list.mdmarkdown483 B
references/components/ft4-dense-typographic.mdmarkdown501 B
references/components/ft5-statement.mdmarkdown1.3 KB
references/components/ft6-letter-close.mdmarkdown1.1 KB
references/components/ft7-newsletter-first.mdmarkdown1.7 KB
references/components/ft8-marquee-scroll.mdmarkdown1.5 KB
references/components/h1-marquee.mdmarkdown507 B
references/components/h2-split-diptych.mdmarkdown600 B
references/components/h3-quote-led.mdmarkdown420 B
references/components/h4-stat-led.mdmarkdown509 B
references/components/h5-letter-hero.mdmarkdown361 B
references/components/h6-photographic-fold.mdmarkdown586 B
references/components/h7-demo-video-clipped-by-viewport-edge.mdmarkdown1.6 KB
references/components/h8-mockup-split-browser-framed.mdmarkdown1.3 KB
references/components/h9-custom-illustration-centerpiece.mdmarkdown1.4 KB
references/components/n1-wordmark-2-links.mdmarkdown388 B
references/components/n10-floating-on-scroll-morph.mdmarkdown1.4 KB
references/components/n2-floating-chip.mdmarkdown617 B
references/components/n3-side-rail.mdmarkdown536 B
references/components/n4-hidden-behind-k.mdmarkdown373 B
references/components/n5-floating-pill.mdmarkdown1.4 KB
references/components/n6-newspaper-masthead.mdmarkdown1.6 KB
references/components/n7-brutal-slab.mdmarkdown1.3 KB
references/components/n8-terminal-command.mdmarkdown1.6 KB
references/components/n9-edge-aligned-minimal.mdmarkdown867 B
references/components/s1-left-margin-numbered.mdmarkdown495 B
references/components/s2-hanging.mdmarkdown357 B
references/components/s3-sticky-pinned.mdmarkdown1.2 KB
references/components/s4-inline-no-break.mdmarkdown438 B
references/components/s5-bottom-anchored.mdmarkdown358 B
references/components/t1-pull-quote-with-marginalia.mdmarkdown465 B
references/components/t2-logo-wall-hairline.mdmarkdown733 B
references/components/t3-single-huge-quote.mdmarkdown490 B
references/components/t4-numbered-stat-strip.mdmarkdown470 B
references/contract.mdmarkdown1.3 KB
references/copy.mdmarkdown12.0 KB
references/custom-craft.mdmarkdown33.3 KB
references/custom-theme.mdmarkdown19.6 KB
references/design-md.mdmarkdown6.7 KB
references/export-formats.mdmarkdown13.3 KB
references/floating-nav.mdmarkdown5.1 KB
references/genres/atmospheric.mdmarkdown3.9 KB
references/genres/editorial.mdmarkdown3.7 KB
references/genres/modern-minimal.mdmarkdown3.9 KB
references/genres/playful.mdmarkdown3.8 KB
references/hero-enrichment.mdmarkdown30.7 KB
references/imagery-kit.mdmarkdown8.3 KB
references/interaction-and-states.mdmarkdown12.7 KB
references/layout-and-space.mdmarkdown6.0 KB
references/macrostructures.mdmarkdown11.3 KB
references/macrostructures/01-bento-grid.mdmarkdown1.8 KB
references/macrostructures/02-long-document.mdmarkdown1.7 KB
references/macrostructures/03-marquee-hero.mdmarkdown1.6 KB
references/macrostructures/04-stat-led.mdmarkdown1.6 KB
references/macrostructures/05-workbench.mdmarkdown1.7 KB
references/macrostructures/06-conversational-faq.mdmarkdown1.6 KB
references/macrostructures/07-manifesto.mdmarkdown1.7 KB
references/macrostructures/08-photographic.mdmarkdown1.5 KB
references/macrostructures/09-quote-led.mdmarkdown1.8 KB
references/macrostructures/10-specimen.mdmarkdown1.6 KB
references/macrostructures/11-catalogue.mdmarkdown1.2 KB
references/macrostructures/12-letter.mdmarkdown1.2 KB
references/macrostructures/13-index-first.mdmarkdown1.2 KB
references/macrostructures/14-narrative-workflow.mdmarkdown1.4 KB
references/macrostructures/15-split-studio.mdmarkdown1.3 KB
references/macrostructures/16-feature-stack.mdmarkdown1.4 KB
references/macrostructures/17-type-specimen.mdmarkdown1.2 KB
references/macrostructures/18-portfolio-grid.mdmarkdown1.0 KB
references/macrostructures/19-map-diagram.mdmarkdown1.2 KB
references/macrostructures/20-ecosystem-index.mdmarkdown1.2 KB
references/macrostructures/21-component-playground.mdmarkdown1.1 KB
references/microinteractions.mdmarkdown19.7 KB
references/motion.mdmarkdown4.2 KB
references/preview-examples.mdmarkdown2.8 KB
references/responsive.mdmarkdown5.8 KB
references/slop-test.mdmarkdown30.0 KB
references/structure.mdmarkdown15.7 KB
references/study.mdmarkdown41.8 KB
references/typography.mdmarkdown18.0 KB
references/verbs/audit.mdmarkdown2.7 KB
references/verbs/redesign.mdmarkdown13.5 KB

references/responsive.md

View on GitHub
# Responsive

Mobile-first. Content-driven breakpoints. No desktop-only interactions.

## Mobile — non-negotiable

Every Hallmark output must render flawlessly at **320 px, 375 px, 414 px, and 768 px** CSS-pixel widths. Eyeball each viewport before marking the output complete:

- No horizontal scroll (slop-test gate 36)
- No clickable text wrapping to two lines (gate 59)
- No image-bearing grid pushing the layout past viewport — use `minmax(0, 1fr)`, never bare `1fr`, on tracks containing images (gate 61)
- Root carries `overflow-x: clip` on both `html` and `body` — never `hidden` (gate 62)
- Display headers wrap inside long words via `overflow-wrap: anywhere; min-width: 0` (gate 63)
- Section heads collapse to one column on mobile across every theme variant — per-theme overrides need a matching mobile rule (gate 64)
- No scroll-jump on radio-tab clicks — radios in normal flow OR JS guard with `focus({ preventScroll: true })` (gate 65)

This is a hard floor, not a wish list. A page that fails any of these on any of those four widths is not done. The slop-test gates listed run automatically — keep this checklist near the screen while building.

## Principles

- Base styles are for the smallest viewport. `min-width` media queries add as you go up. Never `max-width` as the primary direction.
- Breakpoints are where the *content* breaks, not where a device sits. If the headline reflows awkwardly at 720px, that's a breakpoint — regardless of what the Tailwind defaults say.
- Use `pointer` and `hover` media queries instead of width to detect *interaction capability*.

## Breakpoints

Three or four, content-driven. As a default:

```css
@media (min-width: 40rem) { /* ~640px — tablet, small laptop */ }
@media (min-width: 60rem) { /* ~960px — desktop baseline */ }
@media (min-width: 90rem) { /* ~1440px — wide */ }
```

Use `rem` so the breakpoints respect the user's font size.

## Fluid scaling

Prefer `clamp()` for sizes that change continuously; use media queries for layouts that change discretely.

```css
h1 { font-size: clamp(2.5rem, 4vw + 1rem, 6rem); }
.container { padding-inline: clamp(1rem, 4vw, 4rem); }
```

## Pointer and hover queries

```css
@media (hover: hover) and (pointer: fine) {
  .card:hover { transform: translateY(-2px); }
}
@media (pointer: coarse) {
  .btn { min-height: 48px; }
}
```

Never build a mouse-hover interaction that has no touch equivalent.

## Clickable text — never wraps

Buttons, primary nav links, footer links, tab labels, breadcrumbs, and CTAs must read as **single-line affordances at every viewport between 320 px and 1920 px**. A button or nav link wrapping to two lines looks broken — visitors read it as a styling error, not as intentional. The shortest fix is almost always to shorten the label.

```css
/* Affordances are single-line — let the parent reflow, not the label. */
.btn,
.nav__link,
.foot__link,
.cta {
  white-space: nowrap;
}
```

```css
/* When the row can't fit, collapse the row, not the labels. */
@media (max-width: 40rem) {
  .nav__rail { display: none; }      /* desktop nav hides */
  .nav__sheet-toggle { display: grid; } /* mobile menu shows */
}
```

**Order of fixes**, when something does wrap:

1. **Shorten the label.** *"Get started free"* → *"Start free"*. *"Read the documentation"* → *"Read docs"*. *"Schedule a demo"* → *"Book demo"*. Most CTA labels are 30–40 % longer than they need to be.
2. **`white-space: nowrap`** on the affordance, let the parent flex/grid reflow.
3. **`hidden=until-found`** the lowest-priority nav item at narrow widths (it remains in DOM for find-in-page and SEO).
4. **Collapse the nav** into a sheet / off-canvas / disclosure menu below a content-driven breakpoint.

**Never:** let a primary CTA or top-level nav link wrap. Long footer-link labels can wrap *only* in a footer column where wrapping is part of the column's rhythm — not in the inline footer link strip (Ft2).

This is gate **59** in [`slop-test.md`](slop-test.md). Audit any output that ships interactive affordances and confirm none wrap at the breakpoints listed above.

## Viewport units

- Use `dvh` / `svh` / `lvh` instead of `vh` for heights that interact with mobile chrome.
- Never `width: 100vw`. Use `width: 100%` with padding; `100vw` includes the scrollbar on desktop and causes overflow.

## Safe areas

For iOS notch / Android navigation bars:

```html
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
```

```css
body {
  padding-inline: max(1rem, env(safe-area-inset-left));
  padding-bottom: max(1rem, env(safe-area-inset-bottom));
}
```

## Tables on small screens

Tables of data that won't fit: collapse to cards. Use `display: block` on `<tr>` and `data-label` attributes keyed from `<th>`, rendered via `::before`. Or, the better option: redesign the data for small screens — tables are rarely the right mobile representation.

## Images

- `srcset` with width descriptors for responsive sizing.
- `<picture>` for art direction (different crop at different widths).
- `loading="lazy"` on anything below the fold.
- `width` and `height` attributes on every image, always, to avoid CLS.

## Internationalisation

- Reserve 30–40% extra horizontal space for German, Russian, and Finnish translations.
- Use logical properties: `margin-inline-start`, `padding-block`, `border-inline-end`. Not `margin-left` etc. RTL comes for free.
- Don't hard-code language-specific punctuation or date formats.

## Bans

- Desktop-first media queries (`max-width: 768px` as the primary direction).
- `vh` on full-height layouts (use `dvh`).
- `100vw` widths.
- Device-sniffing UA strings instead of feature queries.
- Hover-only interactions.
- Ignoring `prefers-color-scheme` when the app claims to support dark mode.
- Fixed pixel breakpoints that don't respect `rem`.
- Tables of 10+ columns on mobile without a redesign.
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: 471kUpdated 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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated 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