diff --git a/app/pages/package-code/[[org]]/[packageName]/v/[version]/[...filePath].vue b/app/pages/package-code/[[org]]/[packageName]/v/[version]/[...filePath].vue
index 2202494d7..29208b231 100644
--- a/app/pages/package-code/[[org]]/[packageName]/v/[version]/[...filePath].vue
+++ b/app/pages/package-code/[[org]]/[packageName]/v/[version]/[...filePath].vue
@@ -249,6 +249,14 @@ function copyPermalinkUrl() {
   copyPermalink(url.toString())
 }
 
+// Scroll to top of file content
+const contentContainer = useTemplateRef('contentContainer')
+function scrollToTop() {
+  if (contentContainer.value) {
+    contentContainer.value.scrollTo({ top: 0, behavior: 'smooth' })
+  }
+}
+
 // Canonical URL for this code page
 const canonicalUrl = computed(() => `https://npmx.dev${getCodeUrl(route.params)}`)
 
@@ -410,6 +418,7 @@ defineOgImageComponent('Default', {
       <!-- File content / Directory listing - sticky with internal scroll on desktop -->
       <div
         class="flex-1 min-w-0 overflow-x-hidden sticky top-28 self-start h-[calc(100vh-7rem)] overflow-y-auto"
+        ref="contentContainer"
       >
         <!-- File viewer -->
         <template v-if="isViewingFile && fileContent">
@@ -449,6 +458,14 @@ defineOgImageComponent('Default', {
               </div>
             </div>
             <div class="flex items-center gap-2">
+              <button
+                type="button"
+                class="px-2 py-1 font-mono text-xs text-fg-muted bg-bg-subtle border border-border rounded hover:text-fg hover:border-border-hover transition-colors items-center inline-flex gap-1"
+                @click="scrollToTop"
+              >
+                <span class="i-lucide:arrow-up w-3 h-3" />
+                {{ $t('code.scroll_to_top') }}
+              </button>
               <button
                 v-if="selectedLines"
                 type="button"
diff --git a/i18n/locales/en.json b/i18n/locales/en.json
index 4c652248a..383b860ca 100644
--- a/i18n/locales/en.json
+++ b/i18n/locales/en.json
@@ -699,7 +699,8 @@
       "preview": "preview",
       "code": "code"
     },
-    "file_path": "File path"
+    "file_path": "File path",
+    "scroll_to_top": "Scroll to top"
   },
   "badges": {
     "provenance": {
diff --git a/i18n/locales/zh-CN.json b/i18n/locales/zh-CN.json
index 14593b04a..e4c66a7d0 100644
--- a/i18n/locales/zh-CN.json
+++ b/i18n/locales/zh-CN.json
@@ -663,7 +663,8 @@
       "preview": "预览",
       "code": "代码"
     },
-    "file_path": "文件路径"
+    "file_path": "文件路径",
+    "scroll_to_top": "滚动到顶部"
   },
   "badges": {
     "provenance": {
diff --git a/i18n/schema.json b/i18n/schema.json
index 5ce1bf37b..f2ca3805d 100644
--- a/i18n/schema.json
+++ b/i18n/schema.json
@@ -2103,6 +2103,9 @@
         },
         "file_path": {
           "type": "string"
+        },
+        "scroll_to_top": {
+          "type": "string"
         }
       },
       "additionalProperties": false
diff --git a/lunaria/files/en-GB.json b/lunaria/files/en-GB.json
index 0b1ecf9c6..1ca491700 100644
--- a/lunaria/files/en-GB.json
+++ b/lunaria/files/en-GB.json
@@ -698,7 +698,8 @@
       "preview": "preview",
       "code": "code"
     },
-    "file_path": "File path"
+    "file_path": "File path",
+    "scroll_to_top": "Scroll to top"
   },
   "badges": {
     "provenance": {
diff --git a/lunaria/files/en-US.json b/lunaria/files/en-US.json
index 359cd5e2a..7ead68060 100644
--- a/lunaria/files/en-US.json
+++ b/lunaria/files/en-US.json
@@ -698,7 +698,8 @@
       "preview": "preview",
       "code": "code"
     },
-    "file_path": "File path"
+    "file_path": "File path",
+    "scroll_to_top": "Scroll to top"
   },
   "badges": {
     "provenance": {
diff --git a/lunaria/files/zh-CN.json b/lunaria/files/zh-CN.json
index eb86181ec..10cb9ee62 100644
--- a/lunaria/files/zh-CN.json
+++ b/lunaria/files/zh-CN.json
@@ -662,7 +662,8 @@
       "preview": "预览",
       "code": "代码"
     },
-    "file_path": "文件路径"
+    "file_path": "文件路径",
+    "scroll_to_top": "滚动到顶部"
   },
   "badges": {
     "provenance": {