feat: migrate documentation site from Docusaurus to Astro v5 (#201)

Author: afonsojramos

.github/workflows/algolia_crawler.yml

@@ -2,6 +2,9 @@
 .docusaurus
 build
 
+# Astro
+.astro/
+
 # Logs
 logs
 *.log

.gitignore

@@ -0,0 +1,35 @@
+import mdx from '@astrojs/mdx';
+import react from '@astrojs/react';
+import sitemap from '@astrojs/sitemap';
+import { defineConfig } from 'astro/config';
+import expressiveCode from 'astro-expressive-code';
+import pagefind from 'astro-pagefind';
+import remarkDirective from 'remark-directive';
+import { remarkAdmonitions } from './src/plugins/remark-admonitions.mjs';
+import { remarkReadingTime } from './src/plugins/remark-reading-time.mjs';
+
+export default defineConfig({
+  site: 'https://spicetify.app',
+  trailingSlash: 'never',
+  build: {
+    format: 'file',
+  },
+  markdown: {
+    remarkPlugins: [remarkDirective, remarkAdmonitions, remarkReadingTime],
+  },
+  integrations: [
+    expressiveCode({
+      themes: ['github-light', 'dracula'],
+      useDarkModeMediaQuery: false,
+      themeCssSelector: (theme) =>
+        `[data-theme='${theme.type === 'dark' ? 'dark' : 'light'}']`,
+    }),
+    mdx(),
+    react(),
+    sitemap(),
+    pagefind(),
+  ],
+  redirects: {
+    '/docs/blog/authors': '/blog',
+  },
+});

astro.config.ts

@@ -3,40 +3,36 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
-    "docusaurus": "docusaurus",
-    "start": "docusaurus start",
-    "dev": "docusaurus start",
-    "build": "docusaurus build",
-    "rsdoctor": "RSDOCTOR=true docusaurus build",
-    "swizzle": "docusaurus swizzle",
-    "deploy": "docusaurus deploy",
-    "clear": "docusaurus clear",
-    "serve": "docusaurus serve",
-    "write-translations": "docusaurus write-translations",
-    "write-heading-ids": "docusaurus write-heading-ids",
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro",
     "prepare": "husky",
     "lint": "biome check",
     "format": "biome check --write"
   },
   "dependencies": {
-    "@algolia/client-search": "^5.39.0",
-    "@docusaurus/core": "^3.9.1",
-    "@docusaurus/preset-classic": "^3.9.1",
-    "@docusaurus/theme-common": "^3.9.1",
-    "@mdx-js/react": "^3.1.1",
+    "@astrojs/mdx": "^4.3.13",
+    "@astrojs/react": "^4.4.2",
+    "@astrojs/rss": "^4.0.15",
+    "@astrojs/sitemap": "^3.7.0",
+    "astro": "^5.17.3",
+    "astro-expressive-code": "^0.41.7",
+    "astro-pagefind": "^1.8.5",
     "clsx": "^2.1.1",
-    "prism-react-renderer": "^2.4.1",
+    "mdast-util-to-string": "^4.0.0",
     "react": "19.2.0",
     "react-dom": "19.2.0",
+    "reading-time": "^1.5.0",
+    "remark-directive": "^4.0.0",
     "swiper": "^12.0.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.5",
-    "@docusaurus/faster": "^3.9.1",
-    "@docusaurus/module-type-aliases": "^3.9.1",
-    "@docusaurus/tsconfig": "^3.9.1",
-    "@docusaurus/types": "^3.9.1",
     "@types/node": "^24.6.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.3",
     "typescript": "^5.9.3"