Remix on Fastly Compute

Deploy and serve your Remix website from Fastly's blazing-fast Compute.

NOTE: Supports Remix@1. If you need Remix@2, use Version 4 or newer.

Remix

Remix is a popular JavaScript-based full stack web framework that is designed to allow the developer to focus on the user interface and work back through web standards to deliver a fast, slick, and resilient user experience.

Usage

The easiest way to get up and running is to use Remix's CLI to initialize your project, specifying remix-template as the template. See using the template below.

If you already have a Remix application that you'd like to move to Fastly Compute, see MIGRATING.md.

Once you have initialized your project, start the application:

npm run dev

You can browse your shiny new application at http://127.0.0.1:7676!

To deploy your project to Fastly, use the following commands:

npm run build
npm run deploy

For more details, see the README file of remix-template.

Structure

This monorepo contains three projects:

@fastly/remix-server-runtime

A runtime that implements the interfaces defined in @remix-run/server-runtime. Allows the Remix framework to run on Fastly Compute.
@fastly/remix-server-adapter

An adapter that allows the Compute JavaScript entry point program to start Remix.
remix-template

A template to be used with remix create to initialize a Remix application. The template is configured with the above libraries so that it is able to run on Fastly Compute.

Using the template

Initialize your new Remix application by running the following:

npm create remix@1 ./new-app-js -- --template https://github.com/fastly/remix-compute-js/tree/v3/packages/remix-template

Webpack

Past versions of the template used Webpack. This was needed at the time since the Compute JavaScript SDK did not yet natively support signing and verifying crypto keys, and we used the 'crypto-browserify' polyfill to fill the gap. Starting with 3.0.0, we no longer need this, and Webpack and these polyfills have been removed from the template.

There are cases where you may still want to use Webpack, such as if you want to replace global modules or use polyfills. For details, see "Module bundling" in the template's README.

Issues

If you encounter any non-security-related bug or unexpected behavior, please file an issue using the bug report template.

Security issues

Please see our SECURITY.md for guidance on reporting security-related issues.

License

MIT.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!