A brand-new Windows machine, a fresh terminal, npm -v, and this happens:
'npm' is not recognized as an internal or external command,
operable program or batch file.
Your command is fine. The machine is fine. Windows simply does not ship with Node.js, npm or Git.
This post starts from why the command fails and ends with a verified environment. No prior knowledge assumed.
This site is Docusaurus on Cloudflare Pages. Deploying it is not the hard part. The hard part is everything after: caching, response headers, 404s, bilingual sitemaps, absolute paths leaking into the bundle, and the two or three Cloudflare edge features that fight with your framework.
This post walks the whole path, and ends with a checklist you can run through line by line.
← swipe horizontally to see the full diagram →
The build runs on Cloudflare's machines. You need neither a server nor an upload of build/.
With seventeen posts, two default pagination spots started to feel thin:
The symptom: on a phone, open “Start here” from the homepage, then tap the hamburger — the menu shows only the docs navigation. Blog and Tools are gone.
I assumed my own changes had broken the navbar. Reading the framework source showed otherwise: this is Docusaurus’s design.
The interesting question about adding security badges is not which one looks best, but whether to use a third-party “seal” or build your own.
I chose the latter, and the reason is verifiability.
Before shipping the new tools I ran a mobile pass. Eight of nine pages showed zero overflow; the datapack generator was 80px too wide at 320px.
The annoying part: you cannot see this on a desktop browser.
The obvious doubt about a browser-based PDF tool is whether it can work without uploading anything.
It can. PDF is a structured container format; pages can be copied into a new document without ever rendering them. But a few limits need stating up front, or users hit a wall exactly when it matters.
When I started the pixel-art tool, the first idea was "just add a mosaic filter".
That does not work. A mosaic enlarges pixel blocks while keeping tens of thousands of colours, so you get a low-resolution photo, not pixel art. Real pixel art has two hard constraints: how many cells, and how many colours.
An SVG exported from a design tool comes in two sizes: the picture you see, and the file that actually exists.
An 800-byte icon can spend more than 500 bytes on metadata nobody asked for. But cleaning it up requires knowing which bytes are junk and which are load-bearing.
Two of the new tools have to produce files from nothing: one packs PNGs into a .ico, the other packs text into a .zip.
The usual move is to install a library for each. But both formats are less complicated than their reputation suggests.
A QR tool looks like the simplest thing: type text, draw black and white squares. Building it, I hit one pitfall choosing a library and another handling Chinese text.
The site is deployed on Cloudflare Pages, and the build command is just npm run build. The longer I use it, the clearer it is that static hosting is not "upload and forget" — a few details directly affect the result.