Skip to content

chore(docs): New batch of UI refinements to ensnode.io docs #2221

Merged
lightwalker-eth merged 6 commits into
mainfrom
y3drk/chore/ensnode-docs-refinements-pt6
May 29, 2026
Merged

chore(docs): New batch of UI refinements to ensnode.io docs #2221
lightwalker-eth merged 6 commits into
mainfrom
y3drk/chore/ensnode-docs-refinements-pt6

Conversation

@Y3drk
Copy link
Copy Markdown
Member

@Y3drk Y3drk commented May 29, 2026

Lite PR → New batch of refinements to ensnode.io docs

Summary

  • Applied feedback items 1,6,7 from the related Google Doc spec
  • Extracted the ENSAdmin CTA button to a separate component to avoid code duplication
  • Fixed the link hover color bug of the <Aside/> components, where the links would change the color to blue when hovered.

Why


Testing

  • Ran lint command locally to ensure that the migration didn't break anything, and later confirmed that in our CI workflow
  • Verified the UI after introducing changes using a local and Vercel (build) previews

Notes for Reviewer (Optional)

  • Pure UI/UX changes, so I don't think that the changeset log is required

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

@Y3drk Y3drk self-assigned this May 29, 2026
Copilot AI review requested due to automatic review settings May 29, 2026 10:57
@Y3drk Y3drk requested a review from a team as a code owner May 29, 2026 10:57
@Y3drk Y3drk added the docs Docs related label May 29, 2026
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 29, 2026

⚠️ No Changeset found

Latest commit: 346ec85

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 29, 2026

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

Project Deployment Actions Updated (UTC)
enskit-react-example.ensnode.io Ready Ready Preview, Comment May 29, 2026 12:35pm
ensnode.io Ready Ready Preview, Comment May 29, 2026 12:35pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
admin.ensnode.io Skipped Skipped May 29, 2026 12:35pm
ensrainbow.io Skipped Skipped May 29, 2026 12:35pm

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 29, 2026

Review Change Stack

Warning

Review limit reached

@Y3drk, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 47 minutes and 15 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 495d8a3d-fb94-48b7-9458-44d3a64554b8

📥 Commits

Reviewing files that changed from the base of the PR and between 11c16f8 and 346ec85.

📒 Files selected for processing (2)
  • docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro
  • docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro
📝 Walkthrough

Walkthrough

Adds a new ENSAdminCTAButton component, replaces inline ENSAdmin anchors with that component in two documentation components, updates button hover/transition classes, adjusts hosted-instance link underline classes, and refines aside link hover color in the global stylesheet.

Changes

Documentation UI styling refinement

Layer / File(s) Summary
New ENSAdmin CTA component
docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro
Adds ENSAdminCTAButton with ensAdminHref? and text props; renders a styled external anchor containing the ENSAdmin logo and label.
HostedEnsNodeInstance CTA wiring
docs/ensnode.io/src/components/molecules/HostedEnsNodeInstance.astro
Replaces inline “Connect with ENSAdmin” anchor and ENSAdminLogoDark import with ENSAdminCTAButton usage wired to connectWithENSAdminURL.
StaticExampleActionBar CTA and classes
docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro
Replaces inline “Run in ENSAdmin” anchor with ENSAdminCTAButton and updates actionButtonClass to use hover:bg-[var(--sl-color-accent-high)] and transition-colors instead of opacity-based hover/transition.
Playground link and global aside hover
docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExamplePlaygroundHint.astro, docs/ensnode.io/src/styles/starlight.css
Updates hostedInstanceLinkClass to accent-colored underline with underline-offset transitions and focus-visible outline; removes .open-in-ensadmin small-screen font-size override and adds .starlight-aside a:hover color rule to preserve aside link color on hover.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Poem

🐰 I stitched a button, neat and bright,
A logo, text — a click takes flight,
Links that hover, calm and true,
The docs now smile in accent hue,
Hop, click, and read — the rabbit's delight.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description follows the template structure with all required sections completed: Summary (3 bullets covering the key changes), Why (linked Slack request), Testing (lint and UI verification), Notes for Reviewer, and Pre-Review Checklist marked complete.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.
Title check ✅ Passed The title 'chore(docs): New batch of UI refinements to ensnode.io docs' clearly summarizes the main change—applying UI refinements across the documentation component files.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch y3drk/chore/ensnode-docs-refinements-pt6

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 and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR refines styling in the ensnode.io docs site, primarily adjusting link/button hover behaviors and minor layout details in Omnigraph static example components and hosted instance UI.

Changes:

  • Prevent <Aside/> links from changing to blue on hover by explicitly setting the hover color in starlight.css.
  • Update Omnigraph static example hint/action-bar link/button styling (underline offset + hover background behavior).
  • Minor hosted instance UI tweaks (transition type and preventing “Connect with ENSAdmin” from wrapping).

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
docs/ensnode.io/src/styles/starlight.css Keeps aside link hover color consistent with the aside theme color.
docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExamplePlaygroundHint.astro Updates hosted-instance link styling (underline/offset/transition utilities).
docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro Adjusts action button hover behavior to use background color transition.
docs/ensnode.io/src/components/molecules/HostedEnsNodeInstance.astro Changes button transition and adds a no-wrap utility to the ENSAdmin label.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/ensnode.io/src/components/molecules/HostedEnsNodeInstance.astro Outdated
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 29, 2026

Greptile Summary

This PR extracts the repeated ENSAdmin CTA button markup into a shared ENSAdminCTAButton atom component, and fixes two CSS bugs: the aside link hover color bleeding to browser-default blue, and the previously-flagged invalid transition-underline Tailwind class (replaced with the correct transition-[text-underline-offset] arbitrary syntax).

  • ENSAdminCTAButton.astro — new atom that de-duplicates the button across HostedEnsNodeInstance and StaticExampleActionBar; classcat usage is consistent with the rest of the codebase, but the component uses a custom ENSAdminCTAButtonProps interface + as cast instead of the standard Astro interface Props convention used by every sibling component.
  • starlight.css — removes the now-dead .open-in-ensadmin media-query rule and adds an explicit :hover color lock on aside links to prevent accent-color override.
  • StaticExamplePlaygroundHint.astro — link class updated to accent color with corrected underline-offset transition and restored focus-visible outline; addresses the previous review comment.

Confidence Score: 5/5

Pure UI/CSS refactor with no logic changes; safe to merge.

All changes are scoped to docs UI components and styles. The button extraction is clean, the CSS bug fixes are correct, and the previously-flagged Tailwind transition class is properly resolved. The only notable deviation is the non-standard Astro prop interface in the new component, which is a style concern with no runtime impact.

No files require special attention.

Important Files Changed

Filename Overview
docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro New shared atom component for the ENSAdmin CTA button; deviates from the codebase-standard interface Props Astro convention (uses a custom interface name with an explicit cast instead).
docs/ensnode.io/src/components/molecules/HostedEnsNodeInstance.astro Swaps inline ENSAdmin anchor for the new ENSAdminCTAButton component; logic and props are unchanged.
docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro Replaces inline ENSAdmin button with shared component; adds a helpful adminUrl && null guard; updates button hover style from opacity to background-color transition.
docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExamplePlaygroundHint.astro Updates link style to use accent color directly and fixes underline-offset animation with correct transition-[text-underline-offset] Tailwind arbitrary syntax; restores missing focus-visible outline color.
docs/ensnode.io/src/styles/starlight.css Removes now-unused .open-in-ensadmin media-query rule and adds :hover override for <a> tags inside .starlight-aside to prevent the browser's default blue link color from bleeding through on hover.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[ENSAdminCTAButton.astro\nnew shared atom] --> B[HostedEnsNodeInstance.astro\nConnects with ENSAdmin]
    A --> C[StaticExampleActionBar.astro\nRuns in ENSAdmin]
    C -->|adminUrl guard| D{adminUrl?}
    D -- yes --> A
    D -- no --> E[render nothing]
    B --> F[not-content wrapper]
    F --> A
