1What FoxPlug reads from Cloudflare
These are the exact things it reads, and nothing else.
| What | The details it takes |
|---|---|
| Pages projects | up to 20 listed, first 10 read: name, created time, latest deployment (id, stage status success or failure, end time, deployment URL, commit message first line), custom domains other than pages.dev |
| Workers scripts | first 10: script name, created time, last modified time |
| Your account ID | the 32-character Account ID typed by the owner, checked to be 32 letters and numbers before any call |
2Moments it finds, and what each becomes
A moment is one thing that happened in Cloudflare worth a second look. Each one is scored, then it becomes a post, a changelog entry, a thing to fix or an idea to email, or it is skipped.
A Pages deployment succeeds
The moment is titled like this: Deployed acme-site
The latest deployment of your Pages project acme-site finished with success. FoxPlug makes 'Deployed acme-site' with 'Shipped acme-site on Cloudflare - ' and the first line of the commit message, if there is one. Only the latest deployment of each project is looked at.
The latest Pages deployment fails
The moment is titled like this: Your acme-site deploy is failing on Cloudflare. Fix this first.
The latest Pages deployment ended with a failure stage in the last 7 days, so the first card in Today names acme-site, how many failed in a row (from the one deployment seen, that is 1) and the commit message. A later successful deployment clears it.
A Worker script is modified
The moment is titled like this: Deployed my-api
A Worker called my-api has a modified time newer than your last check. FoxPlug treats that as a deploy and makes 'Deployed my-api' with 'Shipped my-api on Cloudflare.' Workers are never counted as failing.
A new Pages project or Worker appears
The moment is titled like this: Launched a new Pages: acme-site | Launched a new Worker: my-api
A project or script created in the last 14 days becomes 'Launched a new Pages: acme-site' or 'Launched a new Worker: my-api'. A custom domain on a Pages project less than 30 days old becomes 'Added the domain acme.dev'.
3How the brain uses it
The rules below are the ones that apply to Cloudflare. The same rules, with worked examples, are on the brain page.
- A service whose newest finished deploy failed in the last 7 days becomes the fix line; a later good deploy clears it. How the brain decides
- A clean deploy becomes an update, like Vercel and Netlify deploys. How the brain decides
- A new service or project made in the last 14 days can be a post, and so can its domain while it is new. How the brain decides
- Environment variables, logs and DNS are never read. How the brain decides
4Set up Cloudflare in a few steps
Access: API token plus Account ID. What to give it: API token: Pages read and Workers Scripts read.
- In Cloudflare, open My Profile, then API Tokens, press Create Token, then Create Custom Token.
- Name it FoxPlug. Under Permissions add Account, Cloudflare Pages, Read and Account, Workers Scripts, Read. Add nothing else.
- Under Account Resources pick your account, create the token, copy it (Cloudflare shows it once) and paste it into FoxPlug.
- Open Workers & Pages in Cloudflare, copy the Account ID from the right-hand side and paste it into the Account ID box.
5Limits worth knowing
Where it stops, so nothing surprises you.
- First 10 Pages projects (of 20 listed) and first 10 Workers scripts.
- Only the latest Pages deployment per project is read, so a run of failures counts as 1.
- A Worker modification is treated as a successful deploy; Workers cannot show as failing.
- A failed Workers list is logged and skipped; Pages still read.
- A malformed or wrong token answers 400 from Cloudflare and is reported to you as a refused token.
- First read keeps only the single newest moment.
6What it never reads
Read only means read only, and the list below is what the code leaves alone.
- Environment variables, logs and DNS records
- Analytics (Cloudflare Web Analytics is a separate provider with its own token)
- Anything beyond Pages read and Workers Scripts read
7Questions
Where do I find my Cloudflare Account ID?
On the Workers & Pages overview page, on the right-hand side. It is 32 letters and numbers; anything else is refused before FoxPlug calls Cloudflare.
Does this read my Cloudflare analytics or DNS?
No. It reads Pages projects, their latest deployment and Workers script names. Cloudflare Web Analytics is a separate connection.
What permissions does the token need?
Account, Cloudflare Pages, Read and Account, Workers Scripts, Read. The steps say to add nothing else.
Does FoxPlug tell me about a failing Pages deploy?
Yes, after you press Check for what's new. A failed latest deployment from the last 7 days becomes the first card in your Today brief.
FoxPlug reads this tool only when you press Check for what's new, and only to read. Plans and limits are on the pricing page. Questions: support.