A Vencord backend/cloud/API running on Cloudflare Workers with Workers KV or Durable Objects.
The official implementation uses monolithic Go and Redis.
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.
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.
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 | ~41.3 kB |
dist/worker.kv.js |
✅ | ❌ | Default | ~40.7 kB |
dist/worker.do.js |
❌ | ✅ | Default | ~41.3 kB |
dist/worker.tiny.js |
✅ | ✅ | Tiny | ~33.4 kB |
dist/worker.kv.tiny.js |
✅ | ❌ | Tiny | ~32.8 kB |
dist/worker.do.tiny.js |
❌ | ✅ | Tiny | ~33.4 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.
Tests are powered by Vitest. Tests utilize an in-memory temporary KV store that emulates Cloudflare Workers' actual runtime KV binding.
GNU AGPL v3