Skip to content

Feat/improve website layout#409

Open
vanshika2720 wants to merge 4 commits into
volcano-sh:mainfrom
vanshika2720:feat/improve-website-layout
Open

Feat/improve website layout#409
vanshika2720 wants to merge 4 commits into
volcano-sh:mainfrom
vanshika2720:feat/improve-website-layout

Conversation

@vanshika2720

@vanshika2720 vanshika2720 commented Jun 27, 2026

Copy link
Copy Markdown

What type of PR is this?

/kind enhancement

What this PR does / why we need it

This PR enhances the AgentCube documentation website by improving its layout, accessibility, responsiveness, and overall user experience while redesigning the homepage to align with the Volcano ecosystem's visual language.

Homepage Improvements

  • Replaced placeholder SEO metadata with meaningful page title and meta description.
  • Added a secondary "View on GitHub" CTA alongside the primary "Get Started" button.
  • Improved hero section spacing, typography, and responsive layout.
  • Increased spacing between sections and buttons for better visual hierarchy.
  • Added smooth scrolling for anchor navigation.
  • Added visible keyboard focus indicators (:focus-visible) for improved accessibility.
  • Added a subtle navbar separator and footer top border for better page structure.
  • Fixed footer theme configuration to match the configured light background.
  • Updated the logo with descriptive alt text for improved accessibility.

Volcano Ecosystem Redesign

  • Replaced the default Docusaurus hero styling with a custom branded hero section.

  • Introduced Volcano-inspired design tokens using:

    • Brand Red for primary actions
    • Infrastructure Blue for icons and secondary actions
    • Clean white/light backgrounds
    • Improved dark mode support
  • Added custom branded primary and secondary button variants.

  • Refined navbar and footer styling with subtle borders and shadows for a cleaner appearance.

Feature Section Redesign

  • Replaced default placeholder illustrations with custom Kubernetes-inspired inline SVG icons representing:

    • Low-Latency Agent Scheduling
    • Stateful Agent Lifecycle
    • Efficient Resource Utilization
  • Redesigned feature cards with:

    • Rounded corners
    • Light borders
    • Subtle shadows
    • Equal-height layout
    • Smooth hover elevation
    • Improved spacing and typography

Accessibility Improvements

  • Added meaningful aria-labels for feature icons.
  • Improved keyboard navigation with visible focus styles.
  • Updated branding assets with descriptive alt text.
  • Verified responsive behavior across desktop, tablet, and mobile devices.

Code Cleanup

  • Removed obsolete placeholder styling and unused global CSS.
  • Consolidated homepage styling into reusable branded CSS.
  • Formatted all modified files using Prettier.

Which issue(s) this PR fixes

Fixes #408 

Special notes for your reviewer

  • This PR contains UI/UX improvements only and does not introduce functional changes.
  • The homepage has been redesigned to better match the Volcano ecosystem branding while preserving the existing documentation structure.
  • Placeholder illustrations have been replaced with custom inline SVG icons designed specifically for AgentCube.
  • Verified in both light and dark themes.
  • Responsive layout has been checked across desktop, tablet, and mobile viewports.

Does this PR introduce a user-facing change?

Redesigned the AgentCube documentation homepage with Volcano-inspired branding, improved accessibility, responsive layout, custom feature icons, enhanced hero section, refined navigation and footer styling, and overall UI/UX improvements.
Screenshot 2026-06-28 at 1 34 16 AM Screenshot 2026-06-28 at 1 29 13 AM Screenshot 2026-06-28 at 1 34 35 AM Screenshot 2026-06-28 at 1 34 47 AM

…sistency

- Fix page <title> and meta description (removed placeholder text)
- Add secondary "View on GitHub" CTA button with gap and flex-wrap
- Increase hero padding (5rem desktop, 3rem mobile) for better rhythm
- Add margin-top to buttons group so it breathes below the tagline
- Remove stray `.container_lyt7` leaked CSS module class from custom.css
- Add `scroll-behavior: smooth` to html element
- Add :focus-visible outline for keyboard accessibility
- Add --ifm-navbar-shadow CSS variable for light/dark mode
- Add footer border-top to visually separate it from page content
- Fix footer style from 'dark' to 'light' to match #f8fafc background
- Fix navbar logo alt text from 'My Site Logo' to 'AgentCube Logo'
- Reduce feature SVG size from 200px to 160px for better text balance
- Increase features section padding from 2rem to 4rem
- Add .featureCard wrapper with hover shadow and lift transition
- Add aria-label to feature SVGs for screen reader accessibility
- Add padding-top--md to feature card text area for internal spacing
- Run prettier on all modified files for consistent formatting

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
- Replace default Docusaurus hero--primary with a custom branded hero
  component implemented via CSS modules
- Define CSS variables for Volcano brand red and blue palette, hero
  background, card backgrounds, borders, shadows, and navbar/footer
  colors, covering both light and dark modes
- Audit existing theme overrides; preserve all variables still in use
  to keep dark mode intact
