feat: migrate to monorepo & gha cache server docs

Author: LouisHaftmann

.gitignore

@@ -4,4 +4,6 @@
 node_modules/
 dist/
 **/.vitepress/dist/
-**/.vitepress/cache/
+**/.vitepress/cache/
+.turbo/
+.wrangler/

.vitepress/config.ts

@@ -2,14 +2,39 @@ import { defu } from 'defu'
 import { type DefaultTheme, defineConfig, type UserConfig } from 'vitepress'
 import { groupIconMdPlugin, groupIconVitePlugin } from 'vitepress-plugin-group-icons'
 
-export function defineConfigWithDefaults(config: UserConfig<DefaultTheme.Config>) {
+export function defineConfigWithDefaults(opts: {
+  title: string
+  description: string
+  url: string
+  port: number
+  /**
+   * Short format, e.g. `falcondev-oss/caps`
+   */
+  repo: string
+  config: UserConfig<DefaultTheme.Config>
+}) {
   return defu(
-    config,
+    opts.config,
     defineConfig({
-      outDir: new URL(`dist${config.base ?? ''}`, import.meta.url).pathname,
+      title: opts.title,
+      description: opts.description,
+      themeConfig: {
+        socialLinks: [{ icon: 'github', link: `https://github.com/${opts.repo}` }],
+        logo: '/logo.svg',
+      },
+      outDir: 'dist',
+      cleanUrls: true,
       vite: {
-        // @ts-expect-error plugin type
+        server: {
+          port: opts.port,
+        },
         plugins: [groupIconVitePlugin()],
+        build: {
+          minify: false,
+        },
+      },
+      sitemap: {
+        hostname: opts.url,
       },
       markdown: {
         config(md) {

.vitepress/theme/CustomLayout.vue

@@ -3,29 +3,32 @@
   "type": "module",
   "version": "1.0.0",
   "private": true,
-  "description": "",
+  "packageManager": "pnpm@10.13.1",
   "engines": {
     "node": "^22.14.0",
     "pnpm": "^10.11.1"
   },
   "scripts": {
-    "dev": "concurrently --prefix command 'vitepress dev' \"vitepress dev packages/\"{caps,configs,expo-event-source-polyfill,form,gha-cache-server,lang,nitro-trpc-event-handler,trpc-vue-query,util}",
-    "build": "vitepress build && bash -c 'echo packages/{caps,configs,expo-event-source-polyfill,form,gha-cache-server,lang,nitro-trpc-event-handler,trpc-vue-query,util} | xargs -n1 -P4 vitepress build'"
+    "dev": "turbo dev",
+    "deploy": "turbo deploy",
+    "build": "turbo build"
   },
   "dependencies": {
     "@eslint/eslintrc": "^3.3.1",
-    "@louishaftmann/eslint-config": "^4.2.0",
-    "@louishaftmann/prettier-config": "^4.2.0",
-    "concurrently": "^9.1.2",
+    "@louishaftmann/eslint-config": "^4.3.3",
+    "@louishaftmann/prettier-config": "^4.3.3",
+    "concurrently": "^9.2.0",
     "defu": "^6.1.4",
-    "eslint": "^9.28.0",
-    "prettier": "^3.5.3",
-    "remeda": "^2.23.0",
-    "vitepress-plugin-group-icons": "^1.6.0",
-    "vue": "^3.5.16"
+    "eslint": "^9.32.0",
+    "prettier": "^3.6.2",
+    "remeda": "^2.27.0",
+    "vitepress-plugin-group-icons": "^1.6.1",
+    "vue": "^3.5.18"
   },
   "devDependencies": {
-    "vite": "^6.3.5",
-    "vitepress": "^1.6.3"
+    "turbo": "^2.5.5",
+    "vite": "^7.0.6",
+    "vitepress": "^1.6.3",
+    "wrangler": "^4.27.0"
   }
 }

default-config.ts

@@ -1,38 +1,20 @@
 import { defineConfigWithDefaults } from '../../../default-config'
 
 export default defineConfigWithDefaults({
+  repo: 'falcondev-oss/caps',
+  port: 5175,
   title: 'Caps',
+  url: 'https://caps.falcondev.io',
   description:
     'Type-safe capability-based access control library for fine-grained permissions and authorization',
-  base: '/caps',
-  vite: {
-    server: {
-      port: 5175,
+  config: {
+    themeConfig: {
+      sidebar: [
+        {
+          text: 'Getting Started',
+          link: '/getting-started',
+        },
+      ],
     },
   },
-  themeConfig: {
-    // https://vitepress.dev/reference/default-theme-config
-    nav: [
-      { text: 'Guide', link: '/guide' },
-      { text: 'Examples', link: '/examples' },
-    ],
-
-    sidebar: [
-      {
-        text: 'Getting Started',
-        link: '/getting-started',
-      },
-      {
-        text: 'Guide',
-        items: [
-          {
-            text: 'Basic Concepts',
-            link: '/guide/basic-concepts',
-          },
-        ],
-      },
-    ],
-    socialLinks: [{ icon: 'github', link: 'https://github.com/falcondev-oss/caps' }],
-    logo: '/logo.svg',
-  },
 })

package.json

@@ -1,4 +1,3 @@
-export { default } from '../../../../.vitepress/theme/layout'
+export { default } from '../../../../theme/layout'
 
 import './custom.css'
-import 'virtual:group-icons.css'

packages/caps/.vitepress/config.ts

@@ -5,19 +5,19 @@
 ::: code-group
 
 ```sh [npm]
-$ npm install @falcondev-oss/caps
+npm install @falcondev-oss/caps
 ```
 
 ```sh [yarn]
-$ yarn add @falcondev-oss/caps
+yarn add @falcondev-oss/caps
 ```
 
 ```sh [pnpm]
-$ pnpm add @falcondev-oss/caps
+pnpm add @falcondev-oss/caps
 ```
 
 ```sh [bun]
-$ bun add @falcondev-oss/caps
+bun add @falcondev-oss/caps
 ```
 
 :::

packages/caps/.vitepress/theme/index.ts

@@ -12,10 +12,7 @@ hero:
   actions:
     - theme: brand
       text: Get Started
-      link: /guide
-    - theme: alt
-      text: Examples
-      link: /examples
+      link: /getting-started
 
 features:
   - title: Actor-Subject Model

packages/caps/getting-started.md

@@ -0,0 +1,9 @@
+{
+  "name": "caps",
+  "type": "module",
+  "scripts": {
+    "build": "vitepress build",
+    "dev": "vitepress dev",
+    "deploy": "wrangler deploy"
+  }
+}