Yet Another Flags 🇺🇦

Minimalistic web extension that shows country flag for the current tab domain. Available for Chrome and Firefox.

Extension uses free MaxMind City DB for geo location, and Google DoH for localized DNS resolution.

Take a look at server code as well.

Prerequisites

Requires node@26, yarn@1.22 and jake. Specs run in the installed Chrome, headless.

npm -g install yarn jake [prettier]
yarn install

Why not npm?

Because of the lock file size — yarn.lock is three times smaller. See 037b18f 🐈

I don't want global jake

No problem, yarn jake runs the local one 🐈

Development

# development build: un-minified, points to http://localhost:8080
jake [firefox]

# production build: minified, points to https://geoip.furman.im
jake release[:firefox]

yarn tsc # typecheck
yarn lint # oxlint and prettier
yarn test # specs, `yarn test:watch` to keep them running
yarn coverage # specs with coverage
yarn report # compile html report and open it in the default browser

Run development build

• open chrome://extensions/, turn on "Developer mode"
• click "Load unpacked"
• navigate to ./pkg and pick manifest.json

Don't forget to reload the extension in the browser when rebuilding.

SublimeText build system

SublimeText users get the benefit of ready-made build tasks (requires Terminus).

Open extension.sublime-project as a Project and press Cmd+Shift+B.

tc 🦜, lint 🕵 and test 🧪 tasks have navigable output.

Release

1. bump version in package.json
2. add CHANGELOG.md entry

3. git commit -am "Bump"
   
   yarn release
   # - upload pkg to webstore, submit draft for review
   
   yarn release:firefox
   # - upload pkg and pkg-src to AMO
   
   yarn release:tag