Skip to content

docs(connectors): refresh connectors UI to match website design language - #857

Open
ravibits wants to merge 1 commit into
mainfrom
claude/dev-docs-connectors-redesign-xvnca9
Open

docs(connectors): refresh connectors UI to match website design language#857
ravibits wants to merge 1 commit into
mainfrom
claude/dev-docs-connectors-redesign-xvnca9

Conversation

@ravibits

@ravibits ravibits commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Refreshes the agent-connectors experience in the developer docs so it reads as one clean, cohesive system, adapting the visual language of scalekit.com/connectors. This is a presentation-only change — no content, search, or filtering behavior is altered.

All 316 connector pages are generated, so the entire redesign lives in three shared components:

File What changed
src/components/ProviderCatalog.astro (the /agentkit/connectors/ index) Added a connector/category summary line and a live result count; calmer sentence-case category headings with count badges; softer, uniform cards with a larger icon tile and accent focus rings; initial-letter fallback when a provider logo fails to load (previously the tile went blank).
src/components/overrides/PageTitle.astro (connector hero) Added an "← All connectors" back-link eyebrow, a larger padded icon tile, and refined metadata chips (accent-tinted auth type, neutral category chips).
src/components/ToolList.astro (tool reference) Aligned the filter input, tool cards, and param table with the refreshed card system (search icon, accent focus ring, subtle open state).

Design principles borrowed from the website

  • Soft, padded icon tiles and uniform cards with a subtle hover lift
  • Generous whitespace and clearer vertical rhythm
  • Category-first browsing with quiet, secondary metadata
  • A more deliberate hero on connector pages

Colors were not hard-matched — the docs already use the same indigo accent as the site. All styling flows through existing Starlight/Nova design tokens with safe fallbacks, so light and dark themes both hold up.

What is intentionally unchanged

  • Connector/tool search and category filtering (same JS, same behavior)
  • Tool deep-links and the right-sidebar TOC injection
  • All page content and the generated connector pages themselves

Preview

Once the deploy preview builds:

  • Index: https://deploy-preview-{PR_NUMBER}--scalekit-starlight.netlify.app/agentkit/connectors/
  • Connector page: https://deploy-preview-{PR_NUMBER}--scalekit-starlight.netlify.app/agentkit/connectors/airtablemcp/

Verification

  • Passes the repo's Prettier check (prettier --check) for all three files.
  • Design validated visually in light and dark in a standalone harness. A full local astro build was not run in the authoring environment; the Netlify deploy preview is the definitive render.

🤖 Generated with Claude Code

https://claude.ai/code/session_01P8wBwMQLegNVpGDpz9YD9D


Generated by Claude Code

Summary by CodeRabbit

  • New Features

    • Added catalog summary counts for connectors and categories.
    • Added live per-category result counts and filtered-result messaging.
    • Added connector logo fallbacks using the connector’s initial when images fail to load.
    • Added a visual search icon to the tool filter.
  • Style

    • Refreshed connector pages, search controls, tool cards, metadata badges, spacing, and logo presentation.
    • Improved visual states for focused filters, expanded tool cards, and empty results.

Refine the three shared components behind the agent-connectors experience
so the catalog, connector hero, and tool reference read as one clean system,
inspired by scalekit.com/connectors. No content or functionality changes —
search, category filtering, and tool deep-links are preserved.

- ProviderCatalog: add connector/category summary line and a live result
  count, calmer sentence-case category headings with count badges, softer
  uniform cards with a larger icon tile, accent focus rings, and an
  initial-letter fallback when a provider logo fails to load.
- PageTitle (connector hero): add an 'All connectors' back-link eyebrow,
  a larger padded icon tile, and refined metadata chips (accent-tinted
  auth, neutral categories).
- ToolList: align filter input, tool cards, and param table with the
  refreshed card system (search icon, accent focus, subtle open state).
@coderabbitai

coderabbitai Bot commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: b7deb69d-d17c-4ca1-b47c-c7d6f4f2d44d

📥 Commits

Reviewing files that changed from the base of the PR and between e8b17b1 and b469660.

📒 Files selected for processing (3)
  • src/components/ProviderCatalog.astro
  • src/components/ToolList.astro
  • src/components/overrides/PageTitle.astro
📜 Recent review details
⏰ Context from checks skipped due to timeout. (4)
  • GitHub Check: CodeRabbit
  • GitHub Check: Redirect rules - scalekit-starlight
  • GitHub Check: Header rules - scalekit-starlight
  • GitHub Check: Pages changed - scalekit-starlight
🧰 Additional context used
📓 Path-based instructions (4)
**/*.{md,mdx,astro,ts}

📄 CodeRabbit inference engine (CONTRIBUTING.md)

**/*.{md,mdx,astro,ts}: Use pnpm pretty-quick --staged via pre-commit git hook to auto-format all staged .md, .mdx, .astro, .ts files with Prettier
Run pnpm format to auto-format all .md, .mdx, .astro, .ts files before pushing changes

Files:

  • src/components/overrides/PageTitle.astro
  • src/components/ToolList.astro
  • src/components/ProviderCatalog.astro
src/components/overrides/**/*.astro

📄 CodeRabbit inference engine (CONTRIBUTING.md)

Custom Starlight component overrides must be placed in src/components/overrides/ and registered in astro.config.mjs under starlight.components

Files:

  • src/components/overrides/PageTitle.astro
