Skip to content

Refine Connect your tools visual mock to match Linear reference#16

Open
NguyenCuong1989 wants to merge 1 commit into
mainfrom
codex/linear-mention-www-3-connect-your-tools-3-84qv77
Open

Refine Connect your tools visual mock to match Linear reference#16
NguyenCuong1989 wants to merge 1 commit into
mainfrom
codex/linear-mention-www-3-connect-your-tools-3-84qv77

Conversation

@NguyenCuong1989
Copy link
Copy Markdown
Collaborator

@NguyenCuong1989 NguyenCuong1989 commented Mar 29, 2026

Motivation

  • Improve the static mock to more closely match the provided WWW-3 reference image for the “Connect your tools” hero visual.
  • Provide a single, consistent demo page and an examples/ entry that designers and contributors can open locally for review.
  • Make the icon lockup responsive and better balanced across viewport sizes.

Description

  • Updated connect-your-tools.html and examples/connect-your-tools.html by tuning the gradient colors, gradient angle, CSS variable names, and overall layout spacing to better match the reference image.
  • Rebuilt the left Linear-style mark using a repeating-linear-gradient stripe treatment and adjusted the right plus icon proportions with clamped sizing for responsive scaling.
  • Renamed and simplified classes to .icons / .circle and added a media query for small screens so the composition stays balanced at narrow widths.
  • Synchronized both demo files so the root connect-your-tools.html and examples/connect-your-tools.html present identical markup and styles.

Testing

  • Verified the external reference with curl -L --max-time 15 -s https://linear.app/integrations | head -n 20 and it completed successfully.
  • Validated HTML parsing for both files with a Python HTMLParser script (python3 - <<'PY' ... HTMLParser().feed(...) ... PY) and parsing succeeded.
  • Ran git diff --check and committed the changes with git commit -m "refine connect-your-tools visual to match reference" without issues.
  • Served the files locally via python3 -m http.server 4173 --bind 0.0.0.0 and confirmed curl -I --max-time 5 http://127.0.0.1:4173/connect-your-tools.html | head returned HTTP/1.0 200 OK, and captured a Playwright screenshot successfully.

Codex Task

Summary by Sourcery

Căn chỉnh đánh dấu (markup) và kiểu dáng (styling) phần minh họa hero “Connect your tools” giữa trang gốc và các trang ví dụ để phù hợp hơn với mẫu tham chiếu của Linear và hoạt động tốt trên nhiều kích thước màn hình.

Tính năng mới:

  • Cung cấp một bản demo “Connect your tools” được đồng bộ dưới examples/ để các nhà thiết kế và cộng tác viên có thể xem xét cục bộ.

Cải tiến:

  • Tinh chỉnh các dải màu nền (gradient), màu biểu tượng (icon) và kiểu chữ để giống hơn với tham chiếu hình ảnh tích hợp của Linear.
  • Đơn giản hóa và thống nhất cấu trúc icon và cách đặt tên class cho phần minh họa hero, sử dụng các primitive dùng chung .icons.circle cho cả hai trang.
  • Cải thiện hành vi responsive của cụm icon với kích thước được kẹp (clamped sizing), bố cục căn giữa và điều chỉnh khoảng cách cho màn hình nhỏ.
Original summary in English

Summary by Sourcery

Align the Connect your tools hero illustration markup and styling across the root and examples pages to better match the Linear reference and behave responsively.

New Features:

  • Provide a synchronized Connect your tools demo under examples/ for designers and contributors to review locally.

Enhancements:

  • Refine background gradients, icon colors, and typography to more closely match the Linear integrations visual reference.
  • Simplify and unify icon structure and class naming for the hero illustration, using shared .icons and .circle primitives for both pages.
  • Improve responsive behavior of the icon lockup with clamped sizing, centered layout, and small-screen spacing adjustments.

@qodo-code-review
Copy link
Copy Markdown

Review Summary by Qodo

Refine Connect your tools visual to match Linear reference

✨ Enhancement

Grey Divider

Walkthroughs

Description
• Refined gradient colors and angles to match Linear reference design
• Rebuilt Linear icon using repeating-linear-gradient stripes for cleaner implementation
• Improved responsive scaling with clamped sizing and media queries
• Synchronized both demo files with identical markup and simplified CSS class names
Diagram
flowchart LR
  A["Gradient Colors<br/>& Angles"] -->|Updated| B["Background Styling"]
  C["Linear Icon<br/>Stripe Treatment"] -->|Rebuilt| D["Icon Rendering"]
  E["Clamped Sizing<br/>& Media Queries"] -->|Enhanced| F["Responsive Layout"]
  G["Class Names<br/>Simplification"] -->|Synchronized| H["Both Demo Files"]
  B --> I["Refined Visual"]
  D --> I
  F --> I
  H --> I
Loading

Grey Divider

File Changes

1. connect-your-tools.html ✨ Enhancement +39/-35

Refine gradient, rebuild Linear icon, improve responsiveness

• Updated CSS variables: --bg-start, --bg-mid, --bg-end colors refined; --icon-bg renamed to
 --icon-fill
• Modified gradient from 125deg to 127deg with adjusted color stops (0%, 54%, 100%)
• Rebuilt Linear icon using repeating-linear-gradient with -46deg angle and 10px/24px stripe
 pattern
• Simplified class names from .logo to .circle and .logos to .icons
• Added responsive gap and transform adjustments via media query for screens ≤680px
• Improved Plus icon sizing with clamped dimensions and centered positioning

connect-your-tools.html


2. examples/connect-your-tools.html ✨ Enhancement +37/-97

Synchronize and simplify icon implementation

• Synchronized CSS variables and gradient styling to match root connect-your-tools.html
• Replaced complex stripe-based Linear icon implementation with simplified
 repeating-linear-gradient pseudo-element
• Removed individual .stripe elements and .mask overlay; consolidated into single ::before
 pseudo-element
• Updated Plus icon from grid-based layout to absolute positioning with clamped sizing
• Unified responsive behavior with clamped gap values instead of fixed pixel adjustments
• Reduced CSS complexity by ~60 lines while maintaining visual consistency

examples/connect-your-tools.html


Grey Divider

Qodo Logo

@qodo-code-review
Copy link
Copy Markdown

qodo-code-review Bot commented Mar 29, 2026

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

ⓘ The new review experience is currently in Beta. Learn more

Grey Divider

Qodo Logo

@sourcery-ai
Copy link
Copy Markdown

sourcery-ai Bot commented Mar 29, 2026

Hướng Dẫn Cho Người Review

Tinh chỉnh phần hero “Connect your tools” để khớp với bản tham chiếu của Linear tốt hơn bằng cách đồng bộ hai file demo HTML, siết chặt gradient/màu sắc/typography, xây dựng lại cụm biểu tượng với hiệu ứng repeating-linear-gradient, và làm cho layout responsive thông qua kích thước dùng clamp và media query cho màn hình nhỏ.

Thay Đổi Ở Cấp Độ File

Thay đổi Chi tiết Files
Thống nhất design tokens và layout cho nền hero và cụm icon trên cả hai file demo.
  • Đổi tên các biến CSS cho nền và màu fill của icon thành một bộ dùng chung (--bg-start, --bg-mid, --bg-end, --icon-fill, --icon-accent) và tinh chỉnh lại giá trị màu.
  • Điều chỉnh góc và các điểm dừng của background gradient để giống với bản tham chiếu Linear hơn.
  • Cập nhật layout để canh giữa nội dung bằng CSS grid và tinh chỉnh stack font-family cho nhất quán.
examples/connect-your-tools.html
connect-your-tools.html
Triển khai lại dấu tròn kiểu Linear bằng cách dùng mặt nạ repeating-linear-gradient dạng sọc để đạt độ trung thực và khả năng responsive tốt hơn.
  • Thay thế nhiều phần tử .stripe được position tuyệt đối và một .mask hình tròn bằng pseudo-element .linear::before dùng repeating-linear-gradient và tinh chỉnh vị trí/kích thước cho khối sọc.
  • Đơn giản hóa markup bằng cách loại bỏ các span stripe và mask không còn cần thiết, và chỉ dùng một phần tử .circle.linear.
  • Đảm bảo dấu kiểu Linear được giữ gọn bên trong nhờ overflow: hidden trên container hình tròn.
examples/connect-your-tools.html
connect-your-tools.html
Thiết kế lại biểu tượng dấu cộng và kích thước container để responsive và cân đối về mặt thị giác trên các viewport khác nhau.
  • Thay các kích thước cố định của thanh dấu cộng bằng giá trị chiều rộng/chiều cao dùng clamp trên .plus::before.plus::after để tỷ lệ có thể co giãn.
  • Chuẩn hóa container icon thành các phần tử .circle với width dùng clampaspect-ratio: 1 thay cho các quy tắc kích thước riêng của .logo.
  • Thêm các transform và điều chỉnh gap (bằng clamp()) để cặp icon luôn cân bằng theo trục dọc.
examples/connect-your-tools.html
connect-your-tools.html
Cải thiện khả năng responsive trên màn hình nhỏ và semantics về accessibility cho cụm icon.
  • Thêm rule @media (max-width: 680px) để loại bỏ translate theo trục dọc và siết khoảng cách flex bằng clamp() giúp bố cục luôn ở giữa trên viewport hẹp.
  • Chuẩn hóa tên class của flex container thành .icons, dùng justify-content: centerplace-items: center để canh giữa nhất quán.
  • Thay đổi cách dùng aria cho icon thành một aria-label mô tả duy nhất trên thẻ <main> và đánh dấu các vòng tròn trang trí là aria-hidden="true" để tránh thông báo lặp lại.
examples/connect-your-tools.html
connect-your-tools.html

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review trên pull request.
  • Continue discussions: Trả lời trực tiếp vào các comment review của Sourcery.
  • Generate a GitHub issue from a review comment: Yêu cầu Sourcery tạo một issue từ comment review bằng cách reply vào comment đó. Bạn cũng có thể reply vào comment review với @sourcery-ai issue để tạo issue từ comment đó.
  • Generate a pull request title: Viết @sourcery-ai ở bất kỳ đâu trong tiêu đề pull request để tạo tiêu đề bất cứ lúc nào. Bạn cũng có thể comment @sourcery-ai title trên pull request để (tái) tạo tiêu đề bất cứ lúc nào.
  • Generate a pull request summary: Viết @sourcery-ai summary ở bất kỳ đâu trong phần mô tả pull request để tạo PR summary tại đúng vị trí bạn muốn. Bạn cũng có thể comment @sourcery-ai summary trên pull request để (tái) tạo summary bất cứ lúc nào.
  • Generate reviewer's guide: Comment @sourcery-ai guide trên pull request để (tái) tạo hướng dẫn cho người review bất cứ lúc nào.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve trên pull request để resolve tất cả comment của Sourcery. Hữu ích khi bạn đã xử lý hết comment và không muốn thấy chúng nữa.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss trên pull request để dismiss tất cả review hiện có của Sourcery. Đặc biệt hữu ích nếu bạn muốn bắt đầu lại với một review mới – đừng quên comment @sourcery-ai review để kích hoạt review mới!

Customizing Your Experience

Truy cập dashboard của bạn để:

  • Bật hoặc tắt các tính năng review như pull request summary do Sourcery tạo, hướng dẫn cho người review, và các tính năng khác.
  • Thay đổi ngôn ngữ review.
  • Thêm, xóa hoặc chỉnh sửa các hướng dẫn review tùy chỉnh.
  • Điều chỉnh các thiết lập review khác.

Getting Help

Original review guide in English

Reviewer's Guide

Refines the “Connect your tools” hero visual to better match Linear’s reference by synchronizing the two demo HTML files, tightening gradient/colors/typography, rebuilding the icon lockup with a repeating-linear-gradient treatment, and making the layout responsive via clamped sizing and a small-screen media query.

File-Level Changes

Change Details Files
Unifies design tokens and layout for the hero background and icon lockup across both demo files.
  • Renamed CSS variables for background and icon fill to a shared set (--bg-start, --bg-mid, --bg-end, --icon-fill, --icon-accent) and tweaked their color values.
  • Adjusted the background gradient angle and stops to more closely match the Linear reference.
  • Updated layout to center content via CSS grid and tuned font-family stack for consistency.
examples/connect-your-tools.html
connect-your-tools.html
Reimplements the circular Linear-style mark using a repeating-linear-gradient stripe mask for better visual fidelity and responsiveness.
  • Replaced multiple absolutely positioned .stripe elements and a circular .mask with a .linear::before pseudo-element using repeating-linear-gradient and tuned position/size for the stripe block.
  • Simplified markup by removing now-unneeded stripe and mask spans and using a single .circle.linear element.
  • Ensured the Linear-like mark stays contained via overflow: hidden on the circular container.
examples/connect-your-tools.html
connect-your-tools.html
Redesigns the plus icon and container sizing to be responsive and visually balanced on different viewports.
  • Replaced fixed plus bar dimensions with clamped width/height values on .plus::before and .plus::after for scalable proportions.
  • Standardized the icon containers as .circle elements with clamped width and aspect-ratio: 1 instead of separate .logo sizing rules.
  • Added transforms and gap adjustments (with clamp()) so the icon pair stays balanced along the vertical axis.
examples/connect-your-tools.html
connect-your-tools.html
Improves small-screen responsiveness and accessibility semantics of the icon lockup.
  • Added a @media (max-width: 680px) rule that removes vertical translate and tightens flex gap using clamp() to keep the composition centered on narrow viewports.
  • Standardized the flex container class name to .icons, using justify-content: center and place-items: center for consistent centering.
  • Changed icon aria usage to a single descriptive aria-label on the <main> and marked decorative circles as aria-hidden="true" to avoid redundant announcements.
examples/connect-your-tools.html
connect-your-tools.html

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

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

Chào bạn - Mình đã để lại một vài góp ý tổng quan:

  • Vẫn còn khá nhiều CSS trùng lặp giữa connect-your-tools.htmlexamples/connect-your-tools.html; hãy cân nhắc trích xuất các style dùng chung (ví dụ: kích thước icon, gradient, tên class) vào một block hoặc file dùng chung để đảm bảo chúng luôn đồng bộ.
  • Trang ví dụ đặt html, body { height: 100%; } trong khi file gốc connect-your-tools.html thì không, điều này có thể gây ra một số khác biệt nhỏ về layout dù mục tiêu là giao diện giống hệt nhau; hãy cân nhắc đồng bộ các primitive layout giữa hai file.
Prompt cho AI Agents
Hãy xử lý các nhận xét trong code review này:

## Nhận xét tổng quan
- Vẫn còn khá nhiều CSS trùng lặp giữa `connect-your-tools.html``examples/connect-your-tools.html`; hãy cân nhắc trích xuất các style dùng chung (ví dụ: kích thước icon, gradient, tên class) vào một block hoặc file dùng chung để đảm bảo chúng luôn đồng bộ.
- Trang ví dụ đặt `html, body { height: 100%; }` trong khi file gốc `connect-your-tools.html` thì không, điều này có thể gây ra một số khác biệt nhỏ về layout dù mục tiêu là giao diện giống hệt nhau; hãy cân nhắc đồng bộ các primitive layout giữa hai file.

Sourcery miễn phí cho mã nguồn mở - nếu bạn thấy hữu ích, hãy cân nhắc chia sẻ nhé ✨
Hãy giúp mình hữu ích hơn! Vui lòng bấm 👍 hoặc 👎 trên từng nhận xét và mình sẽ dùng phản hồi đó để cải thiện các review tiếp theo.
Original comment in English

Hey - I've left some high level feedback:

  • There’s still a fair amount of duplicated CSS between connect-your-tools.html and examples/connect-your-tools.html; consider extracting the shared styles (e.g., icon sizes, gradients, class names) into a single shared block or file to keep them truly in sync.
  • The example page sets html, body { height: 100%; } while the root connect-your-tools.html does not, which could cause subtle layout differences despite aiming for identical visuals; consider aligning the layout primitives between the two files.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- There’s still a fair amount of duplicated CSS between `connect-your-tools.html` and `examples/connect-your-tools.html`; consider extracting the shared styles (e.g., icon sizes, gradients, class names) into a single shared block or file to keep them truly in sync.
- The example page sets `html, body { height: 100%; }` while the root `connect-your-tools.html` does not, which could cause subtle layout differences despite aiming for identical visuals; consider aligning the layout primitives between the two files.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant