{"id":17696316,"url":"https://github.com/erisa/colour-me","last_synced_at":"2025-05-13T01:04:13.500Z","repository":{"id":41494024,"uuid":"473621306","full_name":"Erisa/colour-me","owner":"Erisa","description":"Colour me! is a simple Discord bot running on Cloudflare Workers that allows server admins to give users the ability to change the colour of their own assigned colour roles!","archived":false,"fork":false,"pushed_at":"2025-02-15T03:20:43.000Z","size":542,"stargazers_count":19,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T01:02:17.002Z","etag":null,"topics":["cloudflare-workers","discord","discord-bot","serverless","slash-commands","slash-create","workers","workers-kv"],"latest_commit_sha":null,"homepage":"https://discord.bots.gg/bots/702660517617205248","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Erisa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Erisa"}},"created_at":"2022-03-24T13:37:08.000Z","updated_at":"2025-04-15T15:12:48.000Z","dependencies_parsed_at":"2023-01-29T18:16:12.789Z","dependency_job_id":"d8be795a-4eae-4c34-ada2-ece78d70facc","html_url":"https://github.com/Erisa/colour-me","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"Snazzah/slash-create-worker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fcolour-me","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fcolour-me/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fcolour-me/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fcolour-me/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Erisa","download_url":"https://codeload.github.com/Erisa/colour-me/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253850874,"owners_count":21973672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudflare-workers","discord","discord-bot","serverless","slash-commands","slash-create","workers","workers-kv"],"created_at":"2024-10-24T14:43:54.864Z","updated_at":"2025-05-13T01:04:13.457Z","avatar_url":"https://github.com/Erisa.png","language":"TypeScript","funding_links":["https://github.com/sponsors/Erisa"],"categories":[],"sub_categories":[],"readme":"# Colour me!\n\n[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/Erisa/colour-me)\n\n\nColour me! is a simple Discord bot that allows server admins to give users the ability to change the colour of their own assigned colour roles!\n\nColour me! runs entirely on the Cloudflare Workers serverless platform.\n\n## Invite\n\n[Click here to add the bot to your Discord server](https://discord.com/api/oauth2/authorize?client_id=702660517617205248\u0026permissions=268435456\u0026scope=bot%20applications.commands).\n\n## Usage\n\n### Server admin commands\n\n`/colour-role add \u003crole\u003e`:\nAdd a role to the list of roles that are allowed to change their own colour!\n\n`/colour-role remove \u003crole\u003e`:\nRemove a role previously added to the list of allowed roles!\n\n`/colour-role list`:\nSee the current list of roles!\n\nAll of these require the `Manage Roles` permission.\nMake sure the role you're adding already has a colour before you add it!\n\n### User commands\n\n`/colour-me random`:\nChange your role colour to a random colour!!\n\n`/colour-me colour \u003chexcode\u003e`:\nChange your role colour to a specific hex code!\n\n`/about`:\nThat's this, you're reading it!\n\n## Planned features\n\nIn the near future it is planned to have functionality to allow admins and optionally users to create their own coloured roles automatically.\n\n## Links\n\n- Privacy Policy: TBD\n- Support: https://discord.gg/5eTcNpqPph\n- Add the bot to your server: [Click here](https://discord.com/api/oauth2/authorize?client_id=702660517617205248\u0026permissions=268435456\u0026scope=bot%20applications.commands)\n\nMade with 💝 by [Erisa](https://erisa.uk) and the help of her wonderful friends.\n\n# Template README follows, for development\n\n---\n\n# /create with Cloudflare Workers\n\nA [slash-create](https://npm.im/slash-create) template, using [Cloudflare Workers](https://workers.cloudflare.com).\n\n[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/Snazzah/slash-create-worker)\n\n## Getting Started\n### Cloning the repo\nYou can either use degit to locally clone this repo without git, or [create a new repo from this template](https://github.com/Snazzah/slash-create-worker/generate) and clone that.\n```sh\nnpx degit Snazzah/slash-create-worker\n```\n\nAfter that, make sure to install dependencies using npm or yarn:\n```sh\nnpm install\n# yarn\n```\n### Installing and setting up Wrangler\n\u003e Make sure to [sign up for a Cloudflare Workers account](https://dash.cloudflare.com/sign-up/workers) in a browser before continuing.\nInstall wrangler with npm or yarn:\n```sh\nnpm install -D wrangler@latest\n# yarn global add wrangler@latest\n```\nRead more about [installing wrangler](https://developers.cloudflare.com/workers/cli-wrangler/install-update).\n\nAfterwards, run `wrangler login` to login to your Cloudflare account with OAuth:\n```sh\nwrangler login\n```\n\nCopy `wrangler.example.toml` into `wrangler.toml`. Make sure to fill in your account ID in the config and update the name of the worker. You can find your account ID [here](https://dash.cloudflare.com/?to=/:account/workers) towards the right side.\n\n### Filling in secrets\nYou can enter in environment secrets with `wrangler secret put`, here are the keys that are required to run this:\n```sh\nnpx wrangler secret put DISCORD_APP_ID\nnpx wrangler secret put DISCORD_PUBLIC_KEY\nnpx wrangler secret put DISCORD_BOT_TOKEN\n```\n\n### Development\nTo run this locally, copy `.env.example` to `.dev.vars` and fill in the variables, then you can run `npm run dev` (or `yarn dev`) to start a local dev environment and use something like ngrok to tunnel it to a URL.\n\nTo sync commands in the development environment, copy `.env.example` to `development.env` and fill in the variables, then run `npm run sync:dev` (or `yarn sync:dev`).\n\n\u003e Note: When you create a command, make sure to include it in the array of commands in `./src/commands/index.ts`.\n\n### Production\nTo sync to production, copy `.env.example` to `.env` and fill in the variables, then run `npm run sync`. To publish code to a worker, run `npm run deploy`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferisa%2Fcolour-me","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferisa%2Fcolour-me","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferisa%2Fcolour-me/lists"}