mirror of
https://github.com/nexu-io/open-design.git
synced 2026-06-01 03:14:35 +07:00
6f6bf31dd2
* Refactor project name from "Open Claude Design" to "Open Design" - Updated project name in package.json, package-lock.json, and README files. - Changed CLI commands and references from "ocd" to "od". - Adjusted file structure references in documentation and code to reflect new naming conventions. - Enhanced .gitignore to include new runtime data files. - Updated metadata in LICENSE file to match new project name. * Add contributing guidelines in English and Chinese - Introduced CONTRIBUTING.md and CONTRIBUTING.zh-CN.md to provide clear instructions for contributors. - Outlined contribution types, local setup instructions, and merging criteria for skills and design systems. - Enhanced README files to reference the new contributing guidelines.
46 lines
3.6 KiB
Markdown
46 lines
3.6 KiB
Markdown
# Mobile app checklist
|
|
|
|
Run this before emitting `<artifact>`. P0 must pass.
|
|
|
|
## P0 — must pass
|
|
|
|
- [ ] **Frame looks like a phone, not a generic card.** Dynamic Island visible, status bar SVG icons present (signal/wifi/battery), home indicator at bottom. The seed already does this — verify you didn't accidentally delete the island/rails/indicator markup.
|
|
- [ ] **Status bar shows real glyphs**, not text like `· · · 5G · 100%`. Use the SVG icons from the seed.
|
|
- [ ] **Home indicator is the last visible thing.** Anything below it (e.g. extra padding, accidental `<div>`) breaks the illusion.
|
|
- [ ] **Content scrolls, frame doesn't.** `<main class="content">` has `overflow-y: auto`; the surrounding `.device` does not. The page background never moves.
|
|
- [ ] **Tap targets ≥ 44px tall.** The seed's `.btn-primary` (48px), `.tab` (~50px), `.icon-btn` (36px ≥ touch with padding), `.list-row` (≥48px with padding) all pass. Don't ship a button under 44px.
|
|
- [ ] **Body text ≥ 14px.** `--fs-body: 15px` already enforces this on most copy. List-row sub text uses 13px max — that's the floor.
|
|
- [ ] **One accent, used at most twice on the screen.** Typically: one active tab + one CTA, OR one accent card + one tab. Never three.
|
|
- [ ] **No external image URLs.** Use the `.ph-img` placeholder class. External CDN images break the OD preview iframe and look fake when they 404.
|
|
- [ ] **Tab bar matches the screen kind.** Onboarding / detail / checkout: drop the `<nav class="tabbar">` entirely. Feed / focus / profile: keep it.
|
|
- [ ] **Display headlines use `var(--font-display)` (serif).** The seed binds this via `.h1`, `.h2`, `.header h1`. Don't override headings to system-sans — it instantly looks like a stock template.
|
|
- [ ] **No emoji icons in the UI.** SVG monoline only. Emoji in copy is fine ("9:41 ☀️ Tuesday" is not, but "Sunny day in Berlin" is).
|
|
- [ ] **`data-od-id` on the device, content, header, and any major sections.**
|
|
|
|
## P1 — should pass
|
|
|
|
- [ ] **One screen, one job.** A profile screen does profile things. Don't graft a checkout form onto a feed.
|
|
- [ ] **Caption above the device** names the screen (e.g. "FILEBASE · INBOX"). The seed already has the slot — fill it.
|
|
- [ ] **Status bar time is `9:41`** (Apple convention) unless the brief asks otherwise.
|
|
- [ ] **Mono font for numerics** — counts, prices, durations, dates. The seed's `.num` class binds this.
|
|
- [ ] **Real, specific copy.** "Mira Hassan · CTO" beats "User Name". "$1,920" beats "$X,XXX".
|
|
- [ ] **First-screen content fits inside the 844px frame** without requiring scroll for the primary action. If the CTA is below the fold, it's the wrong layout.
|
|
|
|
## P2 — nice to have
|
|
|
|
- [ ] **Subtle accent radial gradient on the page background** (already in seed). Removing it makes the device feel pasted onto a flat sheet.
|
|
- [ ] **Backdrop-blurred tab bar** (already in seed via `backdrop-filter`).
|
|
- [ ] **At most one image placeholder per screen.** Two placeholders on a small canvas competes for attention.
|
|
- [ ] **Subtle metallic side rails on the bezel** (already in seed via `::before`/`::after`).
|
|
|
|
## Anti-fake-device checklist
|
|
|
|
If any of these are true, the screen looks like a *card pretending to be a phone* rather than a phone:
|
|
|
|
- The device's outer corners aren't visibly more rounded (~56px) than the inner screen (~44px).
|
|
- There's no Dynamic Island gap at the top centre.
|
|
- The status bar text is grey or low-opacity (it should be `var(--fg)` at full strength).
|
|
- The home indicator is missing.
|
|
- The bottom tab bar has no top border or no backdrop blur.
|
|
|
|
The seed prevents all of these — the most common regression is the agent rewriting the frame with `border-radius: 24px` and losing the depth.
|