Skip to content

Redesign/centralized color picker - #42

Merged
Dunkrick merged 7 commits into
mainfrom
redesign/centralized-color-picker
Nov 2, 2026
Merged

Dunkrick merged 7 commits into
mainfrom
redesign/centralized-color-picker

Conversation

@Dunkrick

@Dunkrick Dunkrick commented Nov 2, 2026

Copy link
Copy Markdown
Owner

Summary

This pull request unifies canvas interaction, paper stock personalization, and authentication ergonomics across the Nook frontend:

  1. Centralized Paper Stock Dashboard: Replaces individual in-card tint pickers with a dedicated, tactile, left-docked color dashboard that controls selected thoughts or sets the default paper stock for newly dropped thoughts.
  2. Precision Spatial Delta Cursor: Introduces a custom stemless delta arrowhead pointer (--cursor-spatial) for the spatial canvas and corkboard, engineered with dual-stroke contrast for visibility across all surfaces.
  3. Elevated Insight Panel: Refines the "pattern finder" experience with a living status badge, functional pulsing beacon dot, and thought-scan hint.
  4. Side-by-Side Icon OAuth Login: Consolidates Google and GitHub login actions on the authentication form into a balanced, accessible two-column grid.
  5. Documentation Alignment: Updates project documentation, changelog, and interaction architecture to reflect v1.3.0 artifact tinting.

Story of Changes

1. Centralized Paper Stock Dashboard (ColorDashboard.tsx, overlays.css, Home.tsx)

  • De-cluttered Thought Cards: Removed the inline popover picker from individual card headers (ArtifactHeader.tsx, ArtifactActions.tsx, TintPicker.tsx), allowing notes to look clean and uninterrupted.
  • Docked Palette: Added a persistent, tactile left panel (.nook-color-dashboard) displaying all seven paper stocks (Default, Cream, Rose, Sky, Sage, Lavender, Butter).
  • Physical Feedback & Motion:
    • Swatches lift on hover (translate(2px, -1px) with hard ink drop shadow 2px 2px 0 var(--palette-ink)).
    • Swatch click triggers a tactile stamp compression (translate(1px, 1px) with zero shadow).
    • Selected swatch features a centered functional ink dot mark (.nook-color-dashboard__swatch-mark) per design rule 9.
    • Dynamic subtitle smoothly previews the hovered/focused tint name before returning to thought count or default state.
    • Full keyboard accessibility with ArrowUp / ArrowDown navigation across swatches.
  • Smooth Card Settle: Added transition: background-color var(--motion-settle) in artifact.css so thought cards glide smoothly into their new paper stock.

2. Canvas Vector Delta Cursor (interaction.css, workspace.css)

  • Delta Arrowhead Pointer: Replaced the default OS pointer with a geometric, stemless delta arrowhead cursor symmetrical across the $45^\circ$ diagonal ($y = x$).
  • Dual-Stroke Contrast: Layered a 1.5px white outline over the #17141F ink fill, backed by a subtle contrast shadow border (stroke-opacity="0.3" stroke-width="3.2") so the pointer remains crisp over light paper, grid dots, and dark cards.
  • Hotspot: Configured active click hotspot at (2, 2) matching the northwest tip.

3. Insight Panel Living Status (InsightPanel.tsx, overlays.css)

  • Pulsing State Mark: Replaced static status text with an instrument-style badge (.nook-insight-panel__working) featuring a lit beacon dot (.nook-insight-panel__beacon) pulsing in var(--accent-action).
  • Typographic Voice: Styled with font-family: var(--font-mono), bold uppercase tracking, and paper backing.
  • Accessible & Motion-Safe: Added a @media (prefers-reduced-motion: reduce) fallback to freeze the pulse smoothly.

4. Side-by-Side OAuth Login (AuthForm.tsx, auth.css)

  • Horizontal 2-Column Grid: Replaced vertically stacked buttons with an equal-width side-by-side grid (grid-template-columns: 1fr 1fr; gap: var(--space-3)).
  • Icon-Only Layout: Removed visible text strings ("Continue with Google", "Continue with GitHub"), displaying centered 20px vector brand marks.
  • Accessibility Floor: Preserved full screen-reader and tooltip clarity with explicit aria-label and title attributes on both anchor links.

5. Documentation & Interaction Spec

  • Updated README.md, CHANGELOG.md (v1.3.0), docs/architecture.md, docs/setup.md, and docs/design-system/interaction.md.

Decisions and Reasons

Decision Reason
Move tint picking from card headers to a docked panel Placing color pickers on every card header added visual noise and cramped the title bar. A centralized palette keeps cards clean and allows multi-card batch tinting.
Keep palette swatches active when 0 cards are selected Rather than disabling the palette into a dead/broken state, selecting a tint when idle sets the default paper stock for newly created thoughts in the workspace.
Preserve explicit Cmd/Ctrl card multi-selection (no single-click lock) Preserves fluid spatial panning and dragging without inadvertently selecting cards on casual clicks or background interactions. Canvas background clicks clear selection.
Stemless delta cursor over traditional stemmed arrow Directly matches the precision spatial feel of canvas thinking tools, providing an unobstructed view right beneath the pointer tip.
Two-column icon-only OAuth actions Reduces the vertical height of the authentication card while keeping third-party sign-in options equally weighted, clean, and fast to reach.
Zero raw CSS values (Tokens only) Adheres to Design System v2 rules (--radius-0, hard ink shadows, standard spacing, and semantically mapped palette roles).

Verification Results

Frontend

  • Lint: npm run lint — Clean (0 errors, 0 warnings).
  • Build: npm run build — tsc -b && vite build built successfully in 109ms.
  • Tests: npm test -- --run — 7 test files passed, 52/52 tests passed:
    • ColorDashboard.test.tsx (7 tests)
    • InsightPanel.test.tsx (2 tests)
    • PolaroidArtifactBody.test.tsx (23 tests)
    • PolaroidDraft.test.tsx (7 tests)
    • TintPicker.test.tsx (4 tests)
    • UseArtifactEditing.test.ts (6 tests)
    • canvas.test.ts (3 tests)
  • Token Rule: grep -rnE "#[0-9a-fA-F]{3,8}\b" src/assets/styles --include="*.css" | grep -v "/tokens/" returned 0 violations.

Backend

  • Typecheck: npm run typecheck — tsc --noEmit passed with 0 errors.
  • Tests: npm test — 11 test files passed, 76/76 tests passed.

@vercel

vercel Bot commented Nov 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
nook Ready Ready Preview Nov 2, 2026 1:10pm UTC

@Dunkrick
Dunkrick merged commit fdec959 into main Nov 2, 2026
3 checks passed
@Dunkrick
Dunkrick deleted the redesign/centralized-color-picker branch November 2, 2026 13:20

This branch was successfully deployed

1 active deployment
Preview — 1852e98b Deployed Nov 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant