feat: set up llms.txt (#84)

Author: wescopeland

.gitignore

@@ -122,6 +122,10 @@ dist
 # Stores VSCode versions used for testing VSCode extensions
 .vscode-test
 
+# IDEs
+CLAUDE.local.md
+.claude/
+
 # yarn v2
 .yarn/cache
 .yarn/unplugged

docs/.vitepress/config.mts

@@ -1,4 +1,6 @@
 import { defineConfig } from "vitepress";
+import llmstxt from "vitepress-plugin-llms";
+import { copyOrDownloadAsMarkdownButtons } from "vitepress-plugin-llms";
 
 /**
  * Try your best not to have any sidebar page titles wrap to a 2nd line.
@@ -10,6 +12,16 @@ export default defineConfig({
   description:
     "The official documentation for how to get achievement, user, and game data from RetroAchievements.",
 
+  vite: {
+    plugins: [llmstxt()],
+  },
+
+  markdown: {
+    config(md) {
+      md.use(copyOrDownloadAsMarkdownButtons);
+    },
+  },
+
   themeConfig: {
     siteTitle: "API",
     logo: "/logo.webp",

docs/.vitepress/theme/ConditionalCopyButtons.vue

@@ -0,0 +1,15 @@
+<script setup>
+import { useRoute } from "vitepress";
+import CopyOrDownloadAsMarkdownButtons from "vitepress-plugin-llms/vitepress-components/CopyOrDownloadAsMarkdownButtons.vue";
+
+const route = useRoute();
+
+const shouldShow = () => {
+  const path = route.path;
+  return path !== "/" && path !== "/getting-started";
+};
+</script>
+
+<template>
+  <CopyOrDownloadAsMarkdownButtons v-if="shouldShow()" />
+</template>

docs/.vitepress/theme/index.js

@@ -0,0 +1,12 @@
+import "./styles.css";
+
+import DefaultTheme from "vitepress/theme";
+import type { Theme } from "vitepress";
+import ConditionalCopyButtons from "./ConditionalCopyButtons.vue";
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    app.component("CopyOrDownloadAsMarkdownButtons", ConditionalCopyButtons);
+  },
+} satisfies Theme;

docs/.vitepress/theme/index.ts

@@ -16,8 +16,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "vitepress": "^1.2.2",
-    "vue": "3.3.13"
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-llms": "^1.7.3",
+    "vue": "3.5.18"
   },
   "devDependencies": {
     "husky": "8.0.3",