diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 5780c084..28a49fb9 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -20,9 +20,11 @@ jobs:
         run: pixi run build-docs
 
       - name: Deploy to GitHub Pages
-        if: github.ref == 'refs/heads/main'
         uses: peaceiris/actions-gh-pages@v4
+        if: github.ref == 'refs/heads/main'
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/.vitepress/dist
-          cname: clice.io
+          personal_token: ${{ secrets.PUBLISH_DOCS }}
+          external_repository: clice-io/docs
+          publish_dir: ./docs/.vitepress/dist
+          destination_dir: clice
+          keep_files: true
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 2bf7d5c1..05508108 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -70,6 +70,7 @@ jobs:
     permissions:
       contents: write
     uses: ./.github/workflows/deploy-docs.yml
+    secrets: inherit
 
   clice:
     needs: changes
diff --git a/README.md b/README.md
index 97cf3145..ba1230a8 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 ![C++ Standard](https://img.shields.io/badge/C++-23-blue.svg)
 [![GitHub license](https://img.shields.io/github/license/clice-io/clice)](https://github.com/clice-io/clice/blob/main/LICENSE)
 [![Actions status](https://github.com/clice-io/clice/workflows/CI/badge.svg)](https://github.com/clice-io/clice/actions)
-[![Documentation](https://img.shields.io/badge/view-documentation-blue)](https://clice.io)
+[![Documentation](https://img.shields.io/badge/view-documentation-blue)](https://docs.clice.io/clice/)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/clice-io/clice)
 [![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white)](https://discord.gg/PA3UxW2VA3)
 
@@ -35,4 +35,4 @@ Download the latest `clice` binary from the [releases page](https://github.com/c
 
 ## Documentation
 
-To learn more about building, installing, and configuring clice, or to dive deep into its features and architecture, please visit our official documentation at [**clice.io**](https://clice.io/).
+To learn more about building, installing, and configuring clice, or to dive deep into its features and architecture, please visit our official documentation at [**clice.io**](https://docs.clice.io/clice/).
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index ef936f9a..821f60c4 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -6,7 +6,7 @@ export default defineConfig({
     title: "clice",
     description: "a powerful and modern C++ language server",
     cleanUrls: true,
-    base: "/",
+    base: "/clice/",
     rewrites: {
         "en/:rest*": ":rest*",
     },
diff --git a/pixi.toml b/pixi.toml
index c7c2ef4b..03995186 100644
--- a/pixi.toml
+++ b/pixi.toml
@@ -5,13 +5,13 @@ name = "clice"
 version = "0.1.0"
 description = "A next-generation C++ language server for modern C++"
 authors = [
-    "ykiko <ykikoykikoykiko@gmail.com>",
+    "ykiko <ykiko@clice.io>",
     "clice contributors <clice@clice.io>",
 ]
 license = "Apache-2.0"
 license-file = "LICENSE"
 readme = "README.md"
-documentation = "https://clice.io"
+documentation = "https://docs.clice.io/clice/"
 repository = "https://github.com/clice-io/clice"
 channels = ["conda-forge"]
 platforms = ["win-64", "linux-64", "osx-arm64"]