funman300/Ferrous-Solitaire
1
1
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases 28 Wiki Activity

docs(ui): land the Terminal design system + 24-mockup library

Browse Source 
Adds the spec the recent visual-identity port pass referenced:

- design-system.md — base16-eighties palette, type scale, spacing
  scale, motion budget, component library, accessibility notes
  (color-blind toggle, high-contrast mode, glyph differentiation),
  and the canonical "Terminal" card-back theme.
- 24 Stitch-rendered mockups (HTML + PNG): 12 redesigned existing
  screens, 1 desktop home variant, 2 onboarding steps, and 9
  missing-plugin screens (splash, challenge, time-attack,
  weekly-goals, leaderboard, sync, level-up, replay, radial-menu).

These mockups are the source the engine plugins were ported
against in commits 0d477ac through 9891ae4 (token system,
modal scaffold, gameplay-feedback layer, toasts, table chrome,
card chrome, splash cursor, hint highlight). Future plugin work
should diff against the matching mockup before touching pixels.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
funman300
2026-05-07 18:47:57 -07:00
parent 9891ae4ba3
commit fa7f98ac52
49 changed files with 6261 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/ui-mockups/sync-mobile.html
+262
View File
@@ -0,0 +1,262 @@
<!DOCTYPE html>
<html class="dark" lang="en"><head>
<meta charset="utf-8"/>
<meta content="width=device-width, initial-scale=1.0" name="viewport"/>
<title>Rusty Solitaire - Sync Progress</title>
<script src="https://cdn.tailwindcss.com?plugins=forms,container-queries"></script>
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&amp;family=Inter:wght@400;500&amp;family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&amp;display=swap" rel="stylesheet"/>
<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&amp;display=swap" rel="stylesheet"/>
<script id="tailwind-config">
tailwind.config = {
darkMode: "class",
theme: {
extend: {
"colors": {
"surface-container-low": "#181c1f",
"highlight-valid": "#acc267",
"on-secondary-container": "#b2c86d",
"on-tertiary": "#4c195b",
"suit-black": "#d0d0d0",
"surface-container": "#1c2023",
"warning": "#ddb26f",
"outline": "#505050",
"error-container": "#93000a",
"on-secondary": "#293500",
"surface-dim": "#101417",
"on-primary-fixed": "#001e2c",
"secondary": "#bad073",
"on-surface": "#e0e3e6",
"primary": "#a1dcff",
"tertiary-fixed": "#fbd7ff",
"on-tertiary-container": "#683476",
"inverse-primary": "#00668a",
"on-surface-variant": "#bfc8cf",
"tertiary-fixed-dim": "#f0b0fc",
"surface-tint": "#7ed0fe",
"primary-container": "#6fc2ef",
"on-primary-container": "#004f6c",
"secondary-container": "#435401",
"suit-red-cb": "#6fc2ef",
"surface-container-high": "#272a2d",
"on-background": "#e0e3e6",
"on-primary": "#003549",
"highlight-celebration": "#e1a3ee",
"surface": "#151515",
"secondary-fixed": "#d5ec8c",
"on-primary-fixed-variant": "#004c69",
"surface-container-lowest": "#0b0f11",
"suit-red": "#fb9fb1",
"inverse-on-surface": "#2d3134",
"surface-variant": "#313538",
"on-tertiary-fixed-variant": "#653173",
"tertiary-container": "#e1a3ee",
"outline-variant": "#3f484e",
"inverse-surface": "#e0e3e6",
"primary-fixed-dim": "#7ed0fe",
"on-secondary-fixed": "#161e00",
"info": "#12cfc0",
"primary-fixed": "#c4e7ff",
"surface-container-highest": "#313538",
"on-tertiary-fixed": "#340043",
"on-error": "#690005",
"background": "#101417",
"secondary-fixed-dim": "#bad073",
"error": "#fb9fb1",
"tertiary": "#f7c3ff",
"on-error-container": "#ffdad6",
"on-secondary-fixed-variant": "#3c4d00",
"surface-bright": "#363a3d"
},
"borderRadius": {
"DEFAULT": "0.125rem",
"lg": "0.25rem",
"xl": "0.5rem",
"full": "0.75rem"
},
"spacing": {
"touch-target-min": "48dp",
"gutter-card": "0.375rem",
"action-bar-height": "64px",
"stack-overlap": "2rem",
"margin-edge": "1rem"
},
"fontFamily": {
"hud-timer": ["JetBrains Mono"],
"headline": ["JetBrains Mono"],
"card-rank": ["JetBrains Mono"],
"label-caps": ["JetBrains Mono"],
"hud-score": ["JetBrains Mono"],
"body-md": ["Inter"]
},
"fontSize": {
"hud-timer": ["16px", {"lineHeight": "24px", "fontWeight": "400"}],
"headline": ["28px", {"lineHeight": "32px", "letterSpacing": "-0.01em", "fontWeight": "700"}],
"card-rank": ["18px", {"lineHeight": "18px", "fontWeight": "700"}],
"label-caps": ["12px", {"lineHeight": "16px", "letterSpacing": "0.08em", "fontWeight": "500"}],
"hud-score": ["24px", {"lineHeight": "32px", "letterSpacing": "-0.02em", "fontWeight": "700"}],
"body-md": ["16px", {"lineHeight": "24px", "fontWeight": "400"}]
}
},
},
}
</script>
<style>
.material-symbols-outlined {
font-variation-settings: 'FILL' 0, 'wght' 400, 'GRAD' 0, 'opsz' 24;
display: inline-block;
vertical-align: middle;
}
.scanline {
background: linear-gradient(to bottom, transparent 50%, rgba(0, 0, 0, 0.1) 50%);
background-size: 100% 2px;
pointer-events: none;
}
</style>
<style>
body {
min-height: max(884px, 100dvh);
}
</style>
</head>
<body class="bg-surface text-on-surface font-body-md min-h-screen flex flex-col overflow-x-hidden selection:bg-primary-container selection:text-on-primary-container">
<!-- 1. Status Bar (Top) -->
<nav class="h-8 bg-[#202020] flex items-center justify-between px-4 border-b border-outline-variant z-50">
<div class="flex items-center gap-2">
<span class="font-headline text-[13px] tracking-tight text-on-surface-variant">▌sync.config</span>
</div>
<div class="flex items-center gap-3">
<div class="flex items-center gap-1.5">
<span class="w-2 h-2 rounded-full bg-warning animate-pulse"></span>
<span class="font-label-caps text-[11px] text-warning">PENDING</span>
</div>
<span class="font-label-caps text-[11px] text-outline">v0.20.0</span>
</div>
</nav>
<!-- Shared TopAppBar Component -->
<header class="bg-surface flex justify-between items-center w-full px-margin-edge h-action-bar-height max-w-full border-b border-outline-variant">
<div class="font-headline text-headline text-primary tracking-tighter uppercase">▌RS_TERMINAL_OS</div>
<div class="hidden md:flex gap-6 items-center">
<a class="font-label-caps text-label-caps uppercase tracking-widest text-on-surface-variant hover:text-primary transition-colors duration-120" href="#">PLAY</a>
<a class="font-label-caps text-label-caps uppercase tracking-widest text-on-surface-variant hover:text-primary transition-colors duration-120" href="#">DAILY</a>
<a class="font-label-caps text-label-caps uppercase tracking-widest text-primary border-b-2 border-primary pb-1" href="#">STATS</a>
</div>
<div class="flex gap-4">
<span class="material-symbols-outlined text-primary cursor-pointer">account_circle</span>
<span class="material-symbols-outlined text-primary cursor-pointer">sync</span>
<span class="material-symbols-outlined text-primary cursor-pointer">settings</span>
</div>
</header>
<main class="flex-grow p-4 md:p-8 max-w-3xl mx-auto w-full space-y-6">
<!-- 2. Header Area -->
<div class="h-20 flex flex-col justify-center border-l-2 border-outline-variant pl-4">
<h1 class="font-headline text-[24px] font-bold text-suit-black leading-tight">SYNC PROGRESS</h1>
<p class="font-body-md text-[12px] text-[#a0a0a0]">Connect to a server to sync games across devices.</p>
</div>
<!-- 3. Status Card -->
<section class="bg-[#202020] rounded-[4px] p-4 border-l-[4px] border-warning flex flex-col gap-1">
<h2 class="font-label-caps text-[10px] text-[#a0a0a0] uppercase tracking-widest">STATUS</h2>
<div class="flex flex-col">
<span class="font-headline text-[16px] font-bold text-[#a0a0a0]">○ NOT SIGNED IN</span>
<span class="text-[11px] text-outline font-medium">Local progress only · Last attempt: never</span>
</div>
</section>
<!-- 4. Login Form Card -->
<section class="bg-[#202020] border border-outline-variant rounded-[4px] p-4 flex flex-col gap-5">
<div class="flex items-center gap-2 border-b border-outline-variant pb-2 mb-1">
<span class="font-headline text-[12px] text-[#a0a0a0] flex items-center">
▌ AUTH.toml <span class="ml-1 w-1.5 h-3 bg-primary-container animate-pulse"></span>
</span>
</div>
<!-- Server URL -->
<div class="flex flex-col gap-1.5">
<label class="font-label-caps text-[10px] text-[#a0a0a0] uppercase tracking-widest">server_url</label>
<div class="h-12 bg-[#1a1a1a] border border-outline-variant rounded-[2px] flex items-center px-4">
<span class="font-headline text-[13px] text-suit-black">https://sync.rusty-solitaire.app</span>
</div>
</div>
<!-- Email -->
<div class="flex flex-col gap-1.5">
<label class="font-label-caps text-[10px] text-[#a0a0a0] uppercase tracking-widest">email</label>
<div class="h-12 bg-[#1a1a1a] border border-outline-variant rounded-[2px] flex items-center px-4">
<span class="font-headline text-[13px] text-outline">/ user@example.com</span>
</div>
</div>
<!-- Passcode -->
<div class="flex flex-col gap-1.5">
<label class="font-label-caps text-[10px] text-[#a0a0a0] uppercase tracking-widest">passcode</label>
<div class="h-12 bg-[#1a1a1a] border border-outline-variant rounded-[2px] flex items-center justify-between px-4">
<span class="font-headline text-[13px] text-outline">•••••••• (12 chars)</span>
<span class="material-symbols-outlined text-outline cursor-pointer text-[18px]">visibility</span>
</div>
</div>
</section>
<!-- 5. Form Actions -->
<div class="grid grid-cols-2 gap-4">
<button class="h-12 bg-primary-container text-surface flex items-center justify-center rounded-[2px] font-headline text-[14px] font-bold active:scale-95 transition-transform">
▶ SIGN IN
</button>
<button class="h-12 border border-outline text-suit-black flex items-center justify-center rounded-[2px] font-headline text-[13px] font-medium hover:border-primary-container hover:text-primary-container transition-all">
+ CREATE ACCOUNT
</button>
</div>
<!-- 6. Recent History Panel -->
<section class="bg-[#202020] rounded-[4px] p-4 flex flex-col gap-3">
<h2 class="font-label-caps text-[12px] text-[#a0a0a0] uppercase tracking-widest">RECENT</h2>
<div class="space-y-2 border-l border-outline-variant pl-4">
<div class="font-headline text-[11px] text-[#a0a0a0] flex items-center gap-2">
<span class="text-outline">2026-05-07 17:38</span>
<span class="text-outline">·</span>
<span>○ no auth</span>
<span class="text-outline">·</span>
<span>skip</span>
</div>
<div class="font-headline text-[11px] text-[#a0a0a0] flex items-center gap-2">
<span class="text-outline">2026-05-07 14:12</span>
<span class="text-outline">·</span>
<span>○ no auth</span>
<span class="text-outline">·</span>
<span>skip</span>
</div>
<div class="font-headline text-[11px] text-[#a0a0a0] flex items-center gap-2">
<span class="text-outline">2026-05-06 09:01</span>
<span class="text-outline">·</span>
<span class="text-highlight-valid">✓ synced 12 games</span>
</div>
</div>
</section>
</main>
<!-- 7. Footer -->
<footer class="h-10 bg-surface border-t border-outline-variant flex items-center justify-between px-4 fixed bottom-0 w-full z-50">
<div class="flex items-center gap-2 font-headline text-[11px]">
<span class="text-primary-container">▌ NORMAL</span>
<span class="text-outline">│</span>
<span class="text-on-surface-variant">sync</span>
</div>
<div class="flex items-center gap-4 font-headline text-[11px] text-outline uppercase tracking-wider">
<span>[ENTER] <span class="text-on-surface-variant">sign in</span></span>
<span>[ESC] <span class="text-on-surface-variant">cancel</span></span>
</div>
</footer>
<!-- Shared BottomNavBar Component (Mobile Only) -->
<nav class="md:hidden fixed bottom-10 w-full z-50 flex justify-around items-center h-action-bar-height px-margin-edge bg-surface-container border-t border-outline-variant">
<div class="flex flex-col items-center justify-center text-on-surface-variant p-2 hover:bg-surface-bright transition-all duration-120">
<span class="material-symbols-outlined" data-icon="videogame_asset">videogame_asset</span>
<span class="font-label-caps text-[10px] uppercase tracking-widest mt-1">F1_NEW_GAME</span>
</div>
<div class="flex flex-col items-center justify-center text-on-surface-variant p-2 hover:bg-surface-bright transition-all duration-120">
<span class="material-symbols-outlined" data-icon="event_upcoming">event_upcoming</span>
<span class="font-label-caps text-[10px] uppercase tracking-widest mt-1">F2_CHALLENGE</span>
</div>
<div class="flex flex-col items-center justify-center text-primary dark:text-primary-fixed-dim bg-surface-container-highest rounded-none p-2 transition-all duration-120 scale-95">
<span class="material-symbols-outlined" data-icon="query_stats">query_stats</span>
<span class="font-label-caps text-[10px] uppercase tracking-widest mt-1">F5_STATS</span>
</div>
<div class="flex flex-col items-center justify-center text-on-surface-variant p-2 hover:bg-surface-bright transition-all duration-120">
<span class="material-symbols-outlined" data-icon="power_settings_new">power_settings_new</span>
<span class="font-label-caps text-[10px] uppercase tracking-widest mt-1">ESC_EXIT</span>
</div>
</nav>
<!-- Decorative Screen Texture -->
<div class="fixed inset-0 pointer-events-none opacity-[0.03] scanline z-[100]"></div>
</body></html>