Skip to content

jacob-ebey/remix-cloudflare-worker-template

Repository files navigation

Remix + Cloudflare Workers + DO + Turborepo

A starter to get you up and going with Remix on Cloudflare with all the latest and greatest.

What's inside?

This repo uses npm as a package manager. It includes the following packages/apps:

Packages

  • packages/chat-room-do: a Durable Object for chat rooms
  • packages/counter-do: a Durable Object for counting things
  • packages/rate-limiter-do: a Durable Object for limiting clients
  • packages/remix-app: a Remix application that makes up the public facing UX
  • packages/worker: a Cloudflare Worker that brings everything together for deployment
  • config/cloudflare-env: type definitions for bindings shared across the packages
  • config/eslint-config-custom: shared eslint config that includes @remix-run/eslint-config and prettier
  • config/tsconfig: base tsconfig that other packages inherit from

Each package/* is 100% TypeScript.

Utilities

This turborepo has some additional tools already setup for you:

Setup

Clone and install dependencies:

npm i

Build

To build all apps and packages, run the following command:

npm run build

Develop

To develop all apps and packages, run the following command:

npm run dev

Remote Caching

Turborepo can use a technique known as Remote Caching (Beta) to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.

By default, Turborepo will cache locally. To enable Remote Caching (Beta) you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:

npx turbo login

This will authenticate the Turborepo CLI with your Vercel account.

Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your turborepo:

npx turbo link

Useful Links

Learn more about the power of Turborepo: