Skip to content

[Docs Request]: Guide for deploying Remix 3 to Workers with Workers Assets #34211

Open

Description

@bennyhinn18

Proposed changes

Subject Matter

New framework guide: Deploying Remix 3 applications to Cloudflare Workers with Workers Assets (env.ASSETS).

Content Location

src/content/docs/workers/framework-guides/web-apps/more-web-frameworks/remix.mdx (alongside TanStack Start, Waku, Solid, and Hono).

Additional information

Remix 3 is a modern, independent framework designed strictly around web-standard Request and Response objects and runtime-agnostic routing. Because of its decoupled architecture, it runs natively on Cloudflare Workers workerd with sub-millisecond cold starts and global Edge Asset distribution (env.ASSETS).

Currently, Cloudflare Workers documentation does not have a guide for developers building new applications with Remix 3.

I have prepared a complete MDX framework guide following Cloudflare's style guide and component standards that covers:

  1. Architecture & Manual Setup: Explaining the Workers request lifecycle, wrangler.jsonc configuration, worker.ts entry point, and serving static bundles through env.ASSETS.
  2. Accessing Bindings: Typing and accessing Cloudflare bindings (KV, D1, R2, AI) in Remix 3 actions and controllers.
  3. Scaffolding CLI Option: Documenting the community starter CLI (npm create @bennyhinn18/remix-cloudflare) for instant zero-config scaffolding and health diagnostics.

Would the Cloudflare docs team be interested in a PR adding this to the more-web-frameworks section?

Activity

  1. github-actions commented on Nov 12, 2026

    @github-actions
    Contributor

    Hey there, we've marked this issue as stale because there's no recent activity on it. This label helps us identify long-standing issues in our repo (and not used to auto-close issues).

  2. ngbrown commented on Nov 16, 2026

    @ngbrown

    https://developers.cloudflare.com/workers/framework-guides/web-apps/remix/ uses Vite+ and Pitlane.

    But it doesn't work because when I followed the guide I get this error when I try to run vp dev:

    error when starting dev server:                                                                                         
    Error: [assets] Could not analyze "src/entry.browser.ts" for the "client" development asset manifest: There is a new version of the pre-bundle for "[path-to-project]\src\entry.browser.ts", a page reload is going to ask for it.
        at runInRunnerObject (./workers/runner-worker/index.js:107:3)
        at getWorkerEntryExportTypes (./workers/runner-worker/index.js:252:24)
        at null.<anonymous> (./workers/runner-worker/index.js:356:37)
        at maybeCaptureError (./workers/runner-worker/index.js:51:10) {
      [cause]: undefined
    }
    
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions