docs(roadmap): v3.1 review pass — futurism amendment + Wave 13 + corrections
Comprehensive review of the v3.0 cross-repo UX roadmap. The diff grows
the doc from 370 to 591 lines (+60%); core structure preserved.
──────────────────────────────────────────────────────────────────
Bug fixes & corrections (no regressions)
──────────────────────────────────────────────────────────────────
- Product-web inventory: 11 → 15+ (was missing mindlyst-native/web,
talk2obsidian/web, productivity-web, sidecar-dashboard-web,
mac-tooling/dashboard, devops-tools/dashboard/web,
agent-monitoring-fx, local-llms/dashboard, efforise/client,
admin-web, tracker-web). New total: **20 web apps**.
- Net-new package count: 16 → 26 (the brand-* row was 3 packages,
not 1; plus Wave 13 adds 8 more)
- §4 heading: "five waves" → "six waves" (Wave 13 added)
- §10 metrics targets refreshed to reflect 20-app scope
- §11 hygiene bumped to v3.1 with full changelog
──────────────────────────────────────────────────────────────────
Major content amendments — "futurism layer"
──────────────────────────────────────────────────────────────────
NEW §3.4 On-device & privacy-first AI (8 surfaces)
• WebLLM / transformers.js for client-side LLM inference
• Privacy-mode toggle + GPC header honouring
• Explainable refusal, cost transparency, confidence transparency
• Provenance trails, telemetry opt-out, "Why did the AI say this?"
debug overlay
NEW §3.5 Real-time CRDT collaboration (6 patterns)
• Yjs canonical + Automerge adapter
• Liveblocks-grade presence (PresenceAvatars, TypingIndicator,
LiveCursor)
• Co-edit indicators, conflict-free sync, selective sharing,
comment threads anchored to selections
NEW §3.6 Spatial / visionOS-inspired surfaces (8 primitives)
• SurfaceFloat (multi-stop shadow + backdrop-blur)
• Parallax (scroll-driven), Spotlight (cursor-follow),
Magnetic buttons, TiltGallery, glass-with-depth modals,
MeshBackground (OKLCH ambient gradients)
NEW §3.7 Performance & sustainability budgets
• LCP ≤ 2.5s p75 · INP ≤ 200ms p75 · CLS ≤ 0.1 p75
• First-page JS ≤ 100 KB gzip · CO₂ ≤ 0.5g/view
• content-visibility, RSC for static surfaces, Suspense islands,
route prefetch, AVIF/WebP negotiation
NEW §3.8 Anti-patterns we will NEVER ship (10 entries)
• Dark patterns, auto-playing media, prefers-reduced-motion
ignored, <div onClick>, hard-coded colours, layout-shifting
skeletons, polling instead of streaming, notification spam,
modal stack > 2, generic 'Something went wrong'.
NEW Wave 13 — Futurism layer (~9 pw, 7 packages):
13.1 @bytelyst/on-device-ai (WebLLM + transformers.js)
13.2 @bytelyst/collab (Yjs CRDT + Automerge adapter)
13.3 ai-ui@0.5 trust surfaces (CostMeter, ConfidenceTag,
RefusalCard, ProvenanceDrawer,
DebugOverlay, PrivacyBadge)
13.4 motion@0.2 spatial (Parallax, Spotlight, Magnetic,
MeshBackground, TiltGallery)
13.5 @bytelyst/generative-theme ("describe your brand" → tokens)
13.6 @bytelyst/customizable-workspace
13.7 @bytelyst/media-ui (ImageGenStream, AudioWaveform,
PdfPreview, VideoPlayer)
NEW §6.1 RSC vs client guidance — per-package table for
React Server Component safety (design-tokens, ui-stateless,
legal-ui, settings-ui rail are RSC-safe; everything else is
client-only or hybrid)
NEW §6.2 Web Components interop — Lit-wrapped <bl-button>,
<bl-card> etc. for non-React consumers (efforise/Vite,
talk2obsidian/Obsidian plugin, local-llms dashboard)
NEW §6.3 Adjacent token packages — email-tokens (MJML),
audio-tokens (notification sounds), motion-tokens
(Lottie/Rive interpolation curves)
NEW §9.1 Demo-first showcase list — 8 customer-magnet prototypes
to lead with: MeshBackground+Spotlight landing, on-device-AI
chat, CostMeter+ConfidenceTag dashboard, CRDT multi-user
notes, ThemeStudio, customizable workspace, ImageGenStream+
AudioWaveform, Shift-click DebugOverlay.
──────────────────────────────────────────────────────────────────
Risks + metrics expanded
──────────────────────────────────────────────────────────────────
- 6 new risk-matrix rows (WebGPU fragmentation, CRDT memory
bloat, generative-theme palette accessibility, media-ui
bundle weight, workspace layout collisions, WebLLM
model-download UX)
- §10 success metrics: added Core Web Vital p75 targets per
product, INP/LCP/CLS gates, privacy-mode + CRDT + on-device
AI + CostMeter adoption KPIs, dark-pattern audit, Web
Components export, create-app scaffolding
──────────────────────────────────────────────────────────────────
Coverage now complete
──────────────────────────────────────────────────────────────────
Per-product matrix expanded from 11 to 20 web apps and gains a
"Wave 13 futurism hook" column. Pilots:
• notes/web + tracker-web → CRDT multi-user editing
• localmemgpt/web + local-llms dashboard → on-device AI
• mindlyst/web → ImageGenStream + CRDT memory canvas
• flowmonk + peakpulse + mac-tooling → customizable workspace
• jarvisjr + trails + sidecar + devops-tools + agent-monitoring
→ CostMeter + ConfidenceTag + ProvenanceDrawer
• clock/web → MeshBackground + Spotlight landing hero
Mirror in copilot/learning_ai_uxui_web follows in a paired commit.
850b9d35a2