diff --git a/docs/.vuepress/theme/components/Home.vue b/docs/.vuepress/theme/components/Home.vue
index 24f5686..1940761 100644
--- a/docs/.vuepress/theme/components/Home.vue
+++ b/docs/.vuepress/theme/components/Home.vue
@@ -31,7 +31,14 @@
         <p>{{ feature.details }}</p>
         <div v-if="feature.actions && feature.actions.length" class="actions">
           <template v-for="(action, index) in feature.actions">
-            <router-link :to="action.link" class="action-button">{{
+            <a
+              v-if="isExternal(action.link)"
+              :href="action.link"
+              class="action-button"
+              target="_blank"
+              rel="noopener noreferrer"
+            >{{ action.text }}</a>
+            <router-link v-else :to="action.link" class="action-button">{{
               action.text
             }}</router-link>
           </template>
@@ -67,6 +74,16 @@ export default {
         text: this.data.actionText
       }
     }
+  },
+
+  methods: {
+    // only treat as external when link is clearly a full URL
+    // relative paths still use router link
+    isExternal(link) {
+      if (typeof link !== 'string') return false
+      const trimmed = link.trim()
+      return trimmed.startsWith('http://') || trimmed.startsWith('https://')
+    }
   }
 }
 </script>
diff --git a/docs/README.md b/docs/README.md
index 4ee6e19..44b288d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -11,7 +11,7 @@ features:
     details: Get your randomness or chain information directly by sending HTTP `GET` requests to the drand JSON HTTP API.
     actions:
       - text: API docs
-        link: /developer/http-api
+        link: https://docs.drand.love/dev-guide/developer/http-api
   - title: Client libraries
     details: Use drand client libraries to easily consume randomness from your applications, over HTTP, gRPC or libp2p PubSub.
     actions: