Skip to content

UI_PLAN.md

Latest commit

 

History

History
86 lines (75 loc) · 2.95 KB

UI_PLAN.md

File metadata and controls

86 lines (75 loc) · 2.95 KB

Schnarps UI Plan

Last updated: 2026-02-27

Purpose

Define the locked UI/UX direction for Phase 4 alpha and guide implementation priorities.

Locked Product Focus

  • Primary user value:
    • Recommend the next action.
    • Quantify outcomes for each candidate action.
    • Examples:
      • Punt probability vs hit probability.
      • Expected points for each legal action.
  • Secondary user value:
    • Show win probability for each player.

Locked Interaction Rules

  • Input model: click-to-play only.
  • Undo: none.
  • Turn timeouts: none.
  • Probability visibility: context-dependent, but available across all phases:
    • bidding
    • choose_trump
    • in_out
    • play

Locked Layout and Information Hierarchy

  • Target resolution for first-release design: 1920x1080.
  • Composition:
    • Center region: gameplay table and live card play.
    • Bottom-anchored panels: recommendations, action-outcome stats, and player win probabilities.
  • Hierarchy:
    • First glance: recommended next action + outcome breakdown.
    • Second glance: player win probability panel.
    • Third glance: detailed history and supporting context.

Locked Card Presentation

  • Player hand uses explicit card graphics.
  • Opponent hands appear face-down until cards are played.
  • Played cards appear in table center.
  • Play animation (opponent card to center) is planned; can ship as a post-alpha enhancement if needed.

Visual Design Direction

  • Must feel sleek and polished.
  • Provide 2-3 switchable visual themes for user preference.
  • Initial theme set:
    • Classic Felt: traditional green table, warm accents, serif score styling.
    • Slate Pro: dark slate table, high-contrast data panels, modern typography.
    • Ivory Studio: light premium tabletop look, muted neutrals, refined accent color.
  • Theme toggle requirements:
    • User can switch themes without reload.
    • Theme choice persists locally across sessions.

Phase-State UX (Balanced Looks vs Complexity)

  • Bidding:
    • Show bid ladder and recommendation confidence.
    • Show outcome estimates for each bid/pass action.
  • Trump selection:
    • Show suit options with estimated downstream risk/reward.
  • In/Out:
    • Show IN vs OUT recommendation and expected impact.
  • Card play:
    • Highlight legal cards.
    • Show top candidates with quantified outcomes.
    • Show active trick context near table center.

Alpha Implementation Scope

  • Include now:
    • Gameplay table at center.
    • Click-to-play interactions.
    • Bottom action-outcome panel.
    • Bottom per-player win probability panel.
    • Theme toggle (3 options).
  • May defer:
    • Rich transition choreography.
    • Advanced replay cinematics.
    • Complex hover-driven analytics overlays.

Acceptance Criteria

  • At 1920x1080, no panel overlap during active gameplay.
  • User can complete full game interactions via click-only flow.
  • Recommendation/outcome panel updates every actionable turn in all phases.
  • Win-probability panel is visible and updated for all players.
  • Theme switch works live and persists.