From 12e07d30b45c4b15e6bd27a123cc007ea7508bd0 Mon Sep 17 00:00:00 2001
From: reginaldalfret <reginaldalfret@gmail.com>
Date: Wed, 7 Oct 2026 20:53:25 +0530
Subject: [PATCH] docs: clarify build and dependency install prerequisites for
 frameworks

Signed-off-by: reginaldalfret <reginaldalfret@gmail.com>
---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 001b1e9b..dd245718 100644
--- a/README.md
+++ b/README.md
@@ -94,6 +94,17 @@ jobs:
           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
 ```
 
+> **Note:** If your application requires a compilation step or custom build output (such as Remix, Next.js / OpenNext, Astro, TanStack Start, SvelteKit, etc.), make sure to run your package manager install and build steps prior to `wrangler-action`:
+> ```yaml
+>       - uses: actions/checkout@v6
+>       - run: npm ci
+>       - run: npm run build
+>       - name: Deploy
+>         uses: cloudflare/wrangler-action@v4
+>         with:
+>           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+> ```
+
 ## Authentication
 
 You'll need to configure Wrangler using GitHub's Secrets feature - go to "Settings -> Secrets" and add your Cloudflare API token (for help finding this, see the [Workers documentation](https://developers.cloudflare.com/workers/wrangler/ci-cd/#api-token)). Your API token is encrypted by GitHub, and the action won't print it into logs, so it should be safe!