refactor: move docs to starlight

.gitignore

@@ -2,5 +2,5 @@ node_modules
 .env
 dist
 .jellycommands
-packages/docs/.vitepress/cache
 coverage
+.astro/

.prettierignore

@@ -2,7 +2,7 @@ node_modules
 .env
 dist
 .jellycommands
-.vitepress/cache
 .changeset/*.md
 .changeset/pre.json
 pnpm-lock.yaml
+.astro/

.vscode/extensions.json

@@ -1,3 +1,7 @@
 {
-	"recommendations": ["esbenp.prettier-vscode", "biomejs.biome"]
+	"recommendations": [
+		"esbenp.prettier-vscode",
+		"biomejs.biome",
+		"astro-build.astro-vscode"
+	]
 }

packages/docs/astro.config.mjs

@@ -0,0 +1,161 @@
+// @ts-check
+import starlightLinksValidator from 'starlight-links-validator';
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// https://astro.build/config
+export default defineConfig({
+	site: 'https://jellycommands.dev',
+
+	output: 'static',
+	trailingSlash: 'never',
+
+	integrations: [
+		starlight({
+			title: 'JellyCommands',
+			description:
+				'Jellycommands is a developer experience focused command framework for discord.js. It has support for all types of application commands, including slash commands and conlabel menus. It also includes quality of life features such as caching and developer mode.',
+			social: {
+				github: 'https://github.com/ghostdevv/jellycommands',
+			},
+			favicon: '/logo.svg',
+			customCss: ['./src/theme.css'],
+			editLink: {
+				baseUrl:
+					'https://github.com/ghostdevv/jellycommands/edit/main/packages/docs/',
+			},
+			lastUpdated: true,
+			sidebar: [
+				{
+					label: 'Guide',
+					items: [
+						{
+							label: 'Get Started',
+							items: [
+								{
+									label: 'Overview',
+									link: '/guide/overview',
+								},
+								{
+									label: 'Import vs Require',
+									link: '/guide/require',
+								},
+							],
+						},
+						{
+							label: 'Commands',
+							items: [
+								{
+									label: 'Creating Commands',
+									link: '/guide/commands/files',
+								},
+								{
+									label: 'Registering Commands',
+									link: '/guide/commands/registering',
+								},
+								{
+									label: 'Dev Mode',
+									link: '/guide/commands/dev',
+								},
+								{
+									label: 'Slash Commands Extras',
+									link: '/guide/commands/slash',
+								},
+								{
+									label: 'Guards',
+									link: '/guide/commands/guards',
+								},
+							],
+						},
+						{
+							label: 'Events',
+							items: [
+								{
+									label: 'Creating Events',
+									link: '/guide/events/files',
+								},
+							],
+						},
+						{
+							label: 'Buttons',
+							items: [
+								{
+									label: 'Creating Buttons',
+									link: '/guide/buttons/files',
+								},
+							],
+						},
+						{
+							label: 'Core',
+							items: [
+								{
+									label: 'Components',
+									link: '/guide/components',
+								},
+								{
+									label: 'Props',
+									link: '/guide/props',
+								},
+								{
+									label: 'Messages',
+									link: '/guide/messages',
+								},
+							],
+						},
+						{
+							label: 'Migrate',
+							items: [
+								{
+									label: 'Components (1.0.0-next.44)',
+									link: '/guide/migrate/components',
+								},
+								{
+									label: 'Props (1.0.0-next.40)',
+									link: '/guide/migrate/props',
+								},
+								{
+									label: 'Discord.js v14 (1.0.0-next.31)',
+									link: '/guide/migrate/djs14',
+								},
+							],
+						},
+					],
+				},
+				{
+					label: 'API',
+					items: [
+						{
+							label: 'Core',
+							items: [
+								{
+									label: 'Client',
+									link: '/api/client',
+								},
+								{
+									label: 'Props',
+									link: '/api/props',
+								},
+								{
+									label: 'Commands',
+									link: '/api/commands',
+								},
+								{
+									label: 'Events',
+									link: '/api/events',
+								},
+								{
+									label: 'Buttons',
+									link: '/api/buttons',
+								},
+								{
+									label: 'App Types',
+									link: '/api/types',
+								},
+							],
+						},
+					],
+				},
+			],
+		}),
+	],
+});

packages/docs/package.json

@@ -2,8 +2,16 @@
 	"name": "@jellycommands/docs",
 	"private": true,
 	"scripts": {
-		"dev": "vitepress dev",
-		"build": "vitepress build"
+		"dev": "astro dev",
+		"build": "astro build",
+		"lint": "astro check"
+	},
+	"dependencies": {
+		"@astrojs/check": "^0.9.4",
+		"@astrojs/starlight": "^0.28.6",
+		"astro": "^4.15.3",
+		"sharp": "^0.32.5",
+		"typescript": "^5.6.3"
 	},
 	"packageManager": "[email protected]",
 	"engines": {
@@ -16,6 +24,6 @@
 		"pnpm": "9.12.3"
 	},
 	"devDependencies": {
-		"vitepress": "1.1.4"
+		"starlight-links-validator": "^0.13.0"
 	}
 }

packages/docs/src/content/config.ts

@@ -0,0 +1,6 @@
+import { defineCollection } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+	docs: defineCollection({ schema: docsSchema() }),
+};

packages/docs/api/buttons.md → packages/docs/src/content/docs/api/buttons.md

@@ -1,4 +1,6 @@
-# Buttons
+---
+title: Buttons
+---
 
 ## Loading
 
@@ -51,6 +53,6 @@ Should the interaction be defered
 
 When true JellyCommands will ignore this button.
 
-:::tip NOTE
+:::note
 When using file-loaded commands, you can get the same behavior by adding an `_` in front of the file.
 :::

packages/docs/api/client.md → packages/docs/src/content/docs/api/client.md

@@ -1,4 +1,6 @@
-# Client
+---
+title: Client
+---
 
 The `JellyCommands` client is the core of every project. It extends the [discord.js client](https://discord.js.org/#/docs/discord.js/main/class/Client) to add additional functionality.