/remix-guide

An interactive list of awesome stuffs about Remix

Primary LanguageTypeScriptMIT LicenseMIT

remix-guide

Remix Guide is a platform for sharing everything about Remix. It is built with Remix and is deployed to Cloudflare Workers. All contents are saved in Durable Objects and cached with Worker KV.

Roadmap

The idea behind Remix Guide is to make resources from the community more accessible and making the process as automatic as possible at the same time. Future plans include:

  • Make and share your own list
  • Better search ranking / recommendations
  • Support searching by language and version (remix and packages)

Submission

As of v1.0, new resources can only be submitted online. There are some basic validations in place to ensure the submitted URL is relevant to remix. However, in order to minimize the risk of spamming or phishing, additional measures have to be added before it is generally available.

If you would like to submit new content, feel free to share them on the #showcase channel of the Remix Discord. We are watching the channel and will publish anything shared there as soon as possible.

Node Version

Please make sure the node version is >= 16.7. If you are using nvm, just run:

nvm use

This allows miniflare to serve a development environment as close to the actual worker runtime as possibile.

Development

To starts your app in development mode, rebuilding assets on file changes, the recommended approach is:

npm run dev

This will run your remix app in dev mode using miniflare with the Cypress test runner opened.

Deployment

First, preview your app with:

npx wrangler preview

When confirmed everythings works, deploy the worker with Wrangler using:

npx wrangler publish