The Fleet SysOps Manifesto, for the one human running a fleet of coding agents (fleet coding, if you want a name for it), and the documents that follow it, served as nothing but Markdown.
Every page on the site is a .md file in the root of this repository. There is no HTML, no JavaScript, no build. server.ts hands the files out as text and that is the whole site.
/isindex.md./manifestoand/manifesto.mdare bothmanifesto.md. A missing page is404.mdwith a 404 status.- A browser (anything that sends
Accept: text/html) gets the verbatim source in a<pre>, with Markdown links and bare URLs made clickable, because plain text in a browser has no links. Nothing is rendered. Everything else gets rawtext/markdown. /<page>.htmlredirects to the readm3.com render of that page.- Every response carries
Access-Control-Allow-Origin: *, so a reader on any origin can fetch a page. That is what the html link at the bottom of each page relies on: it hands the file to readm3.com, which renders it in the browser. - Only
.mdfiles are served. Dotfiles, the server, this README's neighbours in.github: none of it is reachable. www.redirects to the apex.
-
Create
name.mdin the repository root (or in a folder;docs/name.mdis served at/docs/name.md). -
End it with the footer line every page carries, pointing at its own URL:
[html](https://readm3.com/viewer?url=https://fleetsysops.com/name.md) · [source](https://github.com/profullstack/fleetsysops.com/blob/main/name.md) · [home](https://fleetsysops.com/) -
Link it from
index.md. -
Push to
main. Railway builds the Dockerfile and deploys within a minute.
bun test checks that every page ends with its own html link and contains no em dash, along with the server's behaviour.
bun server.ts # http://localhost:3000
bun test
PORT and SITE_URL (default https://fleetsysops.com) are the only settings.
curl https://fleetsysops.com/manifesto.md
curl -s https://fleetsysops.com/manifesto.md | npx @profullstack/readm3 --print
MIT for the code. The documents are ours; quote them, fork them, send a pull request.