Skip to content

Improve welcome card visuals#680

Merged
arul28 merged 5 commits into
mainfrom
ade/welcome-card-look-nicer-plan-34de39ff
Jul 1, 2026
Merged

Improve welcome card visuals#680
arul28 merged 5 commits into
mainfrom
ade/welcome-card-look-nicer-plan-34de39ff

Conversation

@arul28

@arul28 arul28 commented Jul 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Redesign the one-time welcome card with a poster-first intro video, QR/download/copy panel, and desktop/mobile/terminal surface previews.
  • Add sanitized bundled welcome assets and qrcode.react for the QR code.
  • Update onboarding/settings and architecture docs for the new welcome-card behavior.

Validation

  • npx vitest run src/renderer/components/onboarding/WelcomeVideoGate.test.tsx src/renderer/components/onboarding/WorktreesCard.test.tsx
  • npm --prefix apps/desktop run typecheck
  • npm --prefix apps/desktop run lint
  • npm --prefix apps/desktop run build
  • npm --prefix apps/ade-cli run typecheck
  • npm --prefix apps/ade-cli run test
  • node scripts/validate-docs.mjs
  • Vite preview at http://localhost:5173/work with desktop/mobile screenshot inspection
  • strings apps/desktop/src/renderer/public/welcome/* | rg -i '/Users|localhost|Versic|RME|worktree|github.com/arul28|ADE/.ade|website' returned no matches

ADE   Open in ADE  ·  ade/welcome-card-look-nicer-plan-34de39ff branch  ·  PR #680

Summary by CodeRabbit

  • New Features

    • Redesigned the onboarding welcome experience with a richer video gate, device-specific surface tiles, QR/download actions, and improved mobile install options.
    • Added a smoother open animation and responsive layout adjustments for smaller screens.
  • Bug Fixes

    • Improved video playback and dismiss/replay behavior in onboarding.
    • Added more reliable clipboard and download handling across desktop and browser environments.

Greptile Summary

This PR redesigns the one-time welcome overlay into a richer welcome card. The main changes are:

  • Lazy poster-first intro video playback.
  • Bundled welcome screenshots, poster, and icon assets.
  • Mobile TestFlight QR, download, and copy-link actions.
  • Desktop, mobile, and terminal surface preview links.
  • Updated onboarding tests, dependency metadata, and docs.

Confidence Score: 5/5

No code issues were identified that would block merging.

The changes are focused on the welcome-card UI, bundled assets, tests, dependency metadata, and documentation, with validation covering unit tests, typechecking, linting, builds, CLI tests, docs validation, and visual preview inspection.

T-Rex T-Rex Logs

What T-Rex did

  • Attempted a welcome-card UI capture; the log shows a failure and no successful UI capture was produced.
  • The pre-artifact test state showed base gaps: the iframe was present immediately, route-stable assets/mobile panel/copy contract were absent, and docs assertions failed while generic docs validation passed.
  • Post-artifact results show the welcome interaction tests reached 10/10 passing.
  • Post-artifact results show all docs contract assertions and docs validation passing.

View all artifacts

T-Rex Ran code and verified through T-Rex

Reviews (3): Last reviewed commit: "Address welcome card review nitpicks" | Re-trigger Greptile

@vercel

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
ade Ignored Ignored Preview Jul 1, 2026 6:47am

@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

This PR redesigns the WelcomeVideoGate onboarding dialog: adds a qrcode.react dependency, introduces new state/types and a dismissWelcome/copyMobileLink flow, rebuilds the UI with VideoPanel/PhonePanel/SurfaceTile subcomponents, adds matching CSS animations/styles, and expands test coverage.

Changes

WelcomeVideoGate redesign

Layer / File(s) Summary
Dependency addition
apps/desktop/package.json
Adds qrcode.react dependency used for QR rendering.
Core state, types, dismiss/clipboard logic
apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.tsx
Adds DeviceKind, CopyState, Surface types, publicAssetUrl helper, SURFACES array, expanded local state, dismissWelcome callback, and copyMobileLink with app-bridge/browser clipboard fallback and timeout-based reset.
Dialog layout and subcomponents
apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.tsx
Rebuilds dialog markup with glow/header/close button wired to dismissWelcome, and adds VideoPanel, PhonePanel, SurfaceTile, and device frame subcomponents; tweaks WelcomeActionButton border radius.
Welcome card styling
apps/desktop/src/renderer/index.css
Adds entrance animation, glow overlay, tile/surface hover layout, responsive breakpoints, and reduced-motion overrides.
Updated test coverage
apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.test.tsx
Updates setup and adds tests for dismissal, lazy video iframe, route-stable asset URLs, replay flow, mobile download, clipboard copy paths (bridge, browser, failure), and docs navigation.

Estimated code review effort: 3 (Moderate) | ~30 minutes

Suggested labels: `desktop`, `docs`

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title is concise and accurately reflects the main welcome card redesign in this changeset.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ade/welcome-card-look-nicer-plan-34de39ff

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@arul28

arul28 commented Jul 1, 2026

Copy link
Copy Markdown
Owner Author

@copilot review but do not make fixes

@mintlify

mintlify Bot commented Jul 1, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ade-ac1c6011 🟢 Ready View Preview Jul 1, 2026, 5:49 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread apps/desktop/src/renderer/index.css
@arul28

arul28 commented Jul 1, 2026

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7826143ef5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.tsx Outdated
@arul28 arul28 force-pushed the ade/welcome-card-look-nicer-plan-34de39ff branch from 7826143 to 0e75924 Compare July 1, 2026 06:16
@arul28

arul28 commented Jul 1, 2026

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0e75924a17

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.tsx Outdated
@arul28

arul28 commented Jul 1, 2026

Copy link
Copy Markdown
Owner Author

@codex review

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
apps/desktop/src/renderer/index.css (1)

4021-4030: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Stagger delays hardcoded to 3 tiles.

nth-child(1/2/3) delays assume exactly 3 surface tiles; if SURFACES ever grows, extra tiles snap in without a staggered delay. Fine as-is since the surfaces list is currently fixed at 3 (desktop/mobile/terminal), but worth a comment or a more generic selector if the list becomes dynamic.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/desktop/src/renderer/index.css` around lines 4021 - 4030, The staggered
animation in ade-welcome-card__tile is hardcoded for only three tiles via
nth-child(1/2/3), so any additional SURFACES entries won’t get a delay. Update
the styling to use a more generic stagger approach in index.css, or add a clear
comment near ade-welcome-card__tile explaining that the delays intentionally
match the fixed three-surface list.
apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.test.tsx (1)

96-118: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Direct utility call mixed into a component-behavior test.

Line 112 calls publicAssetUrl directly rather than asserting on rendered output, unlike the surrounding assertions (Lines 109-111, 113-118) that verify the component's actual DOM. This doesn't validate that the component itself uses publicAssetUrl correctly under nested routes — it only re-tests the utility in isolation.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.test.tsx`
around lines 96 - 118, The test for WelcomeVideoGate is mixing a direct utility
assertion into a component behavior check, which bypasses the DOM and re-tests
publicAssetUrl in isolation. Remove the standalone
publicAssetUrl("welcome/video-poster.jpg") assertion and instead verify the
component’s rendered asset src values through the existing WelcomeVideoGate DOM
assertions, so the test only validates behavior via rendered output.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.test.tsx`:
- Around line 96-118: The test for WelcomeVideoGate is mixing a direct utility
assertion into a component behavior check, which bypasses the DOM and re-tests
publicAssetUrl in isolation. Remove the standalone
publicAssetUrl("welcome/video-poster.jpg") assertion and instead verify the
component’s rendered asset src values through the existing WelcomeVideoGate DOM
assertions, so the test only validates behavior via rendered output.

In `@apps/desktop/src/renderer/index.css`:
- Around line 4021-4030: The staggered animation in ade-welcome-card__tile is
hardcoded for only three tiles via nth-child(1/2/3), so any additional SURFACES
entries won’t get a delay. Update the styling to use a more generic stagger
approach in index.css, or add a clear comment near ade-welcome-card__tile
explaining that the delays intentionally match the fixed three-surface list.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d5bf2619-15a2-4ee7-ab03-fd50e0440360

📥 Commits

Reviewing files that changed from the base of the PR and between c834b23 and c227ffa.

⛔ Files ignored due to path filters (4)
  • apps/desktop/package-lock.json is excluded by !**/package-lock.json, !**/package-lock.json
  • apps/desktop/src/renderer/public/welcome/video-poster.jpg is excluded by !**/*.jpg
  • docs/ARCHITECTURE.md is excluded by !docs/**
  • docs/features/onboarding-and-settings/README.md is excluded by !docs/**
📒 Files selected for processing (8)
  • apps/desktop/package.json
  • apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.test.tsx
  • apps/desktop/src/renderer/components/onboarding/WelcomeVideoGate.tsx
  • apps/desktop/src/renderer/index.css
  • apps/desktop/src/renderer/public/welcome/ade-icon.webp
  • apps/desktop/src/renderer/public/welcome/desktop.webp
  • apps/desktop/src/renderer/public/welcome/mobile.webp
  • apps/desktop/src/renderer/public/welcome/tui.webp

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c227ffaf25

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@arul28

arul28 commented Jul 1, 2026

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Can't wait for the next one!

Reviewed commit: 3a102774bc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@arul28 arul28 merged commit e49b5e1 into main Jul 1, 2026
29 checks passed
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