src/components/**/*.astro

📄 CodeRabbit inference engine (CONTRIBUTING.md)

Reusable MDX components for documentation must be placed in src/components/ with subdirectories for auth, ui, examples, and templates

Files:

  • src/components/overrides/PageTitle.astro
  • src/components/ToolList.astro
  • src/components/ProviderCatalog.astro
**

⚙️ CodeRabbit configuration file

**: # CLAUDE.md - Scalekit Documentation Guide

Overview

This file is the single source of truth for all documentation standards and AI assistant guidelines in this repository. All documentation must adhere to the rules defined below.


Core Principles

Documentation-first development

Every feature must include comprehensive, user-focused documentation. Documentation is not an afterthought but a first-class deliverable that guides implementation. All code changes require corresponding documentation updates.

Git workflow

  • Do NOT include Co-Authored-By lines in commit messages
  • At the start of a fresh session, before making any changes, ask the user: "Do you want me to cut a new branch or work on the current branch?"
  • Never force push (git push --force or git push -f). If a push fails, stop and clearly explain the reason it failed — do not attempt workarounds without user confirmation.
  • For commit, push, and PR creation, spawn a subagent using the Haiku model to handle it. The pre-push hook generates large logs and PR creation output adds unnecessary noise to the main session context.
  • Once the user confirms local testing works, or explicitly asks to commit and push, commit all changes, push the branch, and open a PR against main. The PR must include:
    • A crisp description of the changes
    • A preview link in the format: https://deploy-preview-{PR_NUMBER}--scalekit-starlight.netlify.app/{path-to-changed-page}/

SDK variable names (critical)

CRITICAL: Use the exact variable names below in all documentation and code examples.

  • Node.js: scalekit
  • Python: scalekit_client
  • Go: scalekitClient
  • Java: scalekitClient

Multi-Language SDK Consistency

All code examples MUST include Node.js, Python, Go, and Java implementations with consistent variable naming conventions. Examples must show both success and error handling paths. Security implications must be explained for each implementation....

Files:

  • src/components/overrides/PageTitle.astro
  • src/components/ToolList.astro
  • src/components/ProviderCatalog.astro
🧠 Learnings (1)
📚 Learning: 2026-02-25T12:04:06.383Z
Learnt from: saif-at-scalekit
Repo: scalekit-inc/developer-docs PR: 445
File: src/pages/apis.astro:63-64
Timestamp: 2026-02-25T12:04:06.383Z
Learning: In the developer-docs repository, all Astro pages are intended to render in light mode. Enforce this by setting localStorage.colorMode = 'light' globally to ensure a consistent light theme across the site, including Scalar API reference pages. This should be treated as a deliberate, project-wide style decision rather than a per-page override; verify no page uses a conflicting color mode and document any exception in developer docs.

Applied to files:

  • src/components/overrides/PageTitle.astro
  • src/components/ToolList.astro
  • src/components/ProviderCatalog.astro
🔇 Additional comments (3)
src/components/ProviderCatalog.astro (1)

52-56: LGTM!

Also applies to: 82-86, 108-118, 130-131, 161-161, 205-231, 346-352, 387-394, 403-435, 444-604, 613-623, 640-646, 685-695

src/components/ToolList.astro (1)

13-13: LGTM!

Also applies to: 86-118, 131-141, 221-221, 258-258

src/components/overrides/PageTitle.astro (1)

19-28: LGTM!

Also applies to: 97-163, 191-219


Walkthrough

Changes

The connector catalog now displays live connector and category counts, filtered result counts, tool-aware empty states, and fallback initials for failed logos. Tool filters, cards, connector cards, and connector page headers receive updated markup and styling.

Connector catalog experience

Layer / File(s) Summary
Catalog counts, filtering, and logo fallback
src/components/ProviderCatalog.astro
Adds catalog totals, live category and result counts, centralized no-results handling, and initial-letter logo fallbacks.
Catalog and tool filter styling
src/components/ProviderCatalog.astro, src/components/ToolList.astro
Updates catalog controls, provider cards, tool filters, tool cards, result cards, and parameter backgrounds.
Connector page header and metadata
src/components/overrides/PageTitle.astro
Adds the all-connectors back-link and revises connector logo, title layout, spacing, and metadata chip styling.

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

Sequence Diagram(s)

sequenceDiagram
  actor Visitor
  participant ProviderCatalog
  participant CatalogDOM
  Visitor->>ProviderCatalog: Enter search or apply filter
  ProviderCatalog->>CatalogDOM: Update category counts and result-count
  ProviderCatalog->>CatalogDOM: Update no-results visibility
Loading

Suggested reviewers: AkshayParihar33, amitash1912, saif-at-scalekit

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the UI refresh and alignment with the website design language.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/dev-docs-connectors-redesign-xvnca9
  • 🛠️ fix frontmatter
  • 🛠️ fix internal links

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.

@netlify

netlify Bot commented Jul 11, 2026

Copy link
Copy Markdown

Deploy Preview for scalekit-starlight ready!

Name Link
🔨 Latest commit b469660
🔍 Latest deploy log https://app.netlify.com/projects/scalekit-starlight/deploys/6a51f9ce2bb7020007a471cb
😎 Deploy Preview https://deploy-preview-857--scalekit-starlight.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 42 (🔴 down 6 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 92 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@saif-at-scalekit saif-at-scalekit left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This is great, thanks for working on this.

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.

3 participants