Loading

Reviews (7): Last reviewed commit: "Apply AI agents' suggestions, pt.2" | Re-trigger Greptile

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 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.

Inline comments:
In
`@docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExamplePlaygroundHint.astro`:
- Line 13: The class string in StaticExamplePlaygroundHint.astro contains a
non-standard utility "transition-underline" which likely does nothing; update
the class list in the component (the string containing "text-sm font-semibold
... transition-underline duration-200") to use a valid Tailwind transition
utility such as "transition-[text-underline-offset] duration-200" or
"transition-all duration-200" so the underline-offset changes animate correctly.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: c1c74957-1c2f-4287-9b9e-3ec920c8dfa1

📥 Commits

Reviewing files that changed from the base of the PR and between 3e2bbfd and 37940e4.

📒 Files selected for processing (4)
  • docs/ensnode.io/src/components/molecules/HostedEnsNodeInstance.astro
  • docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro
  • docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExamplePlaygroundHint.astro
  • docs/ensnode.io/src/styles/starlight.css

@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io May 29, 2026 11:07 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io May 29, 2026 11:07 Inactive
@Y3drk
Copy link
Copy Markdown
Member Author

Y3drk commented May 29, 2026

@greptileai

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io May 29, 2026 11:26 Inactive
Copilot AI review requested due to automatic review settings May 29, 2026 12:21
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io May 29, 2026 12:21 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io May 29, 2026 12:21 Inactive
@Y3drk Y3drk changed the title chore(docs): New batch of refinements to ensnode.io docs chore(docs): New batch of UI refinements to ensnode.io docs May 29, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Comment thread docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 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.

Inline comments:
In `@docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro`:
- Around line 16-23: ENSAdminCTAButton currently accepts ensAdminHref?: string
but can render an <a href={undefined}>; either make ensAdminHref required on
ENSAdminCTAButton's props (update callers like StaticExampleActionBar,
resolveOmnigraphStaticExample, and HostedEnsNodeInstance to always pass the
string) or guard inside ENSAdminCTAButton: if ensAdminHref is falsy render a
non-anchor fallback (e.g., a <button> or <span> with the same styling,
aria-disabled and no href) to avoid broken links and improve accessibility;
update ENSAdminCTAButton's prop typing and the render branch referencing
ensAdminHref accordingly.

In
`@docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro`:
- Around line 22-23: actionButtonClass duplicates the styles string used as
styles in ENSAdminCTAButton.astro; extract the shared class into a single
exported constant (e.g. CTA_BUTTON_CLASS) in a small helper module and import
that constant into both StaticExampleActionBar.astro and
ENSAdminCTAButton.astro, replacing the local actionButtonClass and styles
definitions so both components consume the same value and avoid visual drift.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 3a043e37-29d2-484d-a0e4-6d11b41808b4

📥 Commits

Reviewing files that changed from the base of the PR and between 37940e4 and 11c16f8.

📒 Files selected for processing (5)
  • docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro
  • docs/ensnode.io/src/components/molecules/HostedEnsNodeInstance.astro
  • docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExampleActionBar.astro
  • docs/ensnode.io/src/components/molecules/omnigraph-static-example/StaticExamplePlaygroundHint.astro
  • docs/ensnode.io/src/styles/starlight.css
💤 Files with no reviewable changes (1)
  • docs/ensnode.io/src/styles/starlight.css

Comment thread docs/ensnode.io/src/components/atoms/ENSAdminCTAButton.astro
Copy link
Copy Markdown
Member

@lightwalker-eth lightwalker-eth left a comment

Choose a reason for hiding this comment

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

@Y3drk Looks good, thanks 👍

@lightwalker-eth lightwalker-eth merged commit 3219b47 into main May 29, 2026
20 checks passed
@lightwalker-eth lightwalker-eth deleted the y3drk/chore/ensnode-docs-refinements-pt6 branch May 29, 2026 12:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Docs related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants