diff --git a/.github/workflows/gh-pages.yaml b/.github/workflows/gh-pages.yaml
index 2d8792f8..146ba77f 100644
--- a/.github/workflows/gh-pages.yaml
+++ b/.github/workflows/gh-pages.yaml
@@ -40,7 +40,10 @@ jobs:
         run: pnpm install
 
       - name: Build 🛠
-        run: pnpm docs:build
+        # The libraries have to be built first: the storybook resolves
+        # @commercelayer/core-components to its dist, which does not exist on a
+        # clean checkout.
+        run: pnpm build && pnpm docs:build
 
       - name: Setup Pages 🧰
         uses: actions/configure-pages@v4
diff --git a/netlify.toml b/netlify.toml
index 0225dfa2..d83f5ca2 100644
--- a/netlify.toml
+++ b/netlify.toml
@@ -9,7 +9,13 @@
 
 [build]
   base = "/"
-  command = "pnpm docs:build"
+  # The libraries must be built before the storybook. Its Vite config aliases
+  # @commercelayer/react-components straight to source, but that source imports
+  # @commercelayer/core-components, which is a workspace package resolving to
+  # ./dist/index.js — absent on a clean checkout, so rolldown fails to resolve
+  # it. Locally the storybook builds without this only because dist/ is already
+  # lying around from a previous build.
+  command = "pnpm build && pnpm docs:build"
   publish = "packages/docs/storybook-static"
 
 [build.environment]