32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
|
# Mastercard Usage
|
||
|
|
|
||
|
|
Design System 2.0 package guide for OpenDesign agents and reviewers.
|
||
|
|
|
||
|
|
## Read Order
|
||
|
|
|
||
|
|
1. Read this file first to understand the package contract.
|
||
|
|
2. Read `DESIGN.md` for visual intent, constraints, and anti-patterns.
|
||
|
|
3. Paste `tokens.css` into the first artifact `<style>` block before writing component CSS.
|
||
|
|
4. Use `components.manifest.json` for the compact component inventory; open `components.html` when exact selectors or states matter.
|
||
|
|
5. Inspect `preview/` pages when a visual sanity check is useful.
|
||
|
|
|
||
|
|
## Design Highlights
|
||
|
|
|
||
|
|
- Warm cream canvas (`#F3F0EE`) replaces traditional white — every surface is tinted, never sterile
|
||
|
|
- Extreme border-radius as design language: 40px, 99px, 1000px dominate; anything square is a cookie-banner third-party
|
||
|
|
- Circular image portraits with attached white satellite-CTAs and traced-orange orbital paths
|
||
|
|
- Ghost "watermark" headlines (cream-on-cream text at heading scale) layered behind circle portraits
|
||
|
|
|
||
|
|
## Do
|
||
|
|
|
||
|
|
- Preserve the schema token names exactly so cross-brand switching stays reliable.
|
||
|
|
- Use `--accent` for primary actions, links, focus states, and one clear focal element.
|
||
|
|
- Reuse component groups from `components.manifest.json` before inventing new controls.
|
||
|
|
- Treat `source/` files as audit evidence for the bundled fixture backfill.
|
||
|
|
|
||
|
|
## Avoid
|
||
|
|
|
||
|
|
- Avoid raw hex values outside the copied `:root` token block.
|
||
|
|
- Avoid redefining Tailwind or design-token values independently of `tokens.css`.
|
||
|
|
- Avoid claiming original upstream source evidence; this package is based on the curated bundled fixture.
|
||
|
|
- Avoid adding new component recipes that are not represented in `components.html` or `DESIGN.md`.
|