- Restyle navbar with a thin bottom border, clean spacing, and
  hover accent color using the brand palette
- Restyle footer with a top border, improved typography hierarchy,
  letter-spaced section titles, and hover link accent color
- Add custom button classes (brand-primary, brand-secondary) with
  rounded corners, transition, and hover shadow lift
- Replace undraw template illustration SVGs with original, minimal
  inline vector icons inspired by Kubernetes / cloud infrastructure:
    - Low-Latency Scheduling: clock/speed icon
    - Stateful Lifecycle: isometric cube / layers icon
    - Efficient Resource Utilization: cluster / nodes icon
- Redesign feature cards with rounded corners, light border, subtle
  box-shadow, equal flex heights, and 220ms cubic-bezier hover lift
- Icon container sized at 96px, colored with brand blue accent
- Fix hero title color variable in dark mode so the AgentCube heading
  is fully readable against the dark background
- Run prettier on all modified files

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
Copilot AI review requested due to automatic review settings June 27, 2026 20:11
@volcano-sh-bot volcano-sh-bot added the kind/enhancement New feature or request label Jun 27, 2026
@volcano-sh-bot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kevin-wangzefeng for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request refactors the AgentCube Docusaurus documentation site by formatting configuration files, replacing generic SVGs with custom inline SVG icons, updating the homepage layout, and introducing comprehensive CSS refinements for light and dark modes. The review feedback highlights several key improvement opportunities: updating the placeholder production URL, correcting mismatched primary color variables in the dark theme, removing a global border-radius override on :focus-visible, leveraging Infima's built-in CSS variables instead of using !important overrides, and resolving a redundant browser tab title on the homepage.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/agentcube/docusaurus.config.ts Outdated
Comment thread docs/agentcube/src/css/custom.css Outdated
Comment thread docs/agentcube/src/css/custom.css
Comment thread docs/agentcube/src/css/custom.css
Comment thread docs/agentcube/src/pages/index.tsx

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 updates the AgentCube Docusaurus documentation site homepage and global theme styling to better match Volcano branding, improve responsiveness, and refine navigation/footer presentation.

Changes:

  • Redesigned the homepage hero section (layout, CTA buttons, SEO title/description).
  • Replaced placeholder feature illustrations with custom inline SVG feature icons and updated feature-card styling.
  • Introduced new global design tokens and navbar/footer/button styling in the site’s custom CSS (including dark-mode adjustments).

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
docs/agentcube/src/pages/index.tsx Updates homepage hero markup/CTAs and replaces placeholder SEO metadata.
docs/agentcube/src/pages/index.module.css Replaces default hero styling with branded hero section styles.
docs/agentcube/src/css/custom.css Adds design tokens and global styling for navbar/footer/buttons, plus dark-mode refinements.
docs/agentcube/src/components/HomepageFeatures/styles.module.css Introduces redesigned feature section/card layout and styling.
docs/agentcube/src/components/HomepageFeatures/index.tsx Switches from imported SVGs to inline SVG icons and updates feature rendering.
docs/agentcube/docusaurus.config.ts Updates site config formatting and adjusts branding/footer theme settings.

Comment thread docs/agentcube/src/components/HomepageFeatures/styles.module.css
Comment thread docs/agentcube/src/components/HomepageFeatures/styles.module.css
Comment thread docs/agentcube/src/css/custom.css
Comment thread docs/agentcube/src/css/custom.css Outdated
Comment on lines 123 to 126
{
label: 'Discussions',
href: 'https://github.com/volcano-sh/agentcube',
label: "Discussions",
href: "https://github.com/volcano-sh/agentcube",
},
Comment thread docs/agentcube/docusaurus.config.ts
Comment thread docs/agentcube/src/components/HomepageFeatures/index.tsx
Comment thread docs/agentcube/src/components/HomepageFeatures/index.tsx
Comment thread docs/agentcube/src/components/HomepageFeatures/index.tsx
Comment thread docs/agentcube/src/pages/index.tsx
@codecov-commenter

codecov-commenter commented Jun 27, 2026

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 58.57%. Comparing base (524e55e) to head (34c450a).
⚠️ Report is 146 commits behind head on main.
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@             Coverage Diff             @@
##             main     #409       +/-   ##
===========================================
+ Coverage   47.57%   58.57%   +11.00%     
===========================================
  Files          30       37        +7     
  Lines        2819     3491      +672     
===========================================
+ Hits         1341     2045      +704     
+ Misses       1338     1237      -101     
- Partials      140      209       +69     
Flag Coverage Δ
unittests 58.57% <ø> (+11.00%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
- Replace aria-hidden="true" with role="img" + aria-label on all three
  feature section SVG icons so screen readers can announce their purpose
- Fix placeholder production URL to https://agentcube.volcano.sh for
  correct canonical links and sitemap generation

Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
Copilot AI review requested due to automatic review settings June 27, 2026 20:44

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 6 out of 6 changed files in this pull request and generated 1 comment.

Comment thread docs/agentcube/src/pages/index.tsx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/enhancement New feature or request size/XL

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants