ryanccn/vendflare

Vencord backend on Cloudflare Workers

Vendflare

A Vencord backend/cloud/API running on Cloudflare Workers with Workers KV or Durable Objects.

The official implementation uses monolithic Go and Redis.

Getting started

Deploy this worker on Cloudflare using wrangler.

Change the bindings of the KV in wrangler.toml to the KV IDs on your own account. You could also use Durable Objects, which require subscribing to a paid plan on Cloudflare Workers; see Storage backends for more information.

An example of how you would do this:

$ git clone https://github.com/ryanccn/vendflare.git
$ cd vendflare
$ pnpm install --frozen-lockfile
$ pnpm run deploy

Then register a Discord application and set the OAuth client ID and secret as environment variables on your worker as DISCORD_CLIENT_ID and DISCORD_CLIENT_SECRET, respectively.

You can set ALLOWED_USERS as a comma-separated list of user IDs to only allow some users to use this instance.

You can also set a SIZE_LIMIT to limit the size of the configuration (so that people don't use it as a cloud drive).

Set ROOT_REDIRECT for the URL to redirect to on the root URL.

Storage backends

Vendflare's unified storage interface supports Workers KV and Durable Objects.

KV is often faster to retrieve and is free for a fair amount of usage (more than enough for Vendflare), but it is eventually consistent, meaning that changes take a minute or so to propagate to Cloudflare datacenters around the world. This may pose issues with synchronization.

Durable Objects are strongly consistent, located only in one datacenter location closest to the user who triggered the creation of the Object and providing a storage API designed for consistency. However, using it requires subscribing to the Cloudflare Workers paid plan.

It is recommended to try KV first. If major synchronization issues arise (which is a small possibility), switch to Durable Objects. Data is not shared between the storage backends.

When using KV, use wrangler.toml to bind KV to the KV on your Cloudflare account.

When using Durable Objects, also use wrangler.toml to bind USER_DATA to the UserData class exported by the worker.

Vendflare will automatically pick up whichever is defined (Durable Objects > KV) and use it for storage. If you specify a STORAGE_BACKEND variable of either "do", "kv", it will only try to use that backend.

Builds

By default, the deployed Cloudflare worker uses the dist/worker.js build, which supports KV and Durable Objects. It also uses the default Hono preset, which includes a more performant but larger bundle size router (recommended). The tiny preset includes a much smaller but less performant router.

One recommended optimization is to use the build that only supports the storage backend that you are actually using.

Build	KV	Durable Objects	Hono preset	Size
dist/worker.js	✅	✅	Default	~40 kB
dist/worker.kv.js	✅	❌	Default	~38 kB
dist/worker.do.js	❌	✅	Default	~39 kB
dist/worker.tiny.js	✅	✅	Tiny	~32 kB
dist/worker.kv.tiny.js	✅	❌	Tiny	~30 kB
dist/worker.do.tiny.js	❌	✅	Tiny	~32 kB

You can change what build you use by going to wrangler.toml and editing the main field to the path of the build that you want to use.

Testing

Tests are powered by Vitest. Tests utilize an in-memory temporary KV store that emulates Cloudflare Workers' actual runtime KV binding.

License

GNU AGPL v3