Skip to content

UI Library for Design Engineers. Animated components and effects you can copy and paste into your apps. Free. Open Source.

feat: added docs copy page options (#766)

Arghya Das5780b0abe427
diff --git a/app/(docs)/docs/[[...slug]]/page.tsx b/app/(docs)/docs/[[...slug]]/page.tsx
index aa092da4..2f1de631 100644
--- a/app/(docs)/docs/[[...slug]]/page.tsx
+++ b/app/(docs)/docs/[[...slug]]/page.tsx
@@ -1,8 +1,9 @@
import { Mdx } from "@/components/mdx-components";
-import { DocPager } from "@/components/pager";
+import { DocPager, getPagerForDoc } from "@/components/pager";
import { badgeVariants } from "@/components/ui/badge";
import { getTableOfContents } from "@/lib/toc";
import { absoluteUrl, cn } from "@/lib/utils";
+import { DocsCopyPage } from "@/components/docs-copy-page";
import { ChevronRightIcon, ExternalLinkIcon } from "@radix-ui/react-icons";
import { allDocs } from "content-collections";
@@ -13,6 +14,8 @@ import { notFound } from "next/navigation";
import { Contribute } from "@/components/contribute";
import { SidebarCTA } from "@/components/sidebar-cta";
import { TableOfContents } from "@/components/toc";
+import { IconArrowLeft, IconArrowRight } from "@tabler/icons-react";
+import { Button } from "@/components/ui/button";
interface DocPageProps {
params: {
@@ -82,6 +85,7 @@ export default async function DocPage({ params }: DocPageProps) {
}
const toc = await getTableOfContents(doc.body.raw);
+ const pager = getPagerForDoc(doc);
return (
<main className="relative lg:gap-10 xl:grid xl:grid-cols-[1fr_300px]">
@@ -91,10 +95,42 @@ export default async function DocPage({ params }: DocPageProps) {
<ChevronRightIcon className="size-4" />
<div className="font-medium text-foreground">{doc.title}</div>
</div>
- <div className="space-y-2">
+ <div className="flex flex-col gap-2">
<h1 className={cn("scroll-m-20 text-4xl font-bold tracking-tight")}>
{doc.title}
</h1>
+ <div className="docs-nav bg-background/80 border-border/50 fixed inset-x-0 bottom-0 isolate z-50 flex items-center gap-2 border-t px-6 py-4 backdrop-blur-sm sm:static sm:border-t-0 sm:bg-transparent sm:px-0 sm:pt-1.5 sm:backdrop-blur-none">
+ <DocsCopyPage
+ page={(doc.body as any).rawWithFrontmatter ?? doc.body.raw}
+ url={absoluteUrl(doc.slug)}
+ />
+ {pager?.prev?.href && (
+ <Button
+ variant="secondary"
+ size="icon"
+ className="extend-touch-target ml-auto size-8 shadow-none md:size-7"
+ asChild
+ >
+ <Link href={pager.prev.href}>
+ <span className="sr-only">Previous</span>
+ <IconArrowLeft />
+ </Link>
+ </Button>
+ )}
+ {pager?.next?.href && (
+ <Button
+ variant="secondary"
+ size="icon"
+ className="extend-touch-target size-8 shadow-none md:size-7"
+ asChild
+ >
+ <Link href={pager.next.href}>
+ <span className="sr-only">Next</span>
+ <IconArrowRight />
+ </Link>
+ </Button>
+ )}
+ </div>
{doc.description && (
<p className="text-balance text-lg text-muted-foreground">
{doc.description}
diff --git a/app/llm/[[...slug]]/route.ts b/app/llm/[[...slug]]/route.ts
new file mode 100644
index 00000000..1d594190
--- /dev/null
+++ b/app/llm/[[...slug]]/route.ts
@@ -0,0 +1,32 @@
+import { notFound } from "next/navigation";
+import { NextResponse, type NextRequest } from "next/server";
+import { allDocs } from "content-collections";
+
+export const revalidate = false;
+
+export async function GET(
+ _req: NextRequest,
+ { params }: { params: Promise<{ slug?: string[] }> },
+) {
+ const { slug: slugSegments } = await params;
+ const slug = slugSegments?.join("/") || "index";
+ const doc = allDocs.find((d) => d.slugAsParams === slug);
+
+ if (!doc) {
+ notFound();
+ }
+
+ const mdx = (doc.body as any).rawWithFrontmatter ?? doc.body.raw;
+ return new NextResponse(mdx, {
+ headers: {
+ "Content-Type": "text/markdown; charset=utf-8",
+ "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300",
+ },
+ });
+}
+
+export function generateStaticParams() {
+ return allDocs.map((doc) => ({
+ slug: doc.slugAsParams === "index" ? [] : doc.slugAsParams.split("/"),
+ }));
+}
diff --git a/components/docs-copy-page.tsx b/components/docs-copy-page.tsx
new file mode 100644
index 00000000..67b42493
--- /dev/null
+++ b/components/docs-copy-page.tsx
@@ -0,0 +1,159 @@
+"use client";
+import { IconCheck, IconChevronDown, IconCopy } from "@tabler/icons-react";
+import { useCopyToClipboard } from "@/hooks/use-copy-to-clipboard";
+import { Button } from "@/components/ui/button";
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import {
+ Popover,
+ PopoverAnchor,
+ PopoverContent,
+ PopoverTrigger,
+} from "@/components/ui/popover";
+import { Separator } from "@/components/ui/separator";
+function getPromptUrl(baseURL: string, url: string) {
+ return `${baseURL}?q=${encodeURIComponent(
+ `I’m looking at this shadcn/ui documentation: ${url}.
+Help me understand how to use it. Be ready to explain concepts, give examples, or help debug based on it.
+ `,
+ )}`;
+}
+export function DocsCopyPage({ page, url }: { page: string; url: string }) {
+ const { copyToClipboard, isCopied } = useCopyToClipboard();
+ const trigger = (
+ <Button
+ variant="secondary"
+ size="sm"
+ className="peer -ml-0.5 size-8 shadow-none md:size-7 md:text-[0.8rem]"
+ >
+ <IconChevronDown className="rotate-180 sm:rotate-0" />
+ </Button>
+ );
+
+ let pathname = "/docs";
+ try {
+ pathname = new URL(url).pathname;
+ } catch (e) {
+ console.error(e);
+ }
+ const menuItems: Record<string, (url: string) => React.ReactNode> = {
+ viewMarkdown: (_url: string) => {
+ const mdUrl = `${pathname}.md`;
+ return (
+ <a href={mdUrl} target="_blank" rel="noopener noreferrer">
+ <svg strokeLinejoin="round" viewBox="0 0 22 16">
+ <path
+ fillRule="evenodd"
+ clipRule="evenodd"
+ d="M19.5 2.25H2.5C1.80964 2.25 1.25 2.80964 1.25 3.5V12.5C1.25 13.1904 1.80964 13.75 2.5 13.75H19.5C20.1904 13.75 20.75 13.1904 20.75 12.5V3.5C20.75 2.80964 20.1904 2.25 19.5 2.25ZM2.5 1C1.11929 1 0 2.11929 0 3.5V12.5C0 13.8807 1.11929 15 2.5 15H19.5C20.8807 15 22 13.8807 22 12.5V3.5C22 2.11929 20.8807 1 19.5 1H2.5ZM3 4.5H4H4.25H4.6899L4.98715 4.82428L7 7.02011L9.01285 4.82428L9.3101 4.5H9.75H10H11V5.5V11.5H9V7.79807L7.73715 9.17572L7 9.97989L6.26285 9.17572L5 7.79807V11.5H3V5.5V4.5ZM15 8V4.5H17V8H19.5L17 10.5L16 11.5L15 10.5L12.5 8H15Z"
+ fill="currentColor"
+ />
+ </svg>
+ View as Markdown
+ </a>
+ );
+ },
+ v0: (url: string) => (
+ <a
+ href={getPromptUrl("https://v0.dev", url)}
+ target="_blank"
+ rel="noopener noreferrer"
+ >
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ viewBox="0 0 147 70"
+ className="size-4.5 -translate-x-px"
+ >
+ <path d="M56 50.203V14h14v46.156C70 65.593 65.593 70 60.156 70c-2.596 0-5.158-1-7-2.843L0 14h19.797L56 50.203ZM147 56h-14V23.953L100.953 56H133v14H96.687C85.814 70 77 61.186 77 50.312V14h14v32.156L123.156 14H91V0h36.312C138.186 0 147 8.814 147 19.688V56Z" />
+ </svg>
+ <span className="-translate-x-[2px]">Open in v0</span>
+ </a>
+ ),
+ chatgpt: (url: string) => (
+ <a
+ href={getPromptUrl("https://chatgpt.com", url)}
+ target="_blank"
+ rel="noopener noreferrer"
+ >
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+ <path
+ d="M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.076.076 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66z"
+ fill="currentColor"
+ />
+ </svg>
+ Open in ChatGPT
+ </a>
+ ),
+ claude: (url: string) => (
+ <a
+ href={getPromptUrl("https://claude.ai/new", url)}
+ target="_blank"
+ rel="noopener noreferrer"
+ >
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+ <path
+ d="m4.714 15.956 4.718-2.648.079-.23-.08-.128h-.23l-.79-.048-2.695-.073-2.337-.097-2.265-.122-.57-.121-.535-.704.055-.353.48-.321.685.06 1.518.104 2.277.157 1.651.098 2.447.255h.389l.054-.158-.133-.097-.103-.098-2.356-1.596-2.55-1.688-1.336-.972-.722-.491L2 6.223l-.158-1.008.655-.722.88.06.225.061.893.686 1.906 1.476 2.49 1.833.364.304.146-.104.018-.072-.164-.274-1.354-2.446-1.445-2.49-.644-1.032-.17-.619a2.972 2.972 0 0 1-.103-.729L6.287.133 6.7 0l.995.134.42.364.619 1.415L9.735 4.14l1.555 3.03.455.898.243.832.09.255h.159V9.01l.127-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.583.28.48.685-.067.444-.286 1.851-.558 2.903-.365 1.942h.213l.243-.242.983-1.306 1.652-2.064.728-.82.85-.904.547-.431h1.032l.759 1.129-.34 1.166-1.063 1.347-.88 1.142-1.263 1.7-.79 1.36.074.11.188-.02 2.853-.606 1.542-.28 1.84-.315.832.388.09.395-.327.807-1.967.486-2.307.462-3.436.813-.043.03.049.061 1.548.146.662.036h1.62l3.018.225.79.522.473.638-.08.485-1.213.62-1.64-.389-3.825-.91-1.31-.329h-.183v.11l1.093 1.068 2.003 1.81 2.508 2.33.127.578-.321.455-.34-.049-2.204-1.657-.85-.747-1.925-1.62h-.127v.17l.443.649 2.343 3.521.122 1.08-.17.353-.607.213-.668-.122-1.372-1.924-1.415-2.168-1.141-1.943-.14.08-.674 7.254-.316.37-.728.28-.607-.461-.322-.747.322-1.476.388-1.924.316-1.53.285-1.9.17-.632-.012-.042-.14.018-1.432 1.967-2.18 2.945-1.724 1.845-.413.164-.716-.37.066-.662.401-.589 2.386-3.036 1.439-1.882.929-1.086-.006-.158h-.055L4.138 18.56l-1.13.146-.485-.456.06-.746.231-.243 1.907-1.312Z"
+ fill="currentColor"
+ />
+ </svg>
+ Open in Claude
+ </a>
+ ),
+ };
+ return (
+ <Popover>
+ <div className="bg-secondary group/buttons relative flex rounded-lg *:[[data-slot=button]]:focus-visible:relative *:[[data-slot=button]]:focus-visible:z-10">
+ <PopoverAnchor />
+ <Button
+ variant="secondary"
+ size="sm"
+ className="h-8 shadow-none md:h-7 md:text-[0.8rem]"
+ onClick={() => copyToClipboard(page)}
+ >
+ {isCopied ? <IconCheck /> : <IconCopy />}
+ Copy Page
+ </Button>
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild className="hidden sm:flex">
+ {trigger}
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end" className="shadow-none">
+ {Object.entries(menuItems).map(([key, value]) => (
+ <DropdownMenuItem key={key} asChild>
+ {value(url)}
+ </DropdownMenuItem>
+ ))}
+ </DropdownMenuContent>
+ </DropdownMenu>
+ <Separator
+ orientation="vertical"
+ className="!bg-foreground/10 absolute top-0 right-8 z-0 !h-8 peer-focus-visible:opacity-0 sm:right-7 sm:!h-7"
+ />
+ <PopoverTrigger asChild className="flex sm:hidden">
+ {trigger}
+ </PopoverTrigger>
+ <PopoverContent
+ className="bg-background/70 dark:bg-background/60 w-52 !origin-center rounded-lg shadow-sm backdrop-blur-sm"
+ align="start"
+ >
+ {Object.entries(menuItems).map(([key, value]) => (
+ <Button
+ variant="ghost"
+ size="lg"
+ asChild
+ key={key}
+ className="*:[svg]:text-muted-foreground w-full justify-start text-base font-normal p-0"
+ >
+ {value(url)}
+ </Button>
+ ))}
+ </PopoverContent>
+ </div>
+ </Popover>
+ );
+}
diff --git a/content-collections.ts b/content-collections.ts
index 791a7d65..8a8f1937 100644
--- a/content-collections.ts
+++ b/content-collections.ts
@@ -7,6 +7,8 @@ import { codeImport } from "remark-code-import";
import remarkGfm from "remark-gfm";
import { createHighlighter } from "shiki";
import { visit } from "unist-util-visit";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
import { rehypeComponent } from "./lib/rehype-component";
import { rehypeNpmCommand } from "./lib/rehype-npm-command";
@@ -194,6 +196,18 @@ const documents = defineCollection({
slugAsParams: slugAsParams,
body: {
raw: document.content,
+ rawWithFrontmatter: await (async () => {
+ try {
+ const mdxPath = path.join(
+ process.cwd(),
+ "content/docs",
+ `${document._meta.path}.mdx`,
+ );
+ return await readFile(mdxPath, "utf8");
+ } catch {
+ return undefined;
+ }
+ })(),
code: body,
},
};
diff --git a/hooks/use-copy-to-clipboard.ts b/hooks/use-copy-to-clipboard.ts
new file mode 100644
index 00000000..2c6820b0
--- /dev/null
+++ b/hooks/use-copy-to-clipboard.ts
@@ -0,0 +1,37 @@
+"use client";
+
+import * as React from "react";
+
+export function useCopyToClipboard({
+ timeout = 2000,
+ onCopy,
+}: {
+ timeout?: number;
+ onCopy?: () => void;
+} = {}) {
+ const [isCopied, setIsCopied] = React.useState(false);
+
+ const copyToClipboard = (value: string) => {
+ if (typeof window === "undefined" || !navigator.clipboard.writeText) {
+ return;
+ }
+
+ if (!value) return;
+
+ navigator.clipboard.writeText(value).then(() => {
+ setIsCopied(true);
+
+ if (onCopy) {
+ onCopy();
+ }
+
+ if (timeout !== 0) {
+ setTimeout(() => {
+ setIsCopied(false);
+ }, timeout);
+ }
+ }, console.error);
+ };
+
+ return { isCopied, copyToClipboard };
+}
diff --git a/next.config.mjs b/next.config.mjs
index e0049f32..2acc7285 100644
--- a/next.config.mjs
+++ b/next.config.mjs
@@ -40,6 +40,14 @@ const nextConfig = {
},
];
},
+ rewrites() {
+ return [
+ {
+ source: "/docs/:path*.md",
+ destination: "/llm/:path*",
+ },
+ ]
+ },
};
export default withContentCollections(nextConfig);
diff --git a/package.json b/package.json
index 56a54677..d2842e8a 100644
--- a/package.json
+++ b/package.json
@@ -45,6 +45,7 @@
"@radix-ui/react-toast": "^1.2.6",
"@radix-ui/react-tooltip": "^1.1.8",
"@t3-oss/env-nextjs": "^0.7.1",
+ "@tabler/icons-react": "^3.34.1",
"@tailwindcss/postcss": "^4.1.4",
"@types/lodash.template": "^4.5.3",
"autoprefixer": "10.4.14",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 1fab222e..5b211d86 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -71,6 +71,9 @@ importers:
'@t3-oss/env-nextjs':
specifier: ^0.7.1
+ '@tabler/icons-react':
+ specifier: ^3.34.1
+ version: 3.34.1([email protected])
'@tailwindcss/postcss':
specifier: ^4.1.4
version: 4.1.4
@@ -1863,6 +1866,14 @@ packages:
typescript:
optional: true
+ '@tabler/[email protected]':
+ resolution: {integrity: sha512-Ld6g0NqOO05kyyHsfU8h787PdHBm7cFmOycQSIrGp45XcXYDuOK2Bs0VC4T2FWSKZ6bx5g04imfzazf/nqtk1A==}
+ peerDependencies:
+ react: '>= 16'
+
+ '@tabler/[email protected]':
+ resolution: {integrity: sha512-9gTnUvd7Fd/DmQgr3MKY+oJLa1RfNsQo8c/ir3TJAWghOuZXodbtbVp0QBY2DxWuuvrSZFys0HEbv1CoiI5y6A==}
+
'@tailwindcss/[email protected]':
resolution: {integrity: sha512-MT5118zaiO6x6hNA04OWInuAiP1YISXql8Z+/Y8iisV5nuhM8VXlyhRuqc2PEviPszcXI66W44bCIk500Oolhw==}
@@ -7235,6 +7246,13 @@ snapshots:
optionalDependencies:
typescript: 5.8.2
+ dependencies:
+ '@tabler/icons': 3.34.1
+ react: 18.3.1
+
+ '@tabler/[email protected]': {}
+
'@tailwindcss/[email protected]':
dependencies:
enhanced-resolve: 5.18.1