Skip to content

Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

Publish Markdown page actions and copy updates

Michael Ramos6cbc2dab56f2
diff --git a/README.md b/README.md
index fa865ff..748055d 100644
--- a/README.md
+++ b/README.md
@@ -72,7 +72,7 @@ Use $html-wireframe to explore three responsive layouts for this checkout brief.
Use $html-prototype to make the checkout flow work, including validation, loading, failure, success, keyboard, and mobile states.
-Use $design-artifact with $html-diagram to give this architecture explainer a visual direction rooted in the system it describes.
+Use $design-artifact to follow this product's visual language and $html-diagram to turn the attached architecture brief into an interactive system map.
```
`$html` can route a broad request, while `$design-artifact` can supply creative direction across artifact types. Call a specialist directly when you know the artifact type. Each specialist remains independently usable when invoked directly.
diff --git a/site/app/docs/[[...slug]]/page.tsx b/site/app/docs/[[...slug]]/page.tsx
index 44c1ef4..1e10348 100644
--- a/site/app/docs/[[...slug]]/page.tsx
+++ b/site/app/docs/[[...slug]]/page.tsx
@@ -3,6 +3,7 @@ import { source } from "@/lib/source";
import {
DocsBody,
DocsDescription,
+ MarkdownCopyButton,
DocsPage,
DocsTitle,
} from "fumadocs-ui/layouts/docs/page";
@@ -27,6 +28,9 @@ export default async function Page({ params }: PageProps) {
{page.data.description ? (
<DocsDescription>{page.data.description}</DocsDescription>
) : null}
+ <div className="flex items-center border-b pt-2 pb-6">
+ <MarkdownCopyButton markdownUrl={`${page.url}.md`} />
+ </div>
<DocsBody>
<MDX components={getMDXComponents()} />
</DocsBody>
diff --git a/site/app/llms.mdx/docs/[[...slug]]/route.ts b/site/app/llms.mdx/docs/[[...slug]]/route.ts
new file mode 100644
index 0000000..9334cfa
--- /dev/null
+++ b/site/app/llms.mdx/docs/[[...slug]]/route.ts
@@ -0,0 +1,30 @@
+import { source } from "@/lib/source";
+import { notFound } from "next/navigation";
+
+interface RouteProps {
+ params: Promise<{ slug?: string[] }>;
+}
+
+/** Pre-render each guide's Markdown representation at build time. */
+export const revalidate = false;
+
+/** Serve the processed Markdown for a guide page. */
+export async function GET(_request: Request, { params }: RouteProps) {
+ const { slug } = await params;
+ const page = source.getPage(slug);
+
+ if (!page) notFound();
+
+ const markdown = await page.data.getText("processed");
+
+ return new Response(`# ${page.data.title}\n\n${markdown}`, {
+ headers: {
+ "Content-Type": "text/markdown; charset=utf-8",
+ },
+ });
+}
+
+/** Return every guide slug for static generation. */
+export function generateStaticParams() {
+ return source.generateParams();
+}
diff --git a/site/components/catalog-explorer.tsx b/site/components/catalog-explorer.tsx
index dbf1e45..079c502 100644
--- a/site/components/catalog-explorer.tsx
+++ b/site/components/catalog-explorer.tsx
@@ -478,7 +478,7 @@ export function CatalogExplorer() {
<p>
{collection === "mockups"
? "Three responsive, interactive HTML studies that borrow the information density and interaction grammar of familiar products."
- : "Readiness studies and high-fidelity product-interface studies, built as responsive, interactive HTML. Each one is the artifact, not a screenshot standing in for it."}
+ : "Agents can build high-fidelity HTML alternatives that match the real product. Open them at realistic screen sizes, try the interactions, and compare possible changes before touching production."}
</p>
</header>
<div className={styles.nativeExamples}>
diff --git a/site/lib/source.ts b/site/lib/source.ts
index 329095c..c072599 100644
--- a/site/lib/source.ts
+++ b/site/lib/source.ts
@@ -3,6 +3,11 @@ import { loader } from "fumadocs-core/source";
const docs = defineDocs({
dir: "content/docs",
+ docs: {
+ postprocess: {
+ includeProcessedMarkdown: true,
+ },
+ },
});
export const source = loader({
diff --git a/site/next.config.mjs b/site/next.config.mjs
index 70b89f7..3127478 100644
--- a/site/next.config.mjs
+++ b/site/next.config.mjs
@@ -3,6 +3,18 @@ import { createMDX } from "fumadocs-mdx/next";
/** @type {import("next").NextConfig} */
const config = {
reactStrictMode: true,
+ async rewrites() {
+ return [
+ {
+ source: "/docs.md",
+ destination: "/llms.mdx/docs",
+ },
+ {
+ source: "/docs/:path*.md",
+ destination: "/llms.mdx/docs/:path*",
+ },
+ ];
+ },
};
const withMDX = createMDX();