stack/docs-mintlify/snippets/docs-apps-home-grid.jsx
2026-04-13 15:30:13 -07:00

259 lines
12 KiB
JavaScript

export const DocsAppsHomeGrid = () => {
const labelOverrides = new Map([
["api-keys", "API Keys"],
["rbac", "RBAC"],
]);
const toStartCase = (value) => {
const override = labelOverrides.get(value);
if (override != null) {
return override;
}
return value
.split("-")
.map((part) => part.charAt(0).toUpperCase() + part.slice(1))
.join(" ");
};
const fallbackApps = [
{ name: "Authentication", href: "/guides/apps/authentication/overview", iconSrc: "/images/app-icons/authentication.svg" },
{ name: "Emails", href: "/guides/apps/emails/overview", iconSrc: "/images/app-icons/emails.svg" },
{ name: "Payments", href: "/guides/apps/payments/overview", iconSrc: "/images/app-icons/payments.svg" },
{ name: "Analytics", href: "/guides/apps/analytics/overview", iconSrc: "/images/app-icons/analytics.svg" },
{ name: "Teams", href: "/guides/apps/teams/overview", iconSrc: "/images/app-icons/teams.svg" },
{ name: "Fraud Protection", href: "/guides/apps/fraud-protection/overview", iconSrc: "/images/app-icons/fraud-protection.svg" },
{ name: "RBAC", href: "/guides/apps/rbac/overview", iconSrc: "/images/app-icons/rbac.svg" },
{ name: "API Keys", href: "/guides/apps/api-keys/overview", iconSrc: "/images/app-icons/api-keys.svg" },
{ name: "Data Vault", href: "/guides/apps/data-vault/overview", iconSrc: "/images/app-icons/data-vault.svg" },
{ name: "Webhooks", href: "/guides/apps/webhooks/overview", iconSrc: "/images/app-icons/webhooks.svg" },
{ name: "Launch Checklist", href: "/guides/apps/launch-checklist/overview", iconSrc: "/images/app-icons/launch-checklist.svg" },
];
const getAppsFromSidebar = () => {
if (typeof document === "undefined") {
return fallbackApps;
}
const sidebarRoot = document.querySelector("ul#sidebar-group");
if (sidebarRoot == null) {
return fallbackApps;
}
const candidateLinks = sidebarRoot.querySelectorAll('a[href^="/guides/apps/"]');
const appItems = [];
const seenHrefs = new Set();
for (const link of candidateLinks) {
const href = link.getAttribute("href");
if (href == null || seenHrefs.has(href)) {
continue;
}
const iconImage = link.querySelector("img");
if (iconImage == null) {
continue;
}
const textContent = link.textContent?.replace(/\s+/g, " ").trim();
const slug = href.replace(/^\/guides\/apps\//, "").split("/")[0];
const iconSrc = iconImage.getAttribute("src") ?? `/images/app-icons/${slug}.svg`;
const name = textContent != null && textContent.length > 0 ? textContent : toStartCase(slug);
seenHrefs.add(href);
appItems.push({ name, href, iconSrc });
}
if (appItems.length === 0) {
return fallbackApps;
}
return appItems;
};
const appLinks = getAppsFromSidebar();
const onExploreSearchInput = (event) => {
const input = event.currentTarget;
const root = input.closest("[data-explore-apps-root='true']");
if (root == null) {
return;
}
const query = input.value.trim().toLowerCase();
const cards = root.querySelectorAll("[data-explore-app-card='true']");
let visibleCount = 0;
for (const card of cards) {
const appName = (card.getAttribute("data-app-name") ?? "").toLowerCase();
const isVisible = query.length === 0 || appName.includes(query);
card.style.display = isVisible ? "" : "none";
if (isVisible) {
visibleCount += 1;
}
}
const emptyState = root.querySelector("[data-explore-app-empty='true']");
if (emptyState != null) {
emptyState.style.display = visibleCount === 0 ? "block" : "none";
}
};
if (typeof document !== "undefined" && typeof window !== "undefined") {
window.requestAnimationFrame(() => {
const navigationItems = document.querySelector("#navigation-items");
if (navigationItems == null) {
return;
}
const sidebarHeaders = navigationItems.querySelectorAll(".sidebar-group-header");
const appsHeader = Array.from(sidebarHeaders).find((header) => header.textContent?.trim() === "Apps");
if (appsHeader == null) {
return;
}
const appsGroupContainer = appsHeader.parentElement;
const appsList = appsGroupContainer?.querySelector("ul");
if (appsGroupContainer == null || appsList == null) {
return;
}
const existingHeaderSearch = appsHeader.querySelector("[data-apps-sidebar-search='true']");
if (existingHeaderSearch != null) {
existingHeaderSearch.remove();
}
const legacySearchContainers = appsGroupContainer.querySelectorAll("div[data-apps-sidebar-search='true']");
for (const legacySearchContainer of legacySearchContainers) {
legacySearchContainer.remove();
}
const existingEmptyStates = appsGroupContainer.querySelectorAll("[data-apps-sidebar-empty='true']");
for (const existingEmptyState of existingEmptyStates) {
existingEmptyState.remove();
}
const searchInput = document.createElement("input");
searchInput.type = "text";
searchInput.placeholder = "Filter...";
searchInput.setAttribute("aria-label", "Filter apps in sidebar");
searchInput.style.width = "120px";
searchInput.style.height = "24px";
searchInput.style.borderRadius = "7px";
searchInput.style.padding = "0 8px";
searchInput.style.fontSize = "11px";
searchInput.style.lineHeight = "1";
searchInput.style.outline = "none";
searchInput.style.transition = "border-color 150ms ease, background-color 150ms ease, color 150ms ease";
searchInput.style.fontWeight = "500";
searchInput.style.marginLeft = "auto";
searchInput.style.flexShrink = "0";
const emptyState = document.createElement("div");
emptyState.setAttribute("data-apps-sidebar-empty", "true");
emptyState.style.display = "none";
emptyState.style.padding = "2px 0 8px 16px";
emptyState.style.fontSize = "12px";
emptyState.style.lineHeight = "1.3";
const emptyStatePrefix = document.createElement("span");
emptyStatePrefix.textContent = "No more results. ";
emptyState.appendChild(emptyStatePrefix);
const clearFilterButton = document.createElement("button");
clearFilterButton.type = "button";
clearFilterButton.textContent = "Clear filter";
clearFilterButton.style.border = "none";
clearFilterButton.style.padding = "0";
clearFilterButton.style.background = "transparent";
clearFilterButton.style.fontSize = "12px";
clearFilterButton.style.fontWeight = "600";
clearFilterButton.style.cursor = "pointer";
clearFilterButton.style.textDecoration = "underline";
clearFilterButton.style.textUnderlineOffset = "2px";
emptyState.appendChild(clearFilterButton);
const applyTheme = () => {
const isDark = document.documentElement.classList.contains("dark");
searchInput.style.background = isDark ? "rgba(17,24,39,0.72)" : "rgba(248,250,252,0.98)";
searchInput.style.color = isDark ? "#e5e7eb" : "#111827";
searchInput.style.border = isDark ? "1px solid rgba(75,85,99,0.9)" : "1px solid rgba(203,213,225,0.95)";
emptyState.style.color = isDark ? "rgba(203,213,225,0.86)" : "rgba(55,65,81,0.9)";
clearFilterButton.style.color = isDark ? "#8fb7ff" : "#295fbe";
};
const filterSidebarApps = () => {
const query = searchInput.value.trim().toLowerCase();
const appRows = Array.from(appsList.children);
let visibleCount = 0;
for (const row of appRows) {
const searchableElement = row.querySelector("a, button") ?? row;
const rowText = searchableElement.textContent?.replace(/\s+/g, " ").trim().toLowerCase() ?? "";
const isVisible = query.length === 0 || rowText.includes(query);
row.style.display = isVisible ? "" : "none";
if (isVisible) {
visibleCount += 1;
}
}
emptyState.style.display = query.length > 0 && visibleCount === 0 ? "block" : "none";
};
clearFilterButton.addEventListener("click", () => {
searchInput.value = "";
filterSidebarApps();
searchInput.focus();
});
searchInput.addEventListener("input", filterSidebarApps);
applyTheme();
const classObserver = new MutationObserver(applyTheme);
classObserver.observe(document.documentElement, { attributes: true, attributeFilter: ["class"] });
appsHeader.style.display = "flex";
appsHeader.style.alignItems = "center";
appsHeader.style.gap = "8px";
appsHeader.style.paddingRight = "12px";
searchInput.setAttribute("data-apps-sidebar-search", "true");
appsHeader.appendChild(searchInput);
appsGroupContainer.insertBefore(emptyState, appsList);
});
}
return (
<div data-explore-apps-root="true" className="mt-4 rounded-2xl border border-[#d6e4ff] bg-gradient-to-b from-[#f7faff] to-[#eaf2ff] p-3 shadow-[inset_0_1px_0_rgba(255,255,255,0.9),0_10px_30px_-24px_rgba(47,79,140,0.35)] dark:border-[#1f2d45] dark:from-[#11203a] dark:to-[#070f1f] dark:shadow-[inset_0_1px_0_rgba(112,152,224,0.18),0_16px_34px_-24px_rgba(2,8,20,0.85)] sm:p-4">
<div className="mb-3 sm:mb-4">
<input
type="text"
placeholder="Search apps..."
aria-label="Search Explore Apps"
onInput={onExploreSearchInput}
className="h-10 w-full rounded-xl border border-[#b9cdf4] bg-white/90 px-3 text-sm text-[#1a2d52] outline-none transition-colors duration-150 focus:border-[#7ea6ed] dark:border-[#2b4a79] dark:bg-[#0c1627] dark:text-[#d6e5ff] dark:focus:border-[#4e84d8]"
/>
</div>
<div className="grid grid-cols-3 gap-x-2 gap-y-3 sm:grid-cols-4 sm:gap-x-3 sm:gap-y-4 lg:grid-cols-6">
{appLinks.map((appLink) => (
<a
key={appLink.name}
href={appLink.href}
data-explore-app-card="true"
data-app-name={appLink.name}
className="group flex flex-col items-center gap-2 px-1 py-0.5 no-underline"
title={appLink.name}
>
<div className="relative flex h-[84px] w-[84px] items-center justify-center overflow-hidden rounded-[18px] border border-[#b8cff7] bg-gradient-to-b from-[#f2f7ff] via-[#ebf2ff] to-[#e4edff] shadow-[inset_0_1px_0_rgba(255,255,255,0.95),0_7px_18px_rgba(43,76,140,0.2)] transition-[border-color,box-shadow,transform] duration-150 group-hover:transition-none group-hover:border-[#78a8f0] group-hover:shadow-[inset_0_1px_0_rgba(255,255,255,1),0_0_20px_rgba(82,138,234,0.38),0_10px_22px_rgba(43,76,140,0.24)] dark:border-[#2c4c7d]/70 dark:from-[#183155] dark:via-[#112542] dark:to-[#0a1830] dark:shadow-[inset_0_1px_0_rgba(160,200,255,0.24),0_8px_24px_rgba(2,8,20,0.62)] dark:group-hover:border-[#4f84d7] dark:group-hover:shadow-[inset_0_1px_0_rgba(188,218,255,0.42),0_0_26px_rgba(77,138,239,0.5),0_12px_30px_rgba(2,8,20,0.72)]">
<img
src={appLink.iconSrc}
alt=""
aria-hidden="true"
className="h-[34px] w-[34px] opacity-80 brightness-0 transition-all duration-150 group-hover:transition-none group-hover:opacity-90 dark:invert dark:brightness-125 dark:opacity-95"
/>
</div>
<span
className="min-h-[2.2rem] max-w-[84px] text-center text-xs font-medium leading-4 text-[#2e446f] transition-colors duration-150 group-hover:transition-none group-hover:text-[#182b50] dark:text-[#d8e7ff] dark:group-hover:text-white"
title={appLink.name}
>
{appLink.name}
</span>
</a>
))}
</div>
<p data-explore-app-empty="true" className="mt-3 hidden text-center text-xs text-[#4a5f89] dark:text-[#8fa4cc]">
No apps match your search.
</p>
</div>
);
};