add link validation

apps/docs/package.json

@@ -7,9 +7,11 @@
     "dev": "next dev -p 3001",
     "build": "next build",
     "start": "next start -p 3001",
-    "lint": "eslint",
+    "lint": "eslint && pnpm check-links",
     "build:docker": "docker build -f apps/docs/Dockerfile -t docs .",
-    "format": "prettier --check . --ignore-path ../../.gitignore"
+    "format": "prettier --check . --ignore-path ../../.gitignore",
+    "typecheck": "tsc --noEmit --emitDeclarationOnly false",
+    "check-links": "linkinator http://localhost:3001 --silent --timeout 5000"
   },
   "dependencies": {
     "@ctrlplane/ui": "workspace:*",
@@ -30,6 +32,7 @@
     "@types/react": "catalog:react18",
     "@types/react-dom": "catalog:react18",
     "eslint": "catalog:",
+    "linkinator": "^6.1.2",
     "postcss-load-config": "^6.0.1",
     "prettier": "catalog:",
     "tailwindcss": "catalog:",

apps/docs/pages/index.mdx

@@ -39,7 +39,7 @@ setup more efficient, secure, and easy to manage
   <Cards.Card
     icon={<TbServer className="h-8 w-8 stroke-yellow-400" />}
     title="Core Concepts"
-    href="/core-concepts"
+    href="/core-concepts/systems"
   />
   <Cards.Card
     icon={<TbPlug className="h-8 w-8 stroke-purple-400" />}

apps/docs/pages/integrations.mdx

@@ -0,0 +1,41 @@
+---
+title: Integrations Overview
+---
+
+# Integrations Overview
+
+Integrations allow you to connect Ctrlplane with various services, enhancing
+your deployment capabilities and workflows. Below are the available integrations
+you can set up.
+
+## Available Integrations
+
+import { Cards } from "nextra/components";
+import { SiGithub, SiGooglecloud, SiKubernetes } from "react-icons/si";
+
+<Cards>
+  <Cards.Card
+    icon={<SiGithub className="h-8 w-8" />}
+    title="GitHub"
+    href="/integrations/github"
+  />
+  <Cards.Card
+    icon={<SiGooglecloud className="h-8 w-8" />}
+    title="Google Cloud"
+    href="/integrations/google"
+  />
+  <Cards.Card
+    icon={<SiKubernetes className="h-8 w-8" />}
+    title="Kubernetes"
+    href="/integrations/kubernetes"
+  />
+</Cards>
+
+## How to Set Up Integrations
+
+To set up an integration, follow the specific instructions provided in the
+respective integration documentation. Ensure you have the necessary permissions
+and configurations in place to connect Ctrlplane with the external service.
+
+For more detailed information on each integration, please refer to the links
+provided in the cards above.

apps/docs/pages/self-hosted/overview.mdx → apps/docs/pages/self-hosted.mdx

@@ -1,3 +1,7 @@
+---
+title: Self-hosted
+---
+
 # Overview
 
 Ctrlplane is still in its early days, not everything is perfect yet, and hiccups