8000 Add DESIGN.md design standard by kladak · Pull Request #1 · kladak/trinity-care · GitHub
[go: up one dir, main page]

Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions DESIGN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# DESIGN.md

Design rules. Read before touching any UI. Full guide: AI Slop Field Guide, Nov 11, 2026.

Process: before writing any UI code, output a design brief (the palette as named tokens with hex values, the two typefaces and why, the layout idea in two sentences, the one motion idea, and how the reference shows up). Wait for approval. Do not build from an unapproved brief. Build the whole page from that brief; if it drifts, say so. When done, run the self-review at the bottom and fix what it finds before showing anything.

Banned, never, without being asked by name: slate-900 or any near-black blue-gray page background; radial gradient blobs, blurred glows, or "orbs" as backgrounds; gradient text (purple-to-pink, blue-to-cyan, any of it); purple as a primary accent (if the brief needs purple, justify it); icons inside rounded-square or circular badges, and icons in feature lists at all unless the icon carries meaning a word cannot; three-column feature grids with icon, title, two lines of copy; bento grids, unless every cell shows real data from this product; fake charts, fake sparklines, fake toggles, fake cursors, fake dashboards (if it is not real, it does not ship); tilted or 3D-perspective screenshots (screenshots are flat, at 1x, and real); drop shadows with a blur over 24px, glowing borders, border-beam effects; a taller, glowing, or "Most Popular" pricing card (all tiers equal; recommend with copy, not with height); testimonials, logo bars, star ratings, or "Trusted by N" counts that are not literally true with named, real sources (no proof beats fake proof); stock photos of people (no Unsplash headshots, ever); pills above the headline ("Now with AI," "New," sparkle emoji); emoji anywhere in UI text; the words supercharge, seamless, effortless, unlock, elevate, empower, revolutionize, next-generation, AI-powered, all-in-one, game-changing, unleash, and any headline that could sit on a competitor's site unchanged; Inter, Roboto, Open Sans, or the system font as the display face (fine for body, never for the words people read first); bouncing, pulsing, or looping animations that exist to look alive; marquees of anything; rounded-2xl on everything (pick one radius and mean it).

Required: one background color, one ink color, one accent, tokens named for their job (bg, ink, accent), never Tailwind palette names; two typefaces max (a display face with a point of view, and a body face built for reading at 17 to 19px; real type scale with the hero 4 to 6 times body size, tight tracking on display, 1.5 to 1.7 line height on body); whitespace as a feature (sections breathe; only one thing on each screen deserves attention); asymmetry somewhere (a pulled-left headline, an offset image, a column narrower than the others on purpose); the headline names what the product does for whom, in words the customer would use (specific beats clever); every number on the page is true and every quote has a real name and a real company, otherwise the section does not exist; motion as one idea used consistently (ease-out entrances under 400ms; nothing loops; nothing moves unless the user did something or the content just arrived); screenshots and product imagery are real captures from this product, flat, with a 1px border or no border; buttons look like buttons (one primary, one secondary, no gradients); mobile is designed, not squeezed (check it at 390px before showing anything).

Self-review before showing anything: go through the page and list every element that (1) appears on the banned list, (2) could be deleted with zero loss of information, (3) would look at home on a generic SaaS template, (4) contains a claim you cannot prove, (5) uses a color, radius, or shadow not in the brief. Fix all of it, then show the page and the list of what changed.

Before shipping: score the rendered page at desktop and 375px against the 30 tells / 20 indicators. A different model checks. Record the result in AUDIT.md.
Loading
0