docs: add starlight

.github/workflows/docs.yml

@@ -0,0 +1,35 @@
+name: Deploy Docs to GH Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Build & Upload Site
+        uses: withastro/action@v4
+        with:
+          path: ./docs
+          package-manager: [email protected]
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -5,10 +5,6 @@
   <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
 </h3>
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/palette/macchiato.png" width="400" />
-</p>
-
 <p align="center">
 	<a href="https://github.com/catppuccin/userstyles/stargazers"><img src="https://img.shields.io/github/stars/catppuccin/userstyles?colorA=363a4f&colorB=b7bdf8&style=for-the-badge"></a>
   <a href="https://github.com/catppuccin/userstyles/blob/main/styles"><img src="https://img.shields.io/github/directory-file-count/catppuccin/userstyles/styles?label=Userstyles&colorA=363a4f&colorB=cba6f7&style=for-the-badge"></a>
@@ -21,269 +17,12 @@ A curated collection of soothing pastel themes for your favorite websites and we
 </p>
 
 <p align="center">
-<img src="docs/images/preview.webp"/>
+<img src="docs/src/assets/preview.webp"/>
 </p>
 
-## Getting started
-
-To get started using the catppuccin/userstyles collection, see [Usage](docs/USAGE.md).
-
-To get started contributing to catppuccin/userstyles, see [Contributing](docs/CONTRIBUTING.md) and [Userstyle Creation](docs/userstyle-creation.md).
-
-## 🖌 Userstyles
-
-> [!IMPORTANT]
-> Userstyles labeled with the "❤️‍🩹" emoji lack maintainers, and may not work as intended. Contributions are still welcome and encouraged!
-
-<!-- AUTOGEN:USERSTYLES START -->
-<!-- The following section is auto-generated, do not edit. -->
-<details open>
-<summary>💭 Development Tools</summary>
-
-- [boringproxy](styles/boringproxy)
-- [Codeberg](styles/codeberg)
-- [DevDocs](styles/devdocs)
-- [docs.deno.com](styles/docs.deno.com)
-- [docs.rs](styles/docs.rs)
-- [freedesktop.org](styles/freedesktop)
-- [GitHub](styles/github)
-- [gleam.run](styles/gleam.run)
-- [go.dev](styles/go.dev)
-- [Grabify](styles/grabify)
-- ❤️‍🩹 [Graphite](styles/graphite)
-- [Home Manager Options Search](styles/home-manager-options-search)
-- [Hoogle](styles/hoogle)
-- [Hoppscotch](styles/hoppscotch)
-- [Keyoxide](styles/keyoxide)
-- [Learn X in Y Minutes](styles/learn-x-in-y-minutes)
-- [MDN](styles/mdn)
-- [Next.js](styles/vercel)
-- [NixOS Manual](styles/nixos-manual)
-- [Nixpkgs Manual](styles/nixos-manual)
-- [paste.rs](styles/paste.rs)
-- [PythonAnywhere](styles/pythonanywhere)
-- [React.dev](styles/react.dev)
-- [Trinket](styles/trinket)
-- [Vercel](styles/vercel)
-- [web.dev](styles/web.dev)
-
-</details>
-<details open>
-<summary>📜 Documentation Generators</summary>
-
-- [mdBook](styles/mdbook)
-
-</details>
-<details open>
-<summary>🌱 Terminals</summary>
-
-- [Ghostty.org](styles/ghostty.org)
-
-</details>
-<details open>
-<summary>🗂️ File Managers</summary>
-
-- [openmediavault](styles/openmediavault)
-- [Syncthing](styles/syncthing)
-
-</details>
-<details open>
-<summary>🧩 Browser Extensions</summary>
-
-- [Indie Wiki Buddy](styles/indie-wiki-buddy)
-- [Shinigami Eyes](styles/shinigami-eyes)
-- [Stylus](styles/stylus)
-
-</details>
-<details open>
-<summary>🔎 Search Engines</summary>
-
-- [Brave Search](styles/brave-search)
-- [DuckDuckGo](styles/duckduckgo)
-- ❤️‍🩹 [Ecosia](styles/ecosia)
-- ❤️‍🩹 [Google](styles/google)
-- [Mullvad Leta](styles/mullvad-leta)
-- [NixOS Search](styles/nixos-search)
-- [SearXNG](styles/searxng)
-- ❤️‍🩹 [Startpage](styles/startpage)
-
-</details>
-<details open>
-<summary>📦 Package Registries</summary>
-
-- [crates.io](styles/crates.io)
-- [Hackage](styles/hackage)
-- [npm](styles/npm)
-- [PyPI](styles/pypi)
-
-</details>
-<details open>
-<summary>🗺️ Translation Tools</summary>
-
-- [Crowdin](styles/crowdin)
-- [DeepL](styles/deepl)
-- [ichi.moe](styles/ichi.moe)
-- [Jisho](styles/jisho)
-- [Lingva](styles/lingva)
-
-</details>
-<details open>
-<summary>🧠 Wikis</summary>
-
-- ❤️‍🩹 [Arch Wiki](styles/arch-wiki)
-- [NixOS Wiki](styles/wiki.nixos.org)
-- [Wikipedia](styles/wikipedia)
-- [Wikiwand](styles/wikiwand)
-
-</details>
-<details open>
-<summary>📸 Photo &amp; Video</summary>
-
-- [Google Photos](styles/google-photos)
-- [Pinterest](styles/pinterest)
-
-</details>
-<details open>
-<summary>🎵 Music</summary>
-
-- [Hyperpipe](styles/hyperpipe)
-- [Last.fm](styles/lastfm)
-- [ListenBrainz](styles/listenbrainz)
-- [Spotify Web](styles/spotify-web)
-
-</details>
-<details open>
-<summary>📖 Productivity</summary>
-
-- [AlternativeTo](styles/alternativeto)
-- [cobalt](styles/cobalt)
-- [Google Drive](styles/google-drive)
-- [Have I Been Pwned](styles/have-i-been-pwned)
-- [homepage](styles/homepage)
-- [inoreader](styles/inoreader)
-- [keybr.com](styles/keybr.com)
-- ❤️‍🩹 [Microsoft Word](styles/microsoft-word)
-- [Porkbun](styles/porkbun)
-- [Proton](styles/proton)
-- [Raindrop](styles/raindrop)
-- [Rentry.co](styles/rentry.co)
-- [tldraw](styles/tldraw)
-- [Vikunja](styles/vikunja)
-- [Zen Browser Docs](styles/zen-browser-docs)
-
-</details>
-<details open>
-<summary>💌 Email Clients</summary>
-
-- [Gmail](styles/gmail)
-- [Migadu Webmail](styles/migadu-webmail)
-- [Tuta](styles/tuta)
-
-</details>
-<details open>
-<summary>🕹️ Game Development</summary>
-
-- [NameMC](styles/namemc)
-
-</details>
-<details open>
-<summary>📝 Note Taking</summary>
-
-- [Amplenote](styles/amplenote)
-
-</details>
-<details open>
-<summary>🎓 Education</summary>
-
-- [Canvas LMS](styles/canvas-lms)
-- [Desmos](styles/desmos)
-- [Formative](styles/formative)
-- [Quizlet](styles/quizlet)
-
-</details>
-<details open>
-<summary>📰 News &amp; Journalism</summary>
-
-- [Substack](styles/substack)
-
-</details>
-<details open>
-<summary>✨ Social Networking</summary>
-
-- [Bluesky Social](styles/bsky)
-- [Cinny](styles/cinny)
-- [Elk](styles/elk)
-- [Instagram](styles/instagram)
-- ❤️‍🩹 [LinkedIn](styles/linkedin)
-- [Mastodon](styles/mastodon)
-- [Nitter](styles/nitter)
-- [Phanpy](styles/phanpy)
-- [pronouns.cc](styles/pronouns.cc)
-- [Pronouns.page](styles/pronouns.page)
-- [Snapchat Web](styles/snapchat-web)
-- [status.cafe](styles/status.cafe)
-- [Twitter](styles/twitter)
-- [WhatsApp Web](styles/whatsapp-web)
-
-</details>
-<details open>
-<summary>🗣️ Discussion Forums</summary>
-
-- [DEV Community](styles/dev.to)
-- [Hacker News](styles/hacker-news)
-- [Lemmy](styles/lemmy)
-- ❤️‍🩹 [Libreddit](styles/libreddit)
-- [Lobsters](styles/lobste.rs)
-- ❤️‍🩹 [Reddit](styles/reddit)
-- ❤️‍🩹 [Redlib](styles/libreddit)
-- [Stack Overflow](styles/stack-overflow)
-- [TabNews](styles/tabnews)
-
-</details>
-<details open>
-<summary>🌈 Entertainment</summary>
-
-- [7TV](styles/seventv)
-- [AniChart](styles/anilist)
-- [AniList](styles/anilist)
-- [ChatReplay](styles/chatreplay)
-- [Holodex](styles/holodex)
-- ❤️‍🩹 [Invidious](styles/invidious)
-- [Picrew](styles/picrew)
-- [Twitch](styles/twitch)
-- [YouTube](styles/youtube)
-
-</details>
-<details open>
-<summary>🎮 Games</summary>
-
-- [Advent Of Code](styles/advent-of-code)
-- [Chess.com](styles/chess.com)
-- [Lichess](styles/lichess)
-- ❤️‍🩹 [Minesweeper Online](styles/minesweeper)
-- [Modrinth](styles/modrinth)
-- [Planet Minecraft](styles/planet-minecraft)
-
-</details>
-<details open>
-<summary>📊 Analytics</summary>
-
-- [bStats](styles/bstats)
-
-</details>
-<details open>
-<summary>🤖 Artificial Intelligence</summary>
-
-- [ChatGPT](styles/chatgpt)
-- [Claude](styles/claude)
-- [Google Gemini](styles/google-gemini)
-- [InvokeAI](styles/invokeai)
-- [Ollama](styles/ollama)
-- [Perplexity](styles/perplexity)
-
-</details>
-
-<!-- AUTOGEN:USERSTYLES END -->
+<p align="center">
+Visit <a href="https://userstyles.catppuccin.com">userstyles.catppuccin.com</a> to get started.
+</p>
 
 &nbsp;
 

docs/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store