Skip to content

shaneafsar/wordlescorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

252 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wordlescorer

Intro

A Wordle scoring bot that runs on Mastodon and Bluesky. Mention the bot with your Wordle results and it replies with a calculated score. The more characters that are solved earlier in the puzzle, the more points you get!

Supported Platforms

Features

  • Mention @scoremywordle on Mastodon or Bluesky with your Wordle output and get a response with your score
  • Supports reading the default square emoji Wordle output (including the high contrast version)
  • Supports reading wa11y.co alt text on Wordle images if there's no default square emoji output
  • Posts the top Wordler of the day ranked by score, row solved, then post time
  • Posts top global stats for the day using the two most popular Wordle numbers
  • Web dashboard with score search

Tech Stack

  • Runtime: Cloudflare Workers (bot) + Cloudflare Pages (web)
  • Language: TypeScript
  • Database: Cloudflare D1 (SQLite)
  • Web: Astro
  • Monitoring: Sentry

Project Structure

cloudflare/
  worker/   — Cloudflare Worker (bot logic, API, cron)
  web/      — Cloudflare Pages (Astro web dashboard)

Each subproject has its own package.json and is deployed independently.

Setup

Prerequisites

  • Node.js 18+
  • Wrangler CLI
  • Cloudflare account with D1 database

Worker Development

cd cloudflare/worker
npm install
npm run dev        # Local dev server
npm run deploy     # Deploy to Cloudflare

Web Development

cd cloudflare/web
npm install
npm run dev        # Local dev server
npm run build      # Build for production

Environment Variables

Set these as secrets in the Cloudflare dashboard:

Variable Description
MASTO_URI Mastodon instance URL
MASTO_ACCESS_TOKEN Mastodon bot access token
BSKY_USERNAME Bluesky bot username
BSKY_PASSWORD Bluesky bot app password
BOT_SECRET Bearer token for bot API endpoints
SENTRY_DSN Sentry DSN for error monitoring

Special thanks

About

A bot that scores wordles across different social sites.

Topics

Resources

Stars

Watchers

Forks

Contributors