This is the source for hsal.es, my CV and portfolio. The page is drawn as a set of technical drawing sheets lying on a cutting mat. Each demo is a stack of sheets you turn by the dog-eared corner. The top sheet runs a working copy of something I built. The sheets behind it show how it works.
Most demos come from my work at Visrez, where I built a 3D planner for event spaces and tools for venue maps. The rest come from GNU social, my own open source tools, or this site.
| Demo | From | What it shows | |
|---|---|---|---|
| A | Space builder | Visrez | Draw a rectangle on a 3D floor and it fills with chairs. Sliders set spacing, aisles and seat count |
| B | Marker editor | Visrez | A pin editor for venue maps. Shape, border, fill and decoration are separate parts |
| C | Drag and drop | Visrez | Drag an object off the catalogue and it lands in the 3D scene where you drop it |
| D | Font picker | Visrez | A font list built from document.fonts, with nothing hardcoded |
| E | Loading logo | Visrez | The animated Visrez logo, and the steps that turned an Illustrator export into one SVG path |
| F | Theme picker | This site | The control that switches between the four themes, and how its wipe is drawn |
| G | Object variants | Visrez | One catalogue card covers a whole family of finishes and sizes |
| H | Tagging tool | Visrez | One input tags a base object and every variant under it |
| I | Paper stack | This site | How the sheet stacks on this page fold and turn, and what they become without JavaScript |
| J | Event bus | GNU social | How plugins claim events, and what happens when you switch one off |
| K | Fediverse playground | My own tool | A CLI that runs a small federated network on one machine from one YAML file |
| L | Library search | Visrez | One search box over every property of a library object, scored by MariaDB |
| M | Synthetic properties | Visrez | A size stored once and found by a search for 5ft3in or 1.6m |
| N | Schema driver | GNU social | A Doctrine driver that turns one PHP array per table into the ORM mapping and the schema |
| O | web-ts-mode | My own tool | An Emacs major mode for Astro and Vue files, with one tree-sitter parser per language |
The originals were written in Vue, React, Rails, PHP and Emacs Lisp. The copies here run in
the browser on Astro, React, Vue and TypeScript. Each demo has its own folder under
src/components/.
The site is static. Astro renders the page to HTML at build time and Cloudflare serves the built files from its asset store. The demos are islands that load their script when you scroll to them. Without JavaScript the page still reads from top to bottom, and each stack of sheets becomes a row you scroll sideways.
A small Cloudflare Worker sits beside the files and only runs for two paths. One collects the page's analytics events. The other is a proxy that lets the font picker load fonts from other sites, with a daily byte limit.
The demos use React, Vue, Three.js, Leaflet and Redux. Styles are Sass. The fonts are
self-hosted: Poppins, Special Elite, Allerta Stencil and Permanent Marker. Icons come from
Lucide through astro-icon and from Font Awesome. The skills section draws its own SVG icons
from src/icons/.
There are four themes: Light, Dark, Arctic and Forest. The page follows your system's light or dark setting until you pick one.
Printing the page gives a paper CV. The print stylesheet drops the desk, the theme picker and the demos. It keeps the title block, the career, the bill of materials and the open source contributions, in the light theme.
You need Node 22 or later. With Nix, nix develop opens a shell with Node and installs the
dependencies, and the .envrc lets direnv do the same when you enter the folder. Without Nix,
run npm install.
npm run devstarts the dev servernpm run buildbuilds the site intodist/npm run previewserves the last build
The dev and preview servers detach from the terminal and keep running. Stop them with
npx astro dev stop and npx astro preview stop.
npm run checktype-checkssrc/and the Playwright specs withastro checknpm run lint:cssruns stylelint over the stylesnpm run test:e2ebuilds the site, serves it on port 4310 and runs the Playwright suite ine2e/npm run test:auditchecks the built site's HTML and CSS, its accessibility in all four themes, and its Lighthouse scores. docs/AUDITS.md explains each check
The suite drives the Chrome or Chromium on your PATH, not a browser Playwright downloads. A
few specs load the page without JavaScript in Firefox. They run when Firefox is on your PATH
or after npx playwright install firefox, and the suite warns when it skips them.
npm run deploy type-checks, builds, runs the Playwright suite against that build, then runs
wrangler deploy. It stops at the first step that fails.
The deploy goes to my Cloudflare account. To host a copy, point wrangler.jsonc at a worker
of your own.
src/pages/index.astrois the whole site. It is one pagesrc/components/holds the demos, the sheet stacks and the drawing partssrc/scss/holds the shared styles.src/themes.tsdefines the themessrc/worker.tsis the Cloudflare Worker.src/server/holds the analytics and font proxy code it runse2e/holds the Playwright specs, andaudit/the auditsscripts/holds one-off generators for committed assets, such as the map and the link preview image- TODO.md lists what is done and what is left
- docs/DEAD-ENDS.md lists approaches I tried and dropped, with the numbers
Email me at contact@hsal.es. I'm someonewithpc on GitHub, Codeberg and LinkedIn.
The page keeps some non-identifying analytics: which sections and demos get used, and for how long, with no cookies and nothing that names you