Site: the user guide (phase 2): the basics, one page per App, Settings and Updates

Eleven pages under /guide/, written from the README, the milestone documents and the Apps' own source: the keys, the Launcher, the Status Bar and the first start; the LoRa Scanner, GNSS, Gemini, IRC, Wi-Fi tools, Notes, Storage and System; Settings (with Wi-Fi) and Updates. Real screenshots where the site has them, a Guide link in the navigation, and the home page points to it. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
Merge pull request 'Site: security.txt, robots.txt, favicon fallbacks' (#62 ) from site-security-txt into main
2026-10-06 20:38:40 +02:00 · 2026-10-06 18:16:48 +00:00 · 2026-10-06 20:12:54 +02:00 · 2026-10-06 16:33:07 +00:00 · 2026-10-06 18:31:57 +02:00 · 2026-10-06 18:20:18 +02:00
71 changed files with 3698 additions and 0 deletions
@@ -14,7 +14,11 @@ on:
  push:
    branches: [main]  # other branches are tested by their pull request: one run, not two
    tags: ['v*']
+    # A change that touches nothing but the site and the documents it is built from runs the Site
+    # workflow only (a tag always runs this one: Gitea doesn't apply path filters to tags).
+    paths-ignore: ['site/**', 'docs/**', 'README.md', 'CONTEXT.md']
  pull_request:
+    paths-ignore: ['site/**', 'docs/**', 'README.md', 'CONTEXT.md']
  workflow_dispatch:
    inputs:
      tag:
@@ -0,0 +1,49 @@
+# The project site (docs/milestones/W1.md): built with Zola to see that it builds and that its pages
+# are sound. Publishing is the maintainer's: the web server pulls main and runs `zola build`.
+#
+# It runs when the site, or a document the site is built from, changes (a pull request, or a push to
+# main); the firmware workflow (ci.yml) skips a change that touches only these files. A change that
+# touches both runs both.
+name: Site
+on:
+  push:
+    branches: [main]
+    paths: ['site/**', 'docs/**', 'README.md', 'CONTEXT.md', '.gitea/workflows/site.yml']
+  pull_request:
+    paths: ['site/**', 'docs/**', 'README.md', 'CONTEXT.md', '.gitea/workflows/site.yml']
+
+jobs:
+  build:
+    runs-on: ubuntu
+    # A pull request from a fork would run someone else's code on our runner: not without us.
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+    container:
+      image: python:3.12-slim
+    steps:
+      - name: Tools
+        run: |
+          apt-get update -qq
+          apt-get install -y -qq --no-install-recommends git ca-certificates curl >/dev/null
+          # Zola, pinned by its checksum.
+          curl -fsSL -o /tmp/zola.tgz https://github.com/getzola/zola/releases/download/v0.22.0/zola-v0.22.0-x86_64-unknown-linux-gnu.tar.gz
+          echo "f1d491f8956b94384c27d75cb6b2bf60d3916d1ade9564bcbfe7c03f0258aebf  /tmp/zola.tgz" | sha256sum -c -
+          tar xzf /tmp/zola.tgz -C /usr/local/bin zola
+          zola --version
+
+      - name: Check out
+        run: |
+          find . -mindepth 1 -maxdepth 1 -exec rm -rf {} +
+          git config --global --add safe.directory '*'
+          git init -q .
+          git remote add origin "${{ github.server_url }}/${{ github.repository }}.git"
+          git fetch -q origin '+refs/heads/*:refs/remotes/origin/*' '+refs/pull/*/head:refs/remotes/pull/*'
+          git checkout -q --detach "${{ github.sha }}"
+
+      - name: Build the site
+        run: |
+          cd site
+          zola check --skip-external-links
+          zola build --output-dir /tmp/site-out
+
+      - name: Check the pages
+        run: python3 site/tools/check_site.py /tmp/site-out
@@ -9,3 +9,6 @@
 .dummy/
 managed_components/
 sdkconfig.*
+
+# The built site (site/config.toml sends it here)
+/public/
@@ -37,6 +37,10 @@ CI signs with the project's key, held as a repository secret (ADR 0008). Debug B

 `scripts/ota_verify.py <file.ota>` checks an Update File on a PC the way a device does. `scripts/release_build.sh` and `scripts/release_publish.py` are what the workflow runs; they work the same by hand.

+## The website
+
+The project's site, **roro9stack.net**, is built from `site/` with Zola (see `site/README.md`): the home page, an Install page that flashes a Cardputer from the browser, and every release. Changes under `site/`, `docs/`, `README.md` and `CONTEXT.md` run only the site's CI job, not the firmware tests and builds.
+
 ## Flash

 1. Connect the Cardputer by USB-C.
@@ -0,0 +1,100 @@
+# W1: Website
+
+**Status:** phase 1 (home, Install, Downloads) is live at roro9stack.net; phase 2 (the user guide) is built, in a pull request. Issue #12.
+
+**Goal:** a public home for the project at **roro9stack.net**, separate from the blog (stories) and from Gitea (developers): what it is, how to install it, how to use each App, and the docs.
+
+The home page was designed on a canvas in a Claude chat (a dark and a light theme, built on the device's own 256-colour palette, pixel-notched corners, DM Mono and Hanken Grotesk). It is the starting point, not the final copy: it has to say only what the firmware does today.
+
+## What was found while planning (2026-10-06)
+
+- `roro9stack.net` already points at the server that hosts Gitea. Plain HTTP redirects to HTTPS; HTTPS has no certificate yet, which is the server's side to set up.
+- **Release downloads from Gitea carry no CORS header,** so a browser can't fetch the factory image from another origin as things are. Gitea is behind Caddy, which can add the header (below).
+- Zola can read JSON from a URL at build time (`load_data`), so the home page's "latest version" can come from the Gitea API.
+- There is no Gitea wiki: the design's "Wiki" links would 404.
+- The blog is published by pulling its repository on the web server and running `zola build`. The site does the same.
+
+## Decisions (design round 2026-10-06)
+
+| # | Decision |
+|---|---|
+| Q175 | The site lives in this repository, in `site/`, so the documentation is built from `docs/`, `CONTEXT.md` and the README instead of being copied. |
+| Q176 | **Zola,** like the blog. The design becomes a template, its tokens CSS custom properties. Dark and light follow the visitor's setting, with a visible switch. No JavaScript except the flasher's. |
+| Q177 | Domain: **roro9stack.net.** The blog stays at experiments.twis.la. |
+| Q178 | **Publishing is the blog's way:** the web server pulls `main` and runs `zola build`; that part is the maintainer's. Changes reach `main` through pull requests as everywhere. **CI is split:** a dedicated `site` job builds the site (`zola build`) when `site/`, `docs/`, `README.md` or `CONTEXT.md` change, and the firmware tests and builds skip a change that touches nothing else. A change that touches both runs both. |
+| Q179 | Phases, each its own pull request: **1.** the CI split, the home page, an Install page with the browser flasher, downloads and the changelog. **2.** a user guide page per App. **3.** how-tos and the FAQ. **4.** developer docs generated from the repository. |
+| Q180 | **A browser flasher** (ESP Web Tools), **without copying the firmware.** Caddy, in front of Gitea, adds `Access-Control-Allow-Origin: https://roro9stack.net` (and `Vary: Origin`) to GET and HEAD on `/twisla/roro9stack/releases/download/*` and `/api/v1/repos/twisla/roro9stack/releases*`: both are public already. The Install page asks the API for the latest release in the browser, finds the asset ending `-factory.bin`, and gives ESP Web Tools a manifest built on the spot, so it offers a new release as soon as it exists, with no rebuild. The library is **vendored** into `site/static/` (Apache-2.0), not loaded from a CDN. The file's SHA-256 is shown on the page. Chrome or Edge on a desktop only; other browsers, and visitors without JavaScript, get the `esptool` steps on the same page. |
+| Q181 | Docs for the latest version only. The changelog is the Gitea releases, read at build time. |
+| Q182 | English only. |
+| Q183 | The FAQ starts from real questions: the README, and issues labelled `kind/docs`. |
+| Q184 | Fonts are **self-hosted** (no request to a third party). The hero keeps the design's illustrations, labelled as illustrations, and a section of **real device screenshots** is added. |
+| Q185 | **The site says only what the firmware does today.** Planned features are marked as planned, with their milestone. The mesh messenger is **planned**: the LoRa Scanner listens, nothing is sent. |
+| Q186 | Left out, each with its issue: a Gemini capsule mirror (#57), French (#58), docs per version (#59), search (#60). |
+| Q187 | The site has no version of its own. Contact is **contact@roro9stack.net,** and the issue tracker. |
+
+## The design, reviewed
+
+Kept as designed: the layout, the tokens, the nine App cards (their facts check out against the code: Probation 3 minutes, Safe Mode after 3 crashes, 60 seconds of typing before an update restarts the device).
+
+Changed before it ships:
+
+- **Install, not Download, is the first action.** Downloads are for developers; a visitor wants to try it.
+- **A "what you need" strip:** Cardputer ADV, the Cap LoRa-1262 (only the radio needs it), a microSD card, Wi-Fi. And a plain status line: the version, and what isn't there yet.
+- **The mesh card and the hero** no longer promise sending and reading mesh messages.
+- **The latest version is read from the API,** not typed.
+- **"Wiki" is replaced by Docs.** The updates section gains what v0.11.0 added: the device installs releases from the project's server itself.
+- **An independence line:** not affiliated with or endorsed by M5Stack or Meshtastic.
+- **No cookies, no analytics, no third-party requests,** said on the page (fonts self-hosted).
+- **The keyboard focus ring** is invisible on the notched buttons: `clip-path` clips an outline. Another way to show focus is needed.
+- **The wordmark SVGs** carry an embedded C2PA content-credentials block: stripped from the site's copies.
+
+## Done when (phase 1)
+
+- Pushing a change under `site/` runs the `site` job and not the firmware tests; a firmware change runs the firmware jobs and not the site's.
+- The home page renders in both themes, at phone width, with the keyboard, and says nothing the firmware doesn't do.
+- The latest version on the page is the latest release.
+- The browser flasher installs the latest release on a Cardputer ADV from Chrome (tried by hand), the page shows the file's SHA-256, and the `esptool` steps are on the same page.
+- A release published after the site was built is the one the Install page offers.
+- The home and Downloads pages make no request to another origin, and the Install page only asks git.twis.la.
+
+## Work breakdown
+
+1. **CI split:** a `site` workflow, path filters on the firmware workflow.
+2. **The skeleton:** `site/` with the tokens, fonts, base template and the theme switch.
+3. **The home page,** from the design, with the changes above.
+4. **Install and downloads:** the flasher with its manifest built in the page, the `esptool` steps, the changelog. Needs the Caddy headers on the Gitea host (the maintainer's side); the page is tested against them once they're in.
+5. **Checks,** recorded here.
+
+## As built (phase 1)
+
+- **CI is split.** `ci.yml` (the firmware) has `paths-ignore: site/**, docs/**, README.md, CONTEXT.md` on pushes to `main` and on pull requests. `site.yml` runs `zola check` and `zola build` with a Zola pinned by its checksum, then `site/tools/check_site.py`, when those files change. Gitea's own source (v1.24, read, not run against the 1.27 server) shows that path filters count as matched for tag pushes, so a tag still releases. A change that touches both runs both.
+- **The build output** goes to `public/` at the root of the repository, not into `site/`: `output_dir = "../public"` in `site/config.toml`, so `zola build` in `site/` and `zola --root site build` from the root agree, and git ignores `/public/`.
+- **The site** is in `site/`: `config.toml`, templates (base, home, install, downloads, 404), `data/` for the App cards and the screenshots' captions, `static/` (stylesheet, theme switch, fonts, wordmark, icons, real screenshots, the vendored flasher). `site/README.md` says how to build it and what the server needs.
+- **The home page** follows the design. Changed from it: the hero and the mesh card promise nothing that isn't built (the mesh messenger is a "planned" card), an Install button first, a status box, a "what you need" row, a section of real screenshots, the updates section says the device installs releases itself, an independence line and a statement about cookies and third-party requests in the footer, the latest version read from the Gitea API at build time, and the nav's Wiki replaced. The two hero drawings are generated by `site/tools/make_illustrations.py` (a port of the design's scripted shapes) as inline SVG.
+- **The focus ring.** `clip-path` clips outlines, so a focused notched control drops its notches and shows square corners and its ring.
+- **The Install page** asks the API for the latest release in the browser, builds the ESP Web Tools manifest as a blob, shows the version, size and SHA-256, and only ever hands the flasher a download from the project's own server for this repository. The flasher library (ESP Web Tools 10.4.0, Apache-2.0) is vendored, trimmed to the ESP32-S3. Fonts (DM Mono, Hanken Grotesk, SIL OFL) are self-hosted.
+- **The Downloads page** lists the last 30 releases with their files, read at build time.
+- **The wordmark SVGs** from the design carried an embedded C2PA content-credentials block; it is removed from the site's copies.
+
+## As built (phase 2, the user guide)
+
+- **`/guide/`** is a section of 11 pages, `site/content/guide/`, each with `template` from the section's `page_template` and an order from `weight`: the basics (keys, Launcher, Status Bar, first start, the card), then one page per App (LoRa Scanner, GNSS, Gemini, IRC, Wi-Fi tools, Notes, Storage, System), Settings and Updates. Pages with real screenshots list them in `extra.screens`, looked up in `data/screens.toml`.
+- **Facts come from the README, the milestone documents and the Apps' own source** (key handlers, labels, the Status Bar's drawing code), not from memory. Some wording was corrected against the source while writing: the Track folder is `/gnss/tracks`, the reasons a Track won't start, what the Status Bar shows.
+- **Not covered:** the mesh messenger (planned), the debug console and Debug Builds beyond a pointer to the README. How-tos and the FAQ are phase 3.
+
+## Checks (2026-10-06)
+
+| Check | Result |
+|---|---|
+| The Site workflow's own commands, in a clean container with the pinned Zola | `zola check` clean, build and page checks pass |
+| `tools/check_site.py` | 4 pages, 0 problems: titles, descriptions, a language, every image with alt text, every local file referenced exists, nothing loaded from another origin |
+| Browser tests (Chromium, 16 checks) | All pass: no request to another origin from the home, Downloads and 404 pages; no horizontal scroll at 1280 and 390 px; a visible focus ring on a notched button; the Install page reads the latest release, shows its version, size and SHA-256, builds a blob manifest naming an ESP32-S3 factory image at offset 0, and loads only git.twis.la; a download on another host is refused; the real server (no CORS header today) makes the page fall back to the esptool steps |
+| The pages looked at | Home in dark and light, at desktop and phone width; Install; Downloads |
+| `esptool` against the real v0.11.0 factory image | An ESP32-S3 image, bootloader at 0x0, partition table at 0x8000: flashing at offset 0 is right. The command's syntax was checked, not a flash |
+
+**Not checked:**
+- **Flashing a real Cardputer from Chrome.** It needs the device on a machine with a browser; the page's flasher logic is tested, the flashing itself isn't.
+- **Caddy's headers** on the real server (not applied yet), and **HTTPS on roro9stack.net** (the name resolves, the certificate isn't there).
+- **The CI split on a change that touches only `site/` or `docs/`.** This pull request touches both the workflows and the site, so it runs both; the first docs-only pull request will show it.
+- Firefox and Safari rendering, screen readers, and a printed page.
+- The unverified wording in the Install text is kept to what's known: nothing about how long flashing takes, or what the screen shows in download mode.
@@ -0,0 +1,45 @@
+# The roro9stack site
+
+Source of https://roro9stack.net (docs/milestones/W1.md): a [Zola](https://www.getzola.org/) site. The home page, an Install page with a browser flasher, and the list of releases so far; the user guide, how-tos, FAQ and developer docs come next.
+
+```
+config.toml           base_url, the repository and API addresses
+content/              the pages (Markdown, with their template named in the front matter)
+templates/            base, home, install, downloads, 404; illustrations/ is generated
+data/                 the App cards and the screenshots' captions
+static/               css, js, fonts (self-hosted), img, screens (real screenshots), vendor/esp-web-tools
+tools/                make_illustrations.py, check_site.py
+```
+
+## Build and look
+
+```sh
+docker run --rm -u "$(id -u):$(id -g)" -v "$PWD:/repo" -w /repo/site ghcr.io/getzola/zola:v0.22.0 build   # writes ./public
+docker run --rm -u "$(id -u):$(id -g)" -p 1111:1111 -v "$PWD:/repo" -w /repo/site ghcr.io/getzola/zola:v0.22.0 serve --interface 0.0.0.0
+python3 site/tools/check_site.py public    # what the pages promise, kept
+```
+
+Or `zola build` with a Zola of your own, in `site/` (or `zola --root site build` from the root). **The output goes to `public/` at the root of the repository,** not into `site/`: `output_dir` in `config.toml`, and git ignores that directory. The build reads the latest release and the list of releases from the Gitea API (`load_data`); if the server can't be reached, the pages say so instead of failing.
+
+## Publishing
+
+The web server pulls `main` and runs `zola build`, as for the blog. CI (`.gitea/workflows/site.yml`) builds the site and runs the checks when `site/`, `docs/`, `README.md` or `CONTEXT.md` change; the firmware workflow skips a change that touches only those.
+
+## Things to know
+
+- **The Install page needs Caddy's help.** Gitea's release downloads carry no CORS header, so the page asks the API from the browser only if Caddy, in front of Gitea, allows this origin:
+
+  ```caddy
+  @releases {
+      method GET HEAD
+      path /twisla/roro9stack/releases/download/* /api/v1/repos/twisla/roro9stack/releases*
+  }
+  header @releases Access-Control-Allow-Origin "https://roro9stack.net"
+  header @releases Vary Origin
+  ```
+
+  Without it the page says it can't reach the release server and points to the esptool steps.
+- **No third-party requests.** Fonts and the flasher library are served from here; `tools/check_site.py` fails the build if a page loads anything from another origin.
+- **Illustrations.** `templates/illustrations/*.html` are generated by `tools/make_illustrations.py`; run it again rather than editing them.
+- **Updating the flasher library:** see `static/vendor/esp-web-tools/README.txt`.
+- **Fonts** are DM Mono and Hanken Grotesk, under the SIL Open Font License (the licences are in `static/fonts/`).
@@ -0,0 +1,26 @@
+# roro9stack.net (docs/milestones/W1.md). Build with `zola build`; the web server pulls main and does this.
+base_url = "https://roro9stack.net"
+title = "roro9stack"
+description = "Open firmware for the M5Stack Cardputer ADV with the Cap LoRa-1262: a LoRa scanner, GNSS, a Gemini browser, IRC, Wi-Fi tools, notes and more."
+default_language = "en"
+compile_sass = false
+build_search_index = false
+generate_feeds = false
+# The built site goes to public/ at the root of the repository (git ignores it), whether Zola is run
+# from site/ or from the root with `--root site`.
+output_dir = "../public"
+
+[markdown]
+smart_punctuation = false
+
+[markdown.highlighting]
+# Classes instead of inline colours; Zola 0.22 still wants a theme and writes giallo.css, which the
+# templates don't link.
+style = "class"
+theme = "nord"
+
+[extra]
+repo = "https://git.twis.la/twisla/roro9stack"
+api = "https://git.twis.la/api/v1/repos/twisla/roro9stack"
+blog = "https://experiments.twis.la"
+contact = "contact@roro9stack.net"
@@ -0,0 +1,4 @@
+++
+title = "roro9stack"
+template = "index.html"
+++
@@ -0,0 +1,5 @@
+++
+title = "Downloads"
+description = "Every release of roro9stack: the signed update file, the factory image for USB, and what changed."
+template = "downloads.html"
+++
@@ -0,0 +1,13 @@
+++
+title = "User guide"
+description = "How to use each App on the Cardputer: the keys, what the screens show, and what is written to the SD card."
+template = "guide-index.html"
+sort_by = "weight"
+page_template = "guide-page.html"
+++
+
+This guide says what the firmware does **today** and nothing else. Start with the basics (the keys, the Launcher, the first start), then read the page of any App. It describes the latest release; the numbers and key names come from the firmware's own source.
+
+**The mesh messenger is planned, not built.** The LoRa Scanner listens to Meshtastic traffic and shows it, but the device sends nothing yet: that is the next milestone and waits for a second node to test with.
+
+Something missing or wrong? Write to the [issue tracker](https://git.twis.la/twisla/roro9stack/issues) or to contact@roro9stack.net.
@@ -0,0 +1,63 @@
+++
+title = "The basics"
+description = "The keys, the Launcher, the Status Bar and what happens the first time you switch the device on."
+weight = 1
+[extra]
+tag = "Start here"
+++
+
+## The keys
+
+The Cardputer's keyboard has no arrow keys and no Escape, so the firmware gives a few keys a second job:
+
+| Key | Does |
+|---|---|
+| <kbd>Enter</kbd> | Opens or confirms the selected item |
+| <kbd>`</kbd> | **Back**: one step out of a screen, and out of an App |
+| <kbd>Fn</kbd> + <kbd>`</kbd> | **Home**: back to the Launcher |
+| <kbd>Fn</kbd> + <kbd>;</kbd> <kbd>.</kbd> <kbd>,</kbd> <kbd>/</kbd> | The arrows: up, down, left, right |
+| <kbd>;</kbd> <kbd>.</kbd> <kbd>,</kbd> <kbd>/</kbd> alone | The same arrows, as long as you are **not** typing text |
+| <kbd>Tab</kbd> | Switches view in an App that has more than one |
+| <kbd>Del</kbd> | Deletes backwards when you type |
+| <kbd>opt</kbd> then an accent, then a letter | Types an accented letter: <kbd>opt</kbd> <kbd>'</kbd> <kbd>e</kbd> gives é |
+
+While you type text (a note, an IRC line, a setting), `;` `.` `,` `/` type their own characters and you need <kbd>Fn</kbd> for the arrows. The bottom of the screen shows `opt` while a compose is waiting for its letter.
+
+## The Launcher
+
+The home screen lists the Apps. Move with the arrows, open one with <kbd>Enter</kbd>. Back inside an App returns here.
+
+## The Status Bar
+
+A strip at the top of every screen: the name of the App on the left, and on the right, from the edge inwards:
+
+| Shows | Means |
+|---|---|
+| the time | The clock, once Wi-Fi or a GNSS fix has set it |
+| `[3]` | Unread IRC messages that mention you, or private ones |
+| `97%` | The battery (in the warning colour at 15% and under) |
+| `SD` | A card is in; the warning colour at 80% full |
+| bars and `W` | Wi-Fi connected, with its signal; `W?` is searching; `MON` is the Wi-Fi radio in its monitoring mode, which pauses IRC |
+| `REC` | A GNSS Track is being recorded |
+| `CAP` | A LoRa capture is being recorded |
+| `L` | The radio is listening; it lights up for a moment on each packet. `SW` while a Sweep runs |
+| `G` or `G12` | The GNSS receiver is searching (`G`, dim), has a 2D fix (`G`), or has a 3D fix with that many satellites (`G12`) |
+
+## Toasts
+
+News from a background service (an IRC mention, a Storage warning, an update that is out) shows as a short message over whatever App is open, and can beep and flash the LED. **Sound & LED** in Settings turns that off.
+
+## The first start
+
+On a new device a short Setup asks four things, then never appears again:
+
+1. **Long name**, up to 39 bytes.
+2. **Short name**, up to 4 characters.
+3. **Radio region.** Nothing will transmit until you confirm yours. EU868 is the supported region.
+4. **Timezone.**
+
+## The SD card
+
+Put a microSD card in the Cardputer. Without one the radio, GNSS, Wi-Fi and IRC still work, but nothing can be saved: no notes, IRC logs, Wi-Fi scan logs, GPX tracks, LoRa captures or saved Gemini pages. The [Storage App](/guide/storage/) shows what is on the card.
+
+The firmware keeps its own folders at the top of the card (`captures`, `gemini`, `gnss`, `irc`, `updates`, `wifi`, plus `notes`). You can use the card in a computer too, but those names are the firmware's.
@@ -0,0 +1,42 @@
+++
+title = "Gemini"
+description = "Browse Geminispace: follow links, go back, bookmark pages and keep them on the SD card to read offline."
+weight = 4
+[extra]
+tag = "Gemini"
+screens = ["gemini.png"]
+++
+
+[Gemini](https://geminiprotocol.net/) is a small, text-first protocol: pages are plain **gemtext**, served over an encrypted connection, from **capsules** instead of sites. It needs Wi-Fi.
+
+## Reading
+
+| Key | Does |
+|---|---|
+| <kbd>Tab</kbd> / <kbd>Shift</kbd>+<kbd>Tab</kbd> | Picks the next or previous link |
+| <kbd>Enter</kbd> | Follows the link |
+| <kbd>`</kbd> (Back) | Returns to the previous page, at the place where you scrolled to |
+| Up and down | Scroll a line |
+| <kbd>Space</kbd> | Pages down |
+| <kbd>g</kbd> | Types an address |
+| <kbd>b</kbd> | Bookmarks the page |
+| <kbd>s</kbd> | Saves the page to the card |
+| <kbd>S</kbd> | Saves it with the pages it links to |
+
+Headings, lists, quotes and preformatted blocks are drawn as gemtext intends, wrapped to the screen. Links to other protocols show their address and are not followed. A page that asks for input (a search, say) shows a prompt, and a password prompt hides what you type. Characters outside the Latin fonts show as `?`. The history keeps the last 20 pages.
+
+## The start page
+
+It lists your **bookmarks**, then your **Saved Pages**, then a few starting points: geminiprotocol.net, a search engine and an aggregator. Without a card it shows only the built-in starting points.
+
+## Certificates: trust on first use
+
+Most capsules sign their own certificate. The first certificate seen for a host is **remembered**; if it later changes, the page is not shown and you are asked whether to trust the new one, with both fingerprints on screen. Expired or self-signed certificates are fine: only a *change* counts. Client certificates are not supported.
+
+## Saved Pages
+
+<kbd>s</kbd> keeps the page on the card, with the address it came from and when it was saved, and you can read it with no network. <kbd>S</kbd> also saves the pages it links to on the **same capsule**, as text only, up to 30, in the background. On the start page, Saved Pages are listed by capsule, newest first. Inside one, <kbd>r</kbd> **refreshes** it and <kbd>d</kbd> **deletes** it. A link to another saved page opens the saved copy; any other link fetches online if Wi-Fi is up, or says it is not saved. A file that is not text (a picture, say) is saved to `/gemini/downloads/` instead of being shown. The Storage clean-up never offers Saved Pages for deletion.
+
+## Big pages and memory
+
+With a card, every page streams to the card first, so a page larger than the device's memory still arrives whole and is read from the card as you scroll. Without a card, a page is limited to what fits in memory. If there is not enough free memory to open a secure connection, the fetch says so instead of failing silently; stopping IRC frees the most.
@@ -0,0 +1,30 @@
+++
+title = "GNSS"
+description = "Where you are and which satellites you can see, from the Cap's receiver, with Tracks saved to the SD card as GPX."
+weight = 3
+[extra]
+tag = "GNSS"
+screens = ["sky.png"]
+++
+
+GNSS needs the **Cap LoRa-1262**, an antenna with a view of the sky, and **Settings → GNSS** switched **On**. Otherwise the App says `GNSS is off` (or `paused`, when "Pause GNSS for LoRa" has put the receiver on standby while the radio listens). A first fix outdoors can take a while: the App says how long it has been searching.
+
+## Position
+
+The first view shows the fix (`No Fix`, `2D Fix` or `3D Fix`, and how many satellites it uses), then:
+
+- **Lat** and **Lon**, in decimal degrees or degrees, minutes and seconds (**Settings → Coordinates**);
+- the **Locator**, the Maidenhead grid square;
+- **Altitude**, **Speed** and the direction you are moving;
+- **HDOP**, the horizontal precision: a smaller number is better;
+- the **Time**, in UTC.
+
+Once there is a fix, the device's clock follows it.
+
+## Sky
+
+<kbd>Tab</kbd> switches between Position and **Sky**: a circle with N, E, S and W, where each satellite is a dot, coloured by constellation, and filled when the receiver uses it. A legend counts, for each constellation (GPS, GLONASS, Galileo, BeiDou), the satellites used and in view.
+
+## Tracks
+
+<kbd>r</kbd> starts recording a **Track**: the route is saved as a **GPX** file on the SD card, in `/gnss/tracks` (named by date and time), and the Status Bar shows `REC`. Press <kbd>r</kbd> again to stop. A Track keeps recording with the App closed. It needs a card and a clock (a fix or Wi-Fi sets it); if it cannot start, the App says why: `GNSS is off`, `No SD card` or `Waiting for the time`. The [Storage App](/guide/storage/) opens a `.gpx` file and shows its points, start, duration and distance.
@@ -0,0 +1,51 @@
+++
+title = "IRC"
+description = "Chat on an IRC server from the keyboard, with a connection that outlives the App and daily logs on the SD card."
+weight = 5
+[extra]
+tag = "IRC"
+++
+
+## Connecting
+
+The first time, type `/settings` and press <kbd>Enter</kbd>. The settings page has:
+
+- **Server** and **Port**, and **TLS** (on or off).
+- **Self-signed:** for a server whose certificate no authority signed. It is *pinned on first use*: the first certificate it sees is remembered, and a different one later is refused.
+- **Nick**, **SASL user** and **SASL password**, **NickServ password**: passwords show only as `(set)`.
+- **Auto-join:** the channels to join after connecting.
+- **Save & reconnect.**
+
+Opening the IRC App connects, if Wi-Fi is up. The connection belongs to a **background service**: leaving the App does not disconnect, and new messages keep arriving and being logged. It reconnects by itself after a drop, and does not start by itself after a restart.
+
+## Chatting
+
+You type at the bottom; <kbd>Enter</kbd> sends. A line starting with `/` is a command:
+
+| Command | Does |
+|---|---|
+| `/join #channel [key]` (or `/j`) | Joins; the `#` is optional |
+| `/part [#channel] [message]` | Leaves |
+| `/msg nick text` (or `/query`) | Opens a private chat, sending the text if there is any |
+| `/me text` | An action line |
+| `/nick newnick` | Changes your nick |
+| `/topic [text]` | Shows or sets the channel topic |
+| `/names [#channel]` | Lists who is there |
+| `/quit [message]` | Disconnects and **stays disconnected** until you type something again |
+| `/raw …` (or `/quote`) | Sends a line to the server as it is |
+| `/settings` | The settings page |
+
+Each server, channel and private chat is a **buffer**. <kbd>Tab</kbd> moves to the next one, each shows how many messages are unread, and your own lines are in the accent colour. Scroll back with <kbd>Alt</kbd> + <kbd>;</kbd> (older) and <kbd>Alt</kbd> + <kbd>.</kbd> (newer). The up and down arrows (<kbd>Fn</kbd> + <kbd>;</kbd> and <kbd>.</kbd>) recall lines you sent.
+
+## Mentions and the unread count
+
+A message with your nick in it, or any private message, is a **mention**: it shows a Toast over whatever App is open, and counts in the Status Bar's `[n]`. Other traffic only adds to the buffer's unread count.
+
+## Logs
+
+Every buffer is logged to the SD card, one file per day, under `/irc`. Logs stop when the card passes 90% full, to keep the rest for captures; nothing is deleted without your asking, in the [Storage App](/guide/storage/)'s Maintenance.
+
+## Good to know
+
+- IRC **pauses** while Wi-Fi is monitoring (the Status Bar shows `MON`) and while the device **installs an update**. It reconnects and rejoins its channels afterwards; the App says `paused` in the meantime.
+- A secure connection costs memory: IRC's takes about 40 KB of the 107 KB the device has, and an update's download needs about 52 KB more. That is why IRC steps aside for an update, and why the daily update check waits for IRC to be disconnected (see [Updates](/guide/updates/)).
@@ -0,0 +1,35 @@
+++
+title = "LoRa Scanner"
+description = "Listen to the radio: every packet it hears, a survey of signal strength from 863 to 870 MHz, and captures for Wireshark. It only listens."
+weight = 2
+[extra]
+tag = "LoRa Scanner"
+screens = ["sniffer.png", "sweep.png"]
+++
+
+The Scanner uses the **Cap LoRa-1262**. It **never transmits**: it listens and shows.
+
+## Sniffer
+
+The first view lists what the radio hears, newest first: the time, the RSSI (signal strength, in dBm) and the SNR (signal over noise, in dB). For a **Meshtastic** packet it also shows the sender and the receiver (the last four hex digits of their numbers) and the number of hops.
+
+| Key | Does |
+|---|---|
+| <kbd>Enter</kbd> | The details of a packet: the Meshtastic header, which is never encrypted, and a hex dump |
+| <kbd>p</kbd> | Picks one of the 7 Meshtastic presets allowed in EU868 (LongFast by default) |
+| <kbd>c</kbd> | Starts or stops a **capture** |
+| <kbd>Tab</kbd> | Switches to the Sweep |
+
+The Scanner shows the header and the bytes; it does not decrypt the message itself, which Meshtastic encrypts with the channel's key.
+
+## Capture
+
+A capture records packets into a **pcap** file with LoRaTap headers in `/captures/lora/` on the SD card, to open in Wireshark. It keeps recording with the App closed (the Status Bar shows `CAP`); the radio sleeps when the App is not open and no capture is running. Captures are never deleted unless you ask, in the [Storage App](/guide/storage/), which can also show a pcap's packets on the device.
+
+## Sweep
+
+<kbd>Tab</kbd> switches to the Sweep: the signal strength across **863 to 870 MHz** in 100 kHz steps, drawn as bars with a mark at each peak, and a waterfall under them. The frequency the Sniffer listens on is marked. The Sniffer is paused during a Sweep and picks up where it was. The Status Bar shows `SW`.
+
+## The GNSS receiver raises the noise
+
+The GNSS receiver on the same Cap makes the radio's noise floor about **8 dB** worse while it runs. **Settings → Pause GNSS for LoRa** (off by default) puts the receiver on standby while the radio listens, except while a Track is being recorded.
@@ -0,0 +1,37 @@
+++
+title = "Notes"
+description = "Plain text notes on the SD card, with no save key: the editor saves for you, and a power cut never costs the note."
+weight = 7
+[extra]
+tag = "Notes"
+screens = ["notes.png"]
+++
+
+Notes are plain text files in `/notes` on the SD card. They are ordinary `.txt` files: you can read them on a computer too.
+
+## The list
+
+Each note shows its first line and its date, newest first. <kbd>s</kbd> switches to sorting by file name.
+
+| Key | Does |
+|---|---|
+| <kbd>n</kbd> | Starts a new note |
+| <kbd>Enter</kbd> | Opens the note |
+| <kbd>r</kbd> | Renames its file |
+| <kbd>d</kbd> | Deletes it, after asking |
+
+## The editor
+
+Type. <kbd>Enter</kbd> starts a line and <kbd>Del</kbd> deletes backwards. <kbd>Fn</kbd> with the arrow keys moves the cursor through the wrapped text, <kbd>Ctrl</kbd>+<kbd>A</kbd> and <kbd>Ctrl</kbd>+<kbd>E</kbd> go to the start and the end of the line, <kbd>Tab</kbd> types two spaces, and the compose key gives accents as everywhere.
+
+**There is no save key.** The note is written five seconds after your last key, when you press Back, when you leave the App, when the screen turns off and before the device powers off. The top line says `typing` or `saved`.
+
+Each save writes a temporary file and then puts it in the note's place, so a power cut costs a few seconds of typing and never the note. If a save was cut short, opening the note offers its copy back.
+
+## Names
+
+A new note has no file until you type something. The file is then named after its first line (`shopping-list.txt`), or `note-<date>-<time>.txt` if that line gives no usable name.
+
+## Limits
+
+A note holds up to **16 KB** while it is edited. A bigger text file opens read-only in the [Storage App](/guide/storage/); editing a file of any size is planned. In Storage, <kbd>e</kbd> on a text file opens it in the same editor, anywhere on the card, unless the file is read-only. Notes are never offered for deletion by the clean-up.
@@ -0,0 +1,42 @@
+++
+title = "Settings"
+description = "The device's names, region, screen, sound, GNSS and Wi-Fi, and where firmware updates are found."
+weight = 10
+[extra]
+tag = "Settings"
+++
+
+Move with the arrows. On a toggle, a choice or a slider, left and right change the value; <kbd>Enter</kbd> opens a text field or a list of choices, or a page marked `>`. Back leaves.
+
+| Setting | What it is |
+|---|---|
+| **Long name**, **Short name** | The names you gave in the first-start Setup (up to 39 bytes, and up to 4 characters) |
+| **Region** | The regulatory region; EU868 |
+| **Timezone** | For the clock and the dates in file names |
+| **Brightness** | A slider |
+| **Dim after**, **Screen off after** | Screen timeouts. Dimming must come before the screen turns off |
+| **Sound & LED** | The beep and the flash on a [Toast](/guide/basics/) |
+| **GNSS** | Switches the receiver on and off (see [GNSS](/guide/gnss/)) |
+| **Pause GNSS for LoRa** | Puts the receiver on standby while the radio listens (see [LoRa Scanner](/guide/lora-scanner/)) |
+| **Coordinates** | Decimal degrees, or degrees, minutes and seconds |
+| **Wi-Fi** | The page below |
+| **Check for updates** | Once a day, see [Updates](/guide/updates/) |
+| **Firmware** | The page described in [Updates](/guide/updates/) |
+| **About** | The firmware version, the node number, battery, memory, uptime, clock and licence |
+
+## Wi-Fi
+
+**Wi-Fi** on its own page switches the radio on and off. The page also has:
+
+- **Status:** whether it is searching, joining, or connected, and to what.
+- **Add a network:** scans, lets you pick one, and asks for the password (leave it empty for an open network). **Add a hidden network** asks for the name first.
+- **DNS and NTP:** see below.
+- **Your saved networks.** The device joins one on its own whenever it is in range, the strongest first. <kbd>Enter</kbd> on a network opens its page.
+
+### An address by hand
+
+A network normally gives the device its address by itself (DHCP, **Automatic**). On a network without DHCP, open its page and set **IP address** to **Fixed**: then it takes an **address**, a **prefix** (24 is 255.255.255.0) and an optional **gateway**. Switching to Fixed starts from what the network is giving the device at that moment, and the setting is checked and applied when you leave the page. IPv4 only. **Forget this network** is on the same page.
+
+### DNS and NTP
+
+Two DNS servers (9.9.9.9 and 1.1.1.1 by default), used on Fixed networks, or on every network if **Always use my DNS** is on; and two NTP servers (pool.ntp.org and time.cloudflare.com), used after any that the network's DHCP offers. <kbd>Enter</kbd> on **Status** shows what is in use and where each value came from.
@@ -0,0 +1,47 @@
+++
+title = "Storage"
+description = "Browse the SD card: copy, move, rename and delete with a clipboard, and open a file by its type."
+weight = 8
+[extra]
+tag = "Storage"
+screens = ["storage.png"]
+++
+
+Storage shows what is on the SD card: each folder's entries with their size and date, folders first. <kbd>Enter</kbd> opens a folder, Back goes up, and <kbd>s</kbd> sorts by name, date or size. A folder with more than 256 entries shows the first 256 by name, and says so.
+
+## Working on one item
+
+| Key | Does |
+|---|---|
+| <kbd>c</kbd> / <kbd>x</kbd> | Copies or cuts the selected file or folder; the footer shows what <kbd>v</kbd> would paste |
+| <kbd>v</kbd> | Pastes it into the folder shown. A copy next to its original is named `name (2).txt`; anything in the way is asked about first |
+| <kbd>r</kbd> | Renames |
+| <kbd>d</kbd> | Deletes, after saying what is inside: "Delete saved and its 42 files (1.2 MB)?" |
+| <kbd>n</kbd> | Makes a folder |
+| <kbd>i</kbd> | Details: type, exact size, date, and why an item is read-only if it is |
+
+A copy runs in the background of the card (about 400 KB a second), in short turns, so logs and captures keep being written. It shows its progress, Back cancels it and takes back what was copied, and each file's size is checked afterwards.
+
+## What cannot be changed
+
+- the **top-level folders** the firmware keeps its files in (what is inside them can be);
+- `/gemini/cache`;
+- a file being **written right now**: today's IRC log, a Track or a capture being recorded.
+
+The App says why when it refuses.
+
+## Opening files
+
+<kbd>Enter</kbd> on a file opens it by its type, and <kbd>Tab</kbd> switches the same file to a hex dump or to text:
+
+- **Text** (`.txt`, `.log`, `.gmi`, `.csv`, and anything that looks like text): only a screenful is read from the card, so a file of any size opens at once, and logs open at the end. Up and down move a line, left and right a page, <kbd>t</kbd> and <kbd>b</kbd> go to the top and the end, and <kbd>e</kbd> edits it (up to 16 KB, as in [Notes](/guide/notes/)).
+- **Captures** (`.pcap`): the packets as the [LoRa Scanner](/guide/lora-scanner/) lists them; <kbd>Enter</kbd> shows one with its Meshtastic header and bytes.
+- **Tracks** (`.gpx`): the number of points, the start, the duration and the distance.
+- **Update files** (`.ota`): the version, and whether the file would install: it is checked as an install checks it, signature and contents, without writing anything. <kbd>Enter</kbd> then installs it (see [Updates](/guide/updates/)).
+- **Anything else:** a hex dump.
+
+## Maintenance
+
+At the top of the card, the last row, **Maintenance** (or <kbd>m</kbd>), shows the card's usage and holds **Storage clean-up** and **Erase SD card**. They delete for good, so they sit behind a warning. Clean-up deletes old logs and captures by category and age, showing the space it would free first. Notes and Saved Pages are never offered.
+
+The firmware warns once per start when the card passes **80%** full; past **90%**, logs stop being written so that the rest is kept for captures.
@@ -0,0 +1,20 @@
+++
+title = "System"
+description = "What the device is doing right now: load, tasks, memory, network traffic, battery and temperature. Live, and read-only."
+weight = 9
+[extra]
+tag = "System"
+screens = ["system.png"]
+++
+
+System changes nothing: it shows. It samples once a second and keeps its history only while it is open. <kbd>Tab</kbd> moves between five views.
+
+- **Overview:** each core's load, free memory, network traffic, battery, uptime and chip temperature, and both cores' load over the last two minutes.
+- **Tasks:** every task the system runs, with its core, its share of a core over the last second, and the least stack it ever had left (in the warning colour under 512 bytes). <kbd>s</kbd> sorts by share, stack or name.
+- **Memory:** free memory, the lowest since start, and the largest free block, with two minutes of free memory drawn against the three memory floors (55, 40 and 20 KB).
+- **Network:** the connection, then for IRC, Gemini, the debug console and firmware updates the bytes read and written since start, and what is moving now. For secure connections these are the bytes the service sees, without the encryption overhead.
+- **System:** the firmware version, uptime, the last start reason, memory, Wi-Fi, the battery, the SD card with its write faults, the radio and the GNSS receiver.
+
+## Why it exists
+
+The device has about 107 KB of free memory and no PSRAM, so memory is the resource that decides what can run together: a secure connection takes about 52 KB at its peak. System makes that visible, and is how the project measures its own changes.
@@ -0,0 +1,44 @@
+++
+title = "Updates"
+description = "How the device updates itself from the project's releases, from the SD card or from a PC, and how it protects itself when an update goes wrong."
+weight = 11
+[extra]
+tag = "Firmware"
+screens = ["update.png"]
+++
+
+Every update is one **signed file** (`.ota`). The device installs only a file signed with the project's key, so it cannot be tricked into installing anything else, whichever way the file arrives.
+
+## Settings → Firmware
+
+The page shows the **version** running, its **status**, the address to **push updates to** over Wi-Fi, and:
+
+- **Latest release:** <kbd>Enter</kbd> (or <kbd>c</kbd>) asks the server and says `v0.11.0 (new)` or `(current)`. <kbd>Enter</kbd> again opens the release: its version, date, size and the tag's message, with **Install** when it is newer.
+- **Older releases:** the last ten, newest first. Opening an older one offers to **go back** to it, with a different question.
+- **On the SD card:** the `.ota` files found in `/updates`, ready to install. Copy one there with a computer or the [Storage App](/guide/storage/); the Storage App also opens an `.ota` file and says whether it would install.
+
+An install needs Wi-Fi if it is a download. The new firmware is checked before anything is written (the signature after the first 160 bytes) and again at the end (the image's hash). Then the device restarts. It will **wait up to 60 seconds** if you are typing, so that a restart never eats a note.
+
+## Check for updates
+
+**Settings → Check for updates** is on by default. Once a day, with Wi-Fi up and the clock set, the device looks at the latest release and says `v0.11.0 is out: see Settings > Firmware`, once per version. It installs **nothing** by itself, and it does not announce a version that already failed and rolled back on this device.
+
+## Probation and Rollback
+
+A newly installed firmware runs on **Probation**: it must boot, draw its screen, start its services and run 30 seconds without a crash, and reconnect Wi-Fi if that is configured (within 3 minutes), before it is confirmed for good. If it crashes or restarts, or cannot get Wi-Fi back, the device **rolls back** to the previous firmware by itself and says so.
+
+## Safe Mode
+
+If a confirmed firmware crashes and restarts **3 times in a row**, the device starts in **Safe Mode** instead: only Wi-Fi and firmware updates, so a fix can be installed without a cable. A normal restart leaves it.
+
+## IRC steps aside
+
+A secure connection takes about 52 KB of memory at its peak, and IRC's own takes about 40 KB of the 107 KB there is. So a check or an install that you ask for makes IRC disconnect for the few seconds it takes, and reconnect afterwards. The **daily check never does that**: with IRC connected it waits for a moment when IRC is not, so if IRC stays connected for days the daily check does not run, and **Latest release** is the way to check.
+
+## How the connection is trusted
+
+The connection to the project's server is checked against the two root certificates that Let's Encrypt's chains end in, not against the usual bundle of about 130 authorities. Whatever the connection, the update file's own signature decides what gets installed.
+
+## For developers
+
+Updates can also be pushed from a PC over Wi-Fi, with `scripts/flash.sh --ota <ip>`, or put on the card with `scripts/sd_put.sh`: see the [README](https://git.twis.la/twisla/roro9stack#firmware-updates-over-wi-fi-ota). **Debug Builds** show the latest release but do not install it, because a release has no debug console: update a Debug Build from the PC.
@@ -0,0 +1,36 @@
+++
+title = "Wi-Fi tools"
+description = "See the networks around you, which Wi-Fi channels are busy, and follow one network's signal as you move."
+weight = 6
+[extra]
+tag = "Wi-Fi tools"
+++
+
+The Wi-Fi tools show what the radio hears **now**: they scan for the networks around you and list them. They do not join anything.
+
+## The menu
+
+Three entries: **Networks nearby**, **Channel occupancy** and **Signal tracker**. Pick one with the arrows and press <kbd>Enter</kbd>.
+
+## Networks nearby
+
+A list that refreshes by itself: each network's name (or `(hidden)`), channel, signal in dBm and security. The top line says how it is sorted and filtered.
+
+| Key | Does |
+|---|---|
+| <kbd>s</kbd> | Sorts by signal, channel or name, in turn |
+| <kbd>o</kbd> | Shows only open networks |
+| <kbd>h</kbd> | Hides the hidden networks |
+| <kbd>w</kbd> | Shows only the strong ones |
+| <kbd>l</kbd> | Starts and stops **logging** |
+| <kbd>Enter</kbd> | Opens the **Signal tracker** on that network |
+
+**Logging** adds each scan to `/wifi/scans/<date>.csv` on the SD card, one row per network, once the device knows the date; `LOG` and a row count show while it runs. Logs stop when the card passes 90% full.
+
+## Channel occupancy
+
+One bar for each of the 13 Wi-Fi channels shows how busy it is: how many networks use it, and how strong they are. The top line counts the networks and names the quietest of the three channels that don't overlap, **1, 6 and 11**. It is the quick answer to "which channel should my router use?". <kbd>`</kbd> (Back) returns to the menu.
+
+## Signal tracker
+
+Follows one network: its name, address and channel, then the signal in dBm in large type, a strength bar, and a graph of the recent readings, so you can walk towards the strongest signal. <kbd>m</kbd> turns audible clicks on and off. If the network is no longer heard the screen says `lost`. <kbd>`</kbd> (Back) returns to the list.
@@ -0,0 +1,41 @@
+++
+title = "Install roro9stack"
+description = "Flash roro9stack onto an M5Stack Cardputer ADV from your browser, or with esptool."
+template = "install.html"
+++
+
+## Before you start
+
+- An **M5Stack Cardputer ADV**, and a **USB-C cable that carries data** (a charge-only cable won't show up).
+- **Chrome or Edge on a desktop computer.** Flashing from a page uses Web Serial, which Firefox and Safari don't have. Without it, use esptool below.
+- The **Cap LoRa-1262** is optional for the install: the LoRa Scanner and GNSS need it, the other Apps don't.
+
+## Flash it
+
+1. **Put the Cardputer in download mode.** Hold **G0**, the button next to the screen, while you plug in the USB-C cable.
+2. Press **Install roro9stack** above, choose the Cardputer in the list of serial ports (it's usually named after its chip, *ESP32-S3*, or *USB JTAG/serial debug unit*), and confirm.
+3. Wait for it to finish, and don't unplug it.
+4. The Cardputer restarts into a short **first-boot setup**: a name, a short name for the mesh, your region and your time zone. An interrupted setup simply starts again at the next boot.
+
+Flashing writes the firmware. What's on the SD card isn't touched.
+
+## Without Chrome: esptool
+
+Download the file ending in `-factory.bin` from [the downloads](/downloads/), put the Cardputer in download mode as above, and write it at offset 0:
+
+```sh
+pip install esptool
+esptool --chip esp32s3 write-flash 0x0 roro9stack-<version>-factory.bin
+```
+
+With esptool 4, the command is `esptool.py --chip esp32s3 write_flash 0x0 …`. On Linux your user needs access to the serial port: `sudo usermod -aG dialout "$USER"`, then log out and back in. The file's SHA-256 is listed above and in the release's `SHA256SUMS`.
+
+## After the first boot
+
+- **Wi-Fi:** Settings → Wi-Fi → add your network.
+- **Updates:** Settings → Firmware shows the latest release and installs it from the project's server, with no computer. It runs the new firmware on Probation and goes back by itself if it doesn't hold.
+- **Something went wrong:** hold G0 while plugging in USB, and flash again. A device that keeps crashing starts in Safe Mode, where Wi-Fi and updates still work.
+
+## Why this page loads from git.twis.la
+
+The flasher asks the project's own Gitea for the latest release and gives the browser that release's factory image. Nothing is copied to this site, and a new release appears here as soon as it exists.
@@ -0,0 +1,75 @@
+# The App cards on the home page. Each says what the firmware does today (docs/milestones/W1.md, Q185):
+# what isn't built is marked planned, with its milestone. `icon` is a cell of static/img/icons-*.svg.
+
+[[app]]
+num = "01"
+tag = "LoRa Scanner"
+title = "See what is on the air"
+text = "Lists every packet it hears with time, RSSI, SNR, sender and hops, reading the Meshtastic header. A Sweep shows signal strength from 863 to 870 MHz. Capture to a pcap for Wireshark."
+fact = "Only listens, never transmits"
+icon = 1
+
+[[app]]
+num = "02"
+tag = "GNSS"
+title = "Find your place in the sky"
+text = "Position and Sky views show where you are and which satellites you can see. Tracks save to the SD card as GPX, and the clock follows the fix."
+fact = "Sky view and GPX Tracks"
+icon = 2
+
+[[app]]
+num = "03"
+tag = "Gemini"
+title = "Browse Geminispace"
+text = "Follow links with Tab and Enter, go Back to where you were, bookmark pages and save them to the SD card to read offline."
+fact = "Certificates trusted on first use"
+icon = 4
+
+[[app]]
+num = "04"
+tag = "IRC"
+title = "Chat from the keyboard"
+text = "Join channels and type commands as you would anywhere, with daily logs written to the SD card."
+fact = "Logs to SD"
+icon = 5
+
+[[app]]
+num = "05"
+tag = "Wi-Fi tools"
+title = "Scan the air for networks"
+text = "See the networks around you, sort and filter the list, and log scans to a CSV file on the SD card."
+fact = "Scans log to CSV"
+icon = 3
+
+[[app]]
+num = "06"
+tag = "Notes"
+title = "Write it down"
+text = "Keep plain text notes on the SD card. There is no save key: the editor writes five seconds after you stop typing, through a temporary file, so a power cut never costs the note."
+fact = "Plain .txt files in /notes"
+icon = 6
+
+[[app]]
+num = "07"
+tag = "Storage"
+title = "Manage the SD card"
+text = "Browse, copy, cut, rename and delete with a clipboard. Copies run in the background and Back cancels one. Opens text, hex, captures, tracks and update files."
+fact = "Checks every copy by size"
+icon = 8
+
+[[app]]
+num = "08"
+tag = "System"
+title = "Watch it think"
+text = "Per-core load, every task and its spare stack, free heap, network traffic, battery and chip temperature, live."
+fact = "Live and read-only"
+icon = 7
+
+[[app]]
+num = "09"
+tag = "Planned"
+title = "A mesh messenger"
+text = "Sending and reading messages on a Meshtastic-compatible mesh. The radio listens today, in the LoRa Scanner; transmitting is the next step and waits for a second node to test with."
+fact = "Milestones M4 and M5 · not built yet"
+icon = 0
+planned = true
@@ -0,0 +1,40 @@
+# Real screenshots (the Debug Console's `screenshot` command, 240 x 135 pixels, shown at twice that).
+[[screen]]
+file = "sweep.png"
+alt = "The LoRa Scanner's Sweep view: bars of signal strength from 863.0 to 870.0 MHz with peak marks, a waterfall under them, and a footer reading floor -100, 863.2 MHz at -89 dBm"
+caption = "LoRa Scanner, Sweep"
+
+[[screen]]
+file = "sniffer.png"
+alt = "The LoRa Scanner's packet list on LongFast 869.525 MHz while a Capture is recording: three packets, each with its time, RSSI, SNR and Meshtastic sender and hops"
+caption = "LoRa Scanner, packets"
+
+[[screen]]
+file = "sky.png"
+alt = "The GNSS App's sky view: a circle with the satellites of four constellations as coloured dots, and a legend counting them: GPS 7 of 10, GLONASS 5 of 5, Galileo 1 of 1, BeiDou 4 of 5, 3D Fix"
+caption = "GNSS, sky"
+
+[[screen]]
+file = "gemini.png"
+alt = "The Gemini App on the page Project Gemini at geminiprotocol.net: a heading, then the start of the text, Gemini in 100 words"
+caption = "Gemini"
+
+[[screen]]
+file = "system.png"
+alt = "The System App's overview: Core 0 at 47 percent, Core 1 at 64 percent, memory 49 KB free, network, battery 97 percent, uptime, and a graph of both cores over two minutes"
+caption = "System"
+
+[[screen]]
+file = "notes.png"
+alt = "The Notes editor on shopping-list.txt, 66 bytes, saved: Shopping list, milk, and a longer line that wraps on the screen"
+caption = "Notes"
+
+[[screen]]
+file = "storage.png"
+alt = "The Storage App at the top of the SD card: the folders captures, gemini, gnss, irc, updates and wifi, and a Maintenance row, with 7.3 GB free"
+caption = "Storage"
+
+[[screen]]
+file = "update.png"
+alt = "The full-screen progress of a firmware update: Receiving v0.10.0, a bar at 28 percent"
+caption = "A firmware update"
@@ -0,0 +1,6 @@
+# Security contact for roro9stack.net and the roro9stack firmware (RFC 9116).
+# Please report vulnerabilities privately by email, not in the public issue tracker.
+Contact: mailto:contact@roro9stack.net
+Expires: 2027-09-30T00:00:00.000Z
+Preferred-Languages: en, fr
+Canonical: https://roro9stack.net/.well-known/security.txt
@@ -0,0 +1,244 @@
+/* roro9stack.net: the tokens and shapes of the design (docs/milestones/W1.md). Every colour is on the
+   device's RGB332 grid. Dark is the default; a visitor who prefers light gets light, and the switch
+   in the header overrides both. */
+
+@font-face { font-family: "DM Mono"; src: url(/fonts/DMMono-Regular.woff2) format("woff2"); font-weight: 400; font-style: normal; font-display: swap; }
+@font-face { font-family: "DM Mono"; src: url(/fonts/DMMono-Medium.woff2) format("woff2"); font-weight: 500; font-style: normal; font-display: swap; }
+@font-face { font-family: "Hanken Grotesk"; src: url(/fonts/HankenGrotesk.woff2) format("woff2"); font-weight: 100 900; font-style: normal; font-display: swap; }
+
+:root {
+  --mono: "DM Mono", ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
+  --sans: "Hanken Grotesk", system-ui, -apple-system, "Segoe UI", sans-serif;
+
+  color-scheme: dark;
+  --s1: #494955; --s2: #000000; --s3: #6d6d55; --line: #6d6d55; --ls: #b6b6aa;
+  --ink: #ffffff; --muted: #b6dbff;
+  --cyan: #00dbff; --onfill: #000055; --cyandeep: #00dbff; --cyantext: #00dbff;
+  --mag: #ff00ff; --magtext: #ff92ff; --orange: #ff9200; --orangetext: #ffb655;
+  --icons: url(/img/icons-dark.svg);
+  --logo-dark: block; --logo-light: none;
+}
+@media (prefers-color-scheme: light) {
+  :root:not([data-theme="dark"]) {
+    color-scheme: light;
+    --s1: #ffffff; --s2: #dbffff; --s3: #b6dbff; --line: #92b6ff; --ls: #6d6daa;
+    --ink: #000055; --muted: #4949aa;
+    --cyandeep: #0092aa; --cyantext: #006daa; --magtext: #b600aa; --orangetext: #b64900;
+    --icons: url(/img/icons-light.svg);
+    --logo-dark: none; --logo-light: block;
+  }
+}
+:root[data-theme="light"] {
+  color-scheme: light;
+  --s1: #ffffff; --s2: #dbffff; --s3: #b6dbff; --line: #92b6ff; --ls: #6d6daa;
+  --ink: #000055; --muted: #4949aa;
+  --cyandeep: #0092aa; --cyantext: #006daa; --magtext: #b600aa; --orangetext: #b64900;
+  --icons: url(/img/icons-light.svg);
+  --logo-dark: none; --logo-light: block;
+}
+
+* { box-sizing: border-box; }
+html { -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }
+@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
+body { margin: 0; background: var(--s1); color: var(--ink); font: 400 16px/24px var(--sans); }
+a { color: inherit; text-decoration: none; }
+a:hover { text-decoration: underline; text-underline-offset: 4px; }
+img { max-width: 100%; height: auto; }
+h1, h2, h3, p, ul, ol, figure, dl, dd { margin: 0; }
+ul, ol { padding: 0; list-style: none; }
+
+/* A focus ring must show. clip-path clips an outline along with everything else outside the shape,
+   so a focused notched control drops its notches and shows square corners and its ring. */
+:focus-visible { outline: 2px solid var(--cyandeep); outline-offset: 2px; }
+.n-sm:focus-visible, .n-md:focus-visible, .n-lg:focus-visible { clip-path: none; }
+
+.skip { position: absolute; left: 8px; top: -60px; z-index: 10; background: var(--cyan); color: var(--onfill); padding: 12px 16px; font: 500 14px/20px var(--mono); }
+.skip:focus { top: 8px; }
+
+/* Notched corners: whole steps on a 4px grid (the device draws no curves). */
+.n-sm { clip-path: polygon(0 4px,4px 4px,4px 0,calc(100% - 4px) 0,calc(100% - 4px) 4px,100% 4px,100% calc(100% - 4px),calc(100% - 4px) calc(100% - 4px),calc(100% - 4px) 100%,4px 100%,4px calc(100% - 4px),0 calc(100% - 4px)); }
+.n-md { clip-path: polygon(0 8px,4px 8px,4px 4px,8px 4px,8px 0,calc(100% - 8px) 0,calc(100% - 8px) 4px,calc(100% - 4px) 4px,calc(100% - 4px) 8px,100% 8px,100% calc(100% - 8px),calc(100% - 4px) calc(100% - 8px),calc(100% - 4px) calc(100% - 4px),calc(100% - 8px) calc(100% - 4px),calc(100% - 8px) 100%,8px 100%,8px calc(100% - 4px),4px calc(100% - 4px),4px calc(100% - 8px),0 calc(100% - 8px)); }
+.n-lg { clip-path: polygon(0 16px,8px 16px,8px 8px,16px 8px,16px 0,calc(100% - 16px) 0,calc(100% - 16px) 8px,calc(100% - 8px) 8px,calc(100% - 8px) 16px,100% 16px,100% calc(100% - 16px),calc(100% - 8px) calc(100% - 16px),calc(100% - 8px) calc(100% - 8px),calc(100% - 16px) calc(100% - 8px),calc(100% - 16px) 100%,16px 100%,16px calc(100% - 8px),8px calc(100% - 8px),8px calc(100% - 16px),0 calc(100% - 16px)); }
+
+.wrap { width: 100%; max-width: 1200px; margin: 0 auto; padding-left: 32px; padding-right: 32px; }
+.mono { font-family: var(--mono); }
+
+/* Header */
+.bar { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 16px; padding-top: 24px; padding-bottom: 24px; }
+.brand { display: flex; align-items: center; min-height: 44px; }
+.logo { height: 28px; width: auto; }
+.logo-dark { display: var(--logo-dark); }
+.logo-light { display: var(--logo-light); }
+.bar nav { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
+.bar nav a, .link-btn { display: inline-flex; align-items: center; min-height: 44px; padding: 0 12px; font: 400 14px/20px var(--mono); }
+.link-btn { background: none; border: 0; color: inherit; cursor: pointer; }
+.link-btn:hover { text-decoration: underline; text-underline-offset: 4px; }
+.js-only { display: none; }
+.js .js-only { display: inline-flex; }
+
+/* Buttons */
+.btn { display: inline-flex; align-items: center; justify-content: center; min-height: 48px; padding: 0 24px; font: 500 14px/20px var(--mono); border: 0; cursor: pointer; }
+.btn:hover { text-decoration: none; filter: brightness(1.08); }
+.btn-primary { background: var(--cyan); color: var(--onfill); }
+.btn-secondary { background: var(--s2); color: var(--ink); }
+.bar nav a.btn { min-height: 44px; padding: 0 20px; }
+.bar nav a.btn:hover { text-decoration: none; }
+
+/* Type */
+.eyebrow { font: 500 12px/16px var(--mono); letter-spacing: .08em; text-transform: uppercase; color: var(--cyantext); }
+.eyebrow-row { display: flex; align-items: center; gap: 8px; }
+.eyebrow .v { text-transform: none; }
+.dot { width: 8px; height: 8px; background: var(--cyan); flex: none; }
+h1, h2 { font-family: var(--mono); font-weight: 500; }
+h1 { font-size: 64px; line-height: 64px; letter-spacing: -.02em; }
+h2 { font-size: 40px; line-height: 44px; letter-spacing: -.01em; }
+h3 { font-size: 24px; line-height: 30px; font-weight: 600; }
+.accent { color: var(--cyantext); }
+.lead { font-size: 18px; line-height: 28px; max-width: 520px; }
+.muted { color: var(--muted); }
+.small { font-size: 14px; line-height: 20px; }
+.caption { font: 400 12px/16px var(--mono); color: var(--muted); }
+code, .code { font-family: var(--mono); font-size: .9em; }
+
+section { padding-top: 64px; padding-bottom: 64px; }
+.section-head { display: flex; flex-direction: column; gap: 12px; max-width: 680px; }
+.stack { display: flex; flex-direction: column; gap: 24px; }
+
+/* Hero */
+.hero { padding-top: 48px; padding-bottom: 32px; display: flex; flex-direction: column; gap: 48px; }
+.hero-grid { display: flex; flex-wrap: wrap; align-items: flex-end; gap: 32px 56px; }
+.hero-grid > div { flex: 1 1 360px; min-width: 0; display: flex; flex-direction: column; gap: 24px; }
+.hero-grid > div:first-child { flex-basis: 480px; }
+.actions { display: flex; flex-wrap: wrap; gap: 16px; }
+.facts { display: flex; flex-wrap: wrap; gap: 8px 24px; }
+.facts li { display: flex; align-items: center; gap: 8px; font: 400 14px/20px var(--mono); color: var(--muted); }
+.facts li::before { content: ""; width: 8px; height: 8px; background: var(--mag); display: block; }
+.slab { background: var(--cyan); padding: 40px; display: flex; flex-wrap: wrap; gap: 32px; }
+.slab .device { flex: 1 1 440px; min-width: 0; }
+.illustration { display: block; width: 100%; height: auto; }
+.illustration .mono { font-family: var(--mono); }
+.hero .caption { margin-top: -36px; }
+
+/* Panels */
+.panel { background: var(--s2); padding: 32px; }
+.status-box { background: var(--s2); padding: 24px 32px; display: flex; flex-wrap: wrap; align-items: baseline; gap: 8px 24px; }
+.status-box .eyebrow { color: var(--orangetext); }
+.status-box p { flex: 1 1 420px; min-width: 0; }
+.status-box a, .prose a, .steps a, .need a { color: var(--cyantext); text-decoration: underline; text-underline-offset: 4px; }
+
+.need { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 24px; margin-top: 32px; }
+.need li { display: flex; flex-direction: column; gap: 4px; padding-left: 16px; border-left: 4px solid var(--cyan); }
+.need strong { font-weight: 600; }
+.need span { color: var(--muted); }
+
+/* App cards */
+.cards { display: flex; flex-wrap: wrap; gap: 24px; margin-top: 40px; }
+.card { flex: 1 1 320px; min-width: 0; background: var(--s2); padding: 32px; display: flex; flex-direction: column; gap: 16px; }
+.card-top { display: flex; justify-content: space-between; align-items: center; }
+.card .tag { font: 500 12px/16px var(--mono); letter-spacing: .08em; text-transform: uppercase; color: var(--cyantext); }
+.card .num { font: 500 12px/16px var(--mono); letter-spacing: .08em; color: var(--muted); }
+.card p { color: var(--muted); }
+.card .fact { margin-top: auto; padding-top: 8px; display: flex; align-items: center; gap: 8px; font: 500 12px/16px var(--mono); letter-spacing: .04em; }
+.card .fact::before { content: ""; width: 8px; height: 8px; background: var(--cyan); flex: none; }
+.card.planned .tag { color: var(--orangetext); }
+.card.planned .fact::before { background: var(--orange); }
+.ic { width: 48px; height: 48px; flex: none; background-image: var(--icons); background-repeat: no-repeat; background-size: 144px 192px; image-rendering: pixelated; }
+.i0 { background-position: 0 0; } .i1 { background-position: -48px 0; } .i2 { background-position: -96px 0; }
+.i3 { background-position: 0 -48px; } .i4 { background-position: -48px -48px; } .i5 { background-position: -96px -48px; }
+.i6 { background-position: 0 -96px; } .i7 { background-position: -48px -96px; } .i8 { background-position: -96px -96px; }
+.i9 { background-position: 0 -144px; }
+.cards-note { margin-top: 24px; font-size: 14px; line-height: 20px; color: var(--muted); }
+
+/* Real screenshots */
+.shots { display: grid; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr)); gap: 24px; margin-top: 40px; }
+.shot { background: var(--s2); padding: 16px; display: flex; flex-direction: column; gap: 12px; }
+.shot img { display: block; width: 100%; height: auto; }  /* shown at about half size: smoothed, not pixel-doubled */
+.shot figcaption { font: 500 12px/16px var(--mono); letter-spacing: .08em; text-transform: uppercase; color: var(--muted); }
+
+/* Updates */
+.split { display: flex; flex-wrap: wrap; gap: 48px; }
+.split > div { flex: 1 1 380px; min-width: 0; display: flex; flex-direction: column; gap: 24px; }
+.split > .aside { flex-basis: 420px; justify-content: center; gap: 32px; }
+.updates { background: var(--s2); padding: 48px; }
+.terminal { background: var(--s1); padding: 16px 20px; font: 400 14px/20px var(--mono); overflow-x: auto; white-space: pre; }
+.terminal .p { color: var(--cyantext); }
+.terminal .c { color: var(--muted); }
+.num-row { display: flex; flex-wrap: wrap; align-items: baseline; gap: 8px 24px; }
+.num-row .big { flex: none; min-width: 160px; font: 500 64px/64px var(--mono); letter-spacing: -.02em; }
+.num-row p { flex: 1 1 200px; min-width: 0; color: var(--muted); }
+.big.c1 { color: var(--cyantext); } .big.c2 { color: var(--magtext); }
+.split > .blocks { display: flex; flex-direction: column; gap: 4px; background: var(--s2); padding: 32px; font: 400 14px/20px var(--mono); overflow-x: auto; white-space: pre; }
+.split > .blocks .gap { height: 16px; }
+.split > .blocks .c { color: var(--muted); }
+.split > .blocks .p { color: var(--cyantext); }
+
+/* Call to action */
+.cta { background: var(--cyan); color: var(--onfill); padding: 48px; display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 40px; }
+.cta > div:not(.nine) { flex: 1 1 360px; min-width: 0; display: flex; flex-direction: column; gap: 20px; }
+.cta p { font-size: 18px; line-height: 28px; max-width: 480px; }
+.cta .btn { background: #000055; color: #ffffff; }
+.nine { display: grid; grid-template-columns: repeat(5, 24px); gap: 4px; }
+.nine i { display: block; width: 24px; height: 24px; }
+.nine i.on { background: var(--s1); }
+
+/* Footer */
+footer .wrap { padding-top: 32px; padding-bottom: 64px; display: flex; flex-direction: column; gap: 24px; }
+.foot-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 16px; }
+.foot-row span, footer small { font: 400 14px/20px var(--mono); color: var(--muted); }
+footer nav { display: flex; flex-wrap: wrap; gap: 8px; }
+footer nav a { display: inline-flex; align-items: center; min-height: 44px; padding: 0 12px; font: 400 14px/20px var(--mono); }
+footer small { display: block; max-width: 760px; }
+
+/* Pages: Install, Downloads, 404 */
+.page { padding-top: 32px; padding-bottom: 64px; display: flex; flex-direction: column; gap: 40px; }
+.page h1 { font-size: 48px; line-height: 52px; }
+.page h2 { font-size: 32px; line-height: 36px; }
+.prose { max-width: 720px; display: flex; flex-direction: column; gap: 16px; }
+.prose h2 { margin-top: 24px; }
+.prose ul { list-style: disc; padding-left: 24px; display: flex; flex-direction: column; gap: 8px; }
+.prose ol, .steps { list-style: decimal; padding-left: 24px; display: flex; flex-direction: column; gap: 12px; }
+.prose pre { margin: 0; padding: 16px 20px; background: var(--s2); font: 400 14px/20px var(--mono); overflow-x: auto; clip-path: polygon(0 8px,4px 8px,4px 4px,8px 4px,8px 0,calc(100% - 8px) 0,calc(100% - 8px) 4px,calc(100% - 4px) 4px,calc(100% - 4px) 8px,100% 8px,100% calc(100% - 8px),calc(100% - 4px) calc(100% - 8px),calc(100% - 4px) calc(100% - 4px),calc(100% - 8px) calc(100% - 4px),calc(100% - 8px) 100%,8px 100%,8px calc(100% - 4px),4px calc(100% - 4px),4px calc(100% - 8px),0 calc(100% - 8px)); }
+.prose pre code { font-size: 14px; }
+.prose :not(pre) > code { background: var(--s2); padding: 0 6px; }
+.prose table { border-collapse: collapse; width: 100%; }
+.prose th, .prose td { text-align: left; padding: 8px 12px; border-bottom: 1px solid var(--line); vertical-align: top; }
+
+.flasher { background: var(--s2); padding: 32px; display: flex; flex-direction: column; gap: 20px; max-width: 720px; }
+.flasher dl { display: grid; grid-template-columns: max-content 1fr; gap: 4px 20px; font: 400 14px/20px var(--mono); }
+.flasher dt { color: var(--muted); }
+.flasher dd { overflow-wrap: anywhere; }
+.flasher [hidden] { display: none !important; }
+.flasher .msg { color: var(--orangetext); }
+.hash { word-break: break-all; }
+
+.releases { display: flex; flex-direction: column; gap: 24px; }
+.release { background: var(--s2); padding: 24px 32px; display: flex; flex-direction: column; gap: 12px; max-width: 880px; }
+.release h2 { font-size: 28px; line-height: 32px; }
+.release .meta { font: 400 14px/20px var(--mono); color: var(--muted); }
+.release .files { display: flex; flex-wrap: wrap; gap: 8px 20px; font: 400 14px/20px var(--mono); }
+.release .files a { color: var(--cyantext); text-decoration: underline; text-underline-offset: 4px; }
+
+@media (max-width: 720px) {
+  h1 { font-size: 40px; line-height: 44px; }
+  h2 { font-size: 32px; line-height: 36px; }
+  .wrap { padding-left: 20px; padding-right: 20px; }
+  section { padding-top: 48px; padding-bottom: 48px; }
+  .slab, .updates, .cta { padding: 24px; }
+  .panel, .card { padding: 24px; }
+  .hero .caption { margin-top: -24px; }
+  .num-row .big { font-size: 48px; line-height: 48px; min-width: 120px; }
+}
+
+.accent-link { color: var(--cyantext); text-decoration: underline; text-underline-offset: 4px; }
+.page > header { display: flex; flex-direction: column; gap: 12px; }
+.page .lead { max-width: 720px; }
+
+/* The user guide */
+.pager { display: flex; justify-content: space-between; gap: 16px; flex-wrap: wrap; }
+.card h2 { font-size: 24px; line-height: 28px; }
+.card h2 a { color: inherit; text-decoration: none; }
+.card h2 a:hover, .card h2 a:focus-visible { text-decoration: underline; text-underline-offset: 4px; }
+.eyebrow a { color: inherit; }
+.prose kbd { font: 500 13px/16px var(--mono); background: var(--s2); padding: 1px 6px; border: 1px solid var(--line); }
+.prose .note { background: var(--s2); padding: 16px 20px; }
+.prose h3 { margin-top: 12px; }
@@ -0,0 +1,93 @@
+Copyright 2020 The DM Mono Project Authors (https://www.github.com/googlefonts/dm-mono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -0,0 +1,94 @@
+Copyright 2021 The Hanken Grotesk Project Authors (https://github.com/marcologous/hanken-grotesk)
+
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -0,0 +1,213 @@
+/*
+ * theme "nord" generated by giallo
+ */
+
+.z-code {
+  color: #D8DEE9;
+  background-color: #2E3440;
+}
+
+.z-hl {
+  background-color: #3B4252;
+}
+
+.giallo-ln {
+  color: #4C566A;
+}
+
+.z-emphasis { font-style: italic; }
+.z-strong { font-weight: bold; }
+.z-comment { color: #616E88; }
+.z-keyword { color: #81A1C1; }
+.z-punctuation { color: #ECEFF4; }
+.z-storage { color: #81A1C1; }
+.z-string { color: #A3BE8C; }
+.z-punctuation { color: #5E81AC; }
+.z-constant.z-character { color: #EBCB8B; }
+.z-constant.z-language { color: #81A1C1; }
+.z-constant.z-numeric { color: #B48EAD; }
+.z-constant.z-regexp { color: #EBCB8B; }
+.z-invalid.z-deprecated { color: #D8DEE9; background-color: #EBCB8B; }
+.z-invalid.z-illegal { color: #D8DEE9; background-color: #BF616A; }
+.z-keyword.z-operator { color: #81A1C1; }
+.z-markup.z-bold { font-weight: bold; }
+.z-markup.z-changed { color: #EBCB8B; }
+.z-markup.z-deleted { color: #BF616A; }
+.z-markup.z-inserted { color: #A3BE8C; }
+.z-meta.z-preprocessor { color: #5E81AC; }
+.z-punctuation.z-section { color: #ECEFF4; }
+.z-punctuation.z-terminator { color: #81A1C1; }
+.z-string.z-regexp { color: #EBCB8B; }
+.z-support.z-class { color: #8FBCBB; }
+.z-support.z-constant { color: #81A1C1; }
+.z-support.z-function { color: #88C0D0; }
+.z-support.z-type { color: #8FBCBB; }
+.z-token.z-debug-token { color: #B48EAD; }
+.z-token.z-error-token { color: #BF616A; }
+.z-token.z-info-token { color: #88C0D0; }
+.z-token.z-warn-token { color: #EBCB8B; }
+.z-variable.z-other { color: #D8DEE9; }
+.z-variable.z-language { color: #81A1C1; }
+.z-variable.z-parameter { color: #D8DEE9; }
+.z-markup.z-heading { color: #88C0D0; }
+.z-meta.z-property-value { color: #88C0D0; }
+.z-constant.z-other { color: #D8DEE9; }
+.z-storage.z-type { color: #8FBCBB; }
+.z-punctuation.z-decorator { color: #D08770; }
+.z-markup.z-italic { font-style: italic; }
+.z-markup.z-quote { color: #616E88; }
+.z-meta.z-function-call { color: #88C0D0; }
+.z-support.z-type { color: #88C0D0; }
+.z-meta.z-attribute { color: #5E81AC; }
+.z-variable.z-interpolation { color: #D8DEE9; font-style: italic; }
+.z-punctuation.z-decorator { color: #D08770; }
+.z-punctuation.z-decorator { color: #D08770; }
+.z-support.z-class { color: #8FBCBB; }
+.z-support.z-type { color: #8FBCBB; }
+.z-support.z-class { color: #8FBCBB; }
+.z-support.z-type { color: #8FBCBB; }
+.z-support.z-variable { color: #D8DEE9; }
+.z-support.z-variable { color: #D8DEE9; }
+.z-meta.z-method { color: #88C0D0; }
+.z-punctuation.z-definition { color: #8FBCBB; }
+.z-support.z-type { color: #D08770; }
+.z-keyword.z-operator { color: #5E81AC; }
+.z-constant.z-character.z-escape { color: #EBCB8B; }
+.z-entity.z-name.z-class { color: #8FBCBB; }
+.z-entity.z-name.z-function { color: #88C0D0; }
+.z-entity.z-name.z-tag { color: #81A1C1; }
+.z-entity.z-other.z-attribute-name { color: #8FBCBB; }
+.z-entity.z-other.z-inherited-class { color: #8FBCBB; font-weight: bold; }
+.z-keyword.z-other.z-new { color: #81A1C1; }
+.z-punctuation.z-definition.z-method-parameters { color: #ECEFF4; }
+.z-punctuation.z-definition.z-function-parameters { color: #ECEFF4; }
+.z-punctuation.z-definition.z-parameters { color: #ECEFF4; }
+.z-punctuation.z-definition.z-tag { color: #81A1C1; }
+.z-punctuation.z-definition.z-comment { color: #616E88; }
+.z-punctuation.z-definition.z-variable { color: #81A1C1; }
+.z-support.z-function.z-construct { color: #81A1C1; }
+.z-support.z-type.z-exception { color: #8FBCBB; }
+.z-meta.z-preprocessor.z-include { color: #8FBCBB; }
+.z-punctuation.z-definition.z-directive { color: #5E81AC; font-weight: bold; }
+.z-punctuation.z-definition.z-directive { color: #5E81AC; font-weight: bold; }
+.z-punctuation.z-definition.z-keyword { color: #81A1C1; }
+.z-support.z-type.z-property-name { color: #D8DEE9; }
+.z-punctuation.z-definition.z-from-file { color: #8FBCBB; }
+.z-punctuation.z-definition.z-range { color: #8FBCBB; }
+.z-punctuation.z-definition.z-separator { color: #81A1C1; }
+.z-keyword.z-other.z-documentation { color: #8FBCBB; }
+.z-storage.z-modifier.z-import { color: #8FBCBB; }
+.z-storage.z-modifier.z-package { color: #8FBCBB; }
+.z-storage.z-type.z-annotation { color: #D08770; }
+.z-storage.z-type.z-generic { color: #8FBCBB; }
+.z-storage.z-type.z-primitive { color: #81A1C1; }
+.z-meta.z-object-literal.z-key { color: #88C0D0; }
+.z-support.z-type.z-primitive { color: #81A1C1; }
+.z-variable.z-other.z-object { color: #D8DEE9; }
+.z-constant.z-other.z-inline-data { color: #D08770; font-style: italic; }
+.z-punctuation.z-definition.z-entity { color: #81A1C1; }
+.z-markup.z-fenced_code.z-block { color: #8FBCBB; }
+.z-markup.z-inline.z-raw { color: #8FBCBB; }
+.z-markup.z-underline.z-link { text-decoration: underline; }
+.z-punctuation.z-definition.z-heading { color: #81A1C1; }
+.z-punctuation.z-definition.z-constant { color: #81A1C1; }
+.z-punctuation.z-definition.z-string { color: #81A1C1; }
+.z-punctuation.z-definition.z-variable { color: #D8DEE9; }
+.z-meta.z-function-call.z-object { color: #88C0D0; }
+.z-meta.z-function-call.z-generic { color: #88C0D0; }
+.z-entity.z-name.z-type { color: #8FBCBB; }
+.z-punctuation.z-definition.z-interpolation { color: #EBCB8B; }
+.z-meta.z-object-literal.z-key { color: #D8DEE9; }
+.z-meta.z-object-literal.z-key { color: #D8DEE9; }
+.z-entity.z-name.z-type { color: #8FBCBB; }
+.z-entity.z-name.z-class { color: #8FBCBB; }
+.z-entity.z-name.z-type { color: #8FBCBB; }
+.z-entity.z-name.z-class { color: #8FBCBB; }
+.z-support.z-constant.z-math { color: #8FBCBB; }
+.z-support.z-constant.z-dom { color: #8FBCBB; }
+.z-support.z-constant.z-json { color: #8FBCBB; }
+.z-support.z-constant.z-math { color: #8FBCBB; }
+.z-support.z-constant.z-dom { color: #8FBCBB; }
+.z-support.z-constant.z-json { color: #8FBCBB; }
+.z-keyword.z-other.z-doctype { color: #5E81AC; }
+.z-string.z-unquoted.z-cdata { color: #D08770; font-style: italic; }
+.z-entity.z-name.z-tag { color: #8FBCBB; }
+.z-punctuation.z-definition.z-keyword { color: #D08770; }
+.z-variable.z-other.z-readwrite { color: #D08770; }
+.z-entity.z-name.z-function { color: #D08770; }
+.z-punctuation.z-definition.z-template-expression { color: #81A1C1; }
+.z-meta.z-method-call.z-with-arguments { color: #ECEFF4; }
+.z-meta.z-brace.z-square { color: #ECEFF4; }
+.z-meta.z-brace.z-round { color: #ECEFF4; }
+.z-meta.z-brace.z-square { color: #ECEFF4; }
+.z-meta.z-brace.z-round { color: #ECEFF4; }
+.z-punctuation.z-definition.z-raw { color: #8FBCBB; }
+.z-entity.z-name.z-function { color: #88C0D0; font-weight: bold; }
+.z-variable.z-other.z-readwrite { color: #D08770; }
+.z-entity.z-name.z-function { color: #D08770; }
+.z-variable.z-other.z-readwrite { color: #D08770; }
+.z-entity.z-name.z-function { color: #D08770; }
+.z-entity.z-name.z-function { color: #88C0D0; }
+.z-entity.z-name.z-function { color: #88C0D0; }
+.z-meta.z-brace.z-square { color: #ECEFF4; }
+.z-meta.z-brace.z-round { color: #ECEFF4; }
+.z-meta.z-brace.z-square { color: #ECEFF4; }
+.z-meta.z-brace.z-round { color: #ECEFF4; }
+.z-entity.z-name.z-tag { color: #5E81AC; }
+.z-punctuation.z-definition.z-string { color: #D08770; font-style: italic; }
+.z-support.z-variable.z-property { color: #D8DEE9; }
+.z-variable.z-other.z-object { color: #D8DEE9; }
+.z-entity.z-name.z-type.z-class { color: #8FBCBB; }
+.z-punctuation.z-end.z-definition.z-comment { color: #616E88; }
+.z-punctuation.z-start.z-definition.z-comment { color: #616E88; }
+.z-punctuation.z-section.z-embedded.z-begin { color: #81A1C1; }
+.z-punctuation.z-section.z-embedded.z-end { color: #81A1C1; }
+.z-punctuation.z-separator.z-pointer-access.z-c { color: #81A1C1; }
+.z-constant.z-other.z-symbol.z-elixir { color: #D8DEE9; font-weight: bold; }
+.z-variable.z-other.z-constant.z-elixir { color: #8FBCBB; }
+.z-keyword.z-control.z-directive.z-conditional { color: #5E81AC; font-weight: bold; }
+.z-keyword.z-control.z-directive.z-conditional { color: #5E81AC; font-weight: bold; }
+.z-constant.z-other.z-color.z-rgb-value { color: #B48EAD; }
+.z-keyword.z-control.z-at-rule.z-media { color: #D08770; }
+.z-meta.z-diff.z-range.z-context { color: #8FBCBB; }
+.z-meta.z-diff.z-header.z-from-file { color: #8FBCBB; }
+.z-constant.z-other.z-placeholder.z-go { color: #EBCB8B; }
+.z-keyword.z-other.z-documentation.z-directive { color: #8FBCBB; }
+.z-keyword.z-other.z-documentation.z-custom { color: #8FBCBB; }
+.z-punctuation.z-definition.z-keyword.z-javadoc { color: #8FBCBB; }
+.z-storage.z-type.z-class.z-jsdoc { color: #8FBCBB; }
+.z-variable.z-other.z-readwrite.z-alias { color: #8FBCBB; }
+.z-constant.z-character.z-entity.z-html { color: #EBCB8B; }
+.z-meta.z-tag.z-sgml.z-doctype { color: #5E81AC; }
+.z-punctuation.z-separator.z-key-value.z-ini { color: #81A1C1; }
+.z-beginning.z-punctuation.z-definition.z-list { color: #81A1C1; }
+.z-beginning.z-punctuation.z-definition.z-quote { color: #8FBCBB; }
+.z-constant.z-character.z-math.z-tex { color: #81A1C1; }
+.z-punctuation.z-definition.z-math.z-begin { color: #5E81AC; }
+.z-punctuation.z-definition.z-math.z-end { color: #5E81AC; }
+.z-punctuation.z-math.z-operator.z-latex { color: #81A1C1; }
+.z-constant.z-other.z-reference.z-link { color: #88C0D0; }
+.z-string.z-other.z-link.z-description { color: #88C0D0; }
+.z-string.z-other.z-link.z-title { color: #88C0D0; }
+.z-entity.z-name.z-function.z-decorator { color: #D08770; }
+.z-variable.z-parameter.z-function.z-language { color: #D8DEE9; }
+.z-entity.z-name.z-type.z-trait { font-weight: bold; }
+.z-entity.z-name.z-tag.z-namespace { color: #8FBCBB; }
+.z-punctuation.z-definition.z-entity.z-html { color: #81A1C1; }
+.z-punctuation.z-quasi.z-element.z-begin { color: #81A1C1; }
+.z-punctuation.z-quasi.z-element.z-end { color: #81A1C1; }
+.z-entity.z-name.z-type.z-module.z-elixir { color: #8FBCBB; }
+.z-variable.z-other.z-readwrite.z-module.z-elixir { color: #D8DEE9; font-weight: bold; }
+.z-string.z-quoted.z-other.z-lt-gt.z-include { color: #8FBCBB; }
+.z-keyword.z-other.z-documentation.z-author.z-javadoc { color: #8FBCBB; }
+.z-keyword.z-other.z-documentation.z-see.z-javadoc { color: #8FBCBB; }
+.z-meta.z-tag.z-template.z-link.z-javadoc { color: #8FBCBB; }
+.z-string.z-other.z-link.z-title.z-javadoc { color: #8FBCBB; }
+.z-meta.z-tag.z-template.z-value.z-javadoc { color: #88C0D0; }
+.z-punctuation.z-definition.z-tag.z-begin.z-javadoc { color: #616E88; }
+.z-punctuation.z-definition.z-tag.z-end.z-javadoc { color: #616E88; }
+.z-entity.z-name.z-section.z-group-title.z-ini { color: #88C0D0; }
+.z-punctuation.z-definition.z-function.z-math.z-tex { color: #88C0D0; }
+.z-punctuation.z-definition.z-interpolation.z-begin.z-bracket.z-curly { color: #81A1C1; }
+.z-punctuation.z-definition.z-interpolation.z-end.z-bracket.z-curly { color: #81A1C1; }
+.z-variable.z-parameter.z-function.z-language.z-special.z-self { color: #81A1C1; }
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 7 7" shape-rendering="crispEdges"><rect width="7" height="7" fill="#000055"/><g fill="#00dbff"><rect x="1" y="0" width="3" height="1"/><rect x="0" y="1" width="1" height="2"/><rect x="4" y="1" width="1" height="5"/><rect x="1" y="3" width="3" height="1"/><rect x="0" y="6" width="3" height="1"/></g></svg>
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.0 -78.0 612.0 85.2" role="img" aria-label="roro9stack"><path fill="#ffffff" d="M7.7 0V-9.2H19.8V-37.1Q19.8 -40.4 16.6 -40.4H8.7V-49.6H20.6Q24.7 -49.6 27.3 -47.2Q29.9 -44.9 29.9 -40.7V-39.5H30.4Q31.5 -45.1 35.2 -48Q38.8 -50.8 45.8 -50.8H53.5V-39.6H42.7Q36.8 -39.6 33.6 -35.5Q30.4 -31.4 30.4 -25.7V-9.2H45.8V0Z"></path><path fill="#ffffff" d="M90 1.2Q82.9 1.2 77.3 -2Q71.7 -5.2 68.5 -11.1Q65.3 -16.9 65.3 -24.8Q65.3 -32.7 68.5 -38.6Q71.7 -44.4 77.3 -47.6Q82.9 -50.8 90.1 -50.8Q97.3 -50.8 102.9 -47.6Q108.4 -44.4 111.6 -38.6Q114.7 -32.7 114.7 -24.8Q114.7 -16.9 111.5 -11.1Q108.3 -5.2 102.8 -2Q97.2 1.2 90 1.2ZM90 -8.9Q93.8 -8.9 97 -10.6Q100.2 -12.3 102.2 -15.9Q104.1 -19.4 104.1 -24.8Q104.1 -30.3 102.2 -33.8Q100.2 -37.3 97.1 -39Q93.9 -40.7 90.1 -40.7Q86.3 -40.7 83.1 -39Q79.9 -37.3 78 -33.8Q76 -30.3 76 -24.8Q76 -16.6 80.2 -12.8Q84.3 -8.9 90 -8.9Z"></path><path fill="#ffffff" d="M127.7 0V-9.2H139.8V-37.1Q139.8 -40.4 136.6 -40.4H128.7V-49.6H140.6Q144.7 -49.6 147.3 -47.2Q149.9 -44.9 149.9 -40.7V-39.5H150.4Q151.5 -45.1 155.2 -48Q158.8 -50.8 165.8 -50.8H173.5V-39.6H162.7Q156.8 -39.6 153.6 -35.5Q150.4 -31.4 150.4 -25.7V-9.2H165.8V0Z"></path><path fill="#ffffff" d="M210 1.2Q202.9 1.2 197.3 -2Q191.7 -5.2 188.5 -11.1Q185.3 -16.9 185.3 -24.8Q185.3 -32.7 188.5 -38.6Q191.7 -44.4 197.3 -47.6Q202.9 -50.8 210.1 -50.8Q217.3 -50.8 222.9 -47.6Q228.4 -44.4 231.6 -38.6Q234.7 -32.7 234.7 -24.8Q234.7 -16.9 231.5 -11.1Q228.3 -5.2 222.8 -2Q217.2 1.2 210 1.2ZM210 -8.9Q213.8 -8.9 217 -10.6Q220.2 -12.3 222.1 -15.9Q224.1 -19.4 224.1 -24.8Q224.1 -30.3 222.1 -33.8Q220.2 -37.3 217.1 -39Q213.9 -40.7 210.1 -40.7Q206.3 -40.7 203.1 -39Q199.9 -37.3 197.9 -33.8Q196 -30.3 196 -24.8Q196 -16.6 200.2 -12.8Q204.3 -8.9 210 -8.9Z"></path><path fill="#00dbff" d="M268.7 1.2Q262.1 1.2 257.1 -1.4Q252.1 -4 249.1 -8.4Q246.1 -12.9 245.5 -18.5H255.7Q256.7 -13.8 260.1 -11.1Q263.5 -8.4 268.7 -8.4Q276 -8.4 280.5 -14.8Q285 -21.1 285.7 -34.6H285Q282.5 -30.4 278.6 -27.7Q274.7 -25 267.5 -25Q261.5 -25 256.5 -27.9Q251.5 -30.7 248.5 -35.8Q245.5 -40.9 245.5 -47.6Q245.5 -54 248.4 -59.4Q251.3 -64.7 256.6 -68Q261.8 -71.2 269 -71.2Q278.2 -71.2 284.1 -67.1Q290 -62.9 292.9 -55.4Q295.7 -47.8 295.7 -37.5Q295.7 -25.9 292.5 -17.2Q289.4 -8.5 283.4 -3.6Q277.3 1.2 268.7 1.2ZM269.7 -34.5Q275.9 -34.5 279.6 -38.4Q283.4 -42.2 283.4 -48Q283.4 -53.9 279.6 -57.8Q275.9 -61.6 269.7 -61.6Q263.5 -61.6 259.8 -57.8Q256 -54 256 -48.1Q256 -42.2 259.8 -38.4Q263.5 -34.5 269.7 -34.5Z"></path><path fill="#ffffff" d="M330.4 1.2Q320.6 1.2 314.8 -3.4Q309 -8 308.2 -15.6H319.1Q319.7 -12.1 322.6 -9.9Q325.6 -7.7 330.5 -7.7Q335.2 -7.7 337.8 -9.7Q340.3 -11.6 340.3 -14.2Q340.3 -18 337.2 -19.4Q334.2 -20.8 328.3 -21.5Q323.2 -22.1 319 -23.9Q314.9 -25.6 312.5 -28.7Q310.1 -31.7 310.1 -36.3Q310.1 -42.8 315.2 -46.8Q320.3 -50.8 329.4 -50.8Q338.5 -50.8 343.5 -46.7Q348.5 -42.6 349.3 -35.5H339.1Q338.7 -38.5 336 -40.2Q333.3 -42 329.3 -42Q325.2 -42 322.8 -40.5Q320.4 -38.9 320.4 -36.4Q320.4 -31 332 -29.8Q337.5 -29.2 341.8 -27.8Q346.1 -26.3 348.6 -23.2Q351.1 -20.2 351.1 -14.7Q351.2 -10.2 348.5 -6.6Q345.9 -3 341.2 -0.9Q336.6 1.2 330.4 1.2Z"></path><path fill="#ffffff" d="M395.4 0Q388.1 0 383.8 -3.6Q379.5 -7.1 379.5 -16.2V-40.6H367V-49.6H374.4Q379.5 -49.6 380.4 -54.6L381.9 -62.6H390.1V-49.6H409.7V-40.6H390.1V-16.4Q390.1 -12.5 391.9 -10.9Q393.6 -9.4 397.9 -9.4H409.5V0Z"></path><path fill="#ffffff" d="M445.5 1.2Q439.6 1.2 435.6 -0.9Q431.6 -2.9 429.6 -6.4Q427.6 -9.8 427.6 -13.9Q427.6 -21.2 433 -25.3Q438.3 -29.4 448.1 -29.4H460.9V-30.5Q460.9 -41.7 450.5 -41.7Q446.2 -41.7 443.2 -39.9Q440.3 -38 439.3 -33.9H428.7Q429.5 -41.7 435.4 -46.2Q441.4 -50.8 450.5 -50.8Q461.5 -50.8 466.5 -45.4Q471.5 -40 471.5 -30.5V0H462.5L461.6 -7.3H460.9Q458.7 -3.8 455.4 -1.3Q452.1 1.2 445.5 1.2ZM447.5 -7.7Q454 -7.7 457.2 -11.7Q460.5 -15.6 460.8 -21.7H449.2Q443.5 -21.7 441.1 -19.9Q438.8 -18 438.8 -14.7Q438.8 -11.4 441.1 -9.6Q443.5 -7.7 447.5 -7.7Z"></path><path fill="#ffffff" d="M510.7 1.2Q503.8 1.2 498.4 -2Q492.9 -5.2 489.8 -11.1Q486.7 -16.9 486.7 -24.8Q486.7 -32.7 489.9 -38.5Q493 -44.3 498.4 -47.6Q503.8 -50.8 510.7 -50.8Q520.2 -50.8 526 -46.1Q531.9 -41.3 533.5 -33H522.4Q521.4 -36.6 518.3 -38.7Q515.3 -40.8 510.6 -40.8Q507.2 -40.8 504.1 -39Q501.1 -37.2 499.2 -33.7Q497.4 -30.1 497.4 -24.8Q497.4 -19.6 499.2 -16Q501.1 -12.4 504.1 -10.6Q507.2 -8.7 510.6 -8.7Q515.4 -8.7 518.3 -10.8Q521.2 -12.9 522.4 -16.6H533.5Q531.5 -8.4 525.7 -3.6Q519.9 1.2 510.7 1.2Z"></path><path fill="#ffffff" d="M549.8 0V-72H560.4V-28.8L579.4 -49.6H592.7L572 -27.6V-26.8L595.4 0H582.5L560.4 -25.5V0Z"></path></svg>
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.0 -78.0 612.0 85.2" role="img" aria-label="roro9stack"><path fill="#000055" d="M7.7 0V-9.2H19.8V-37.1Q19.8 -40.4 16.6 -40.4H8.7V-49.6H20.6Q24.7 -49.6 27.3 -47.2Q29.9 -44.9 29.9 -40.7V-39.5H30.4Q31.5 -45.1 35.2 -48Q38.8 -50.8 45.8 -50.8H53.5V-39.6H42.7Q36.8 -39.6 33.6 -35.5Q30.4 -31.4 30.4 -25.7V-9.2H45.8V0Z"></path><path fill="#000055" d="M90 1.2Q82.9 1.2 77.3 -2Q71.7 -5.2 68.5 -11.1Q65.3 -16.9 65.3 -24.8Q65.3 -32.7 68.5 -38.6Q71.7 -44.4 77.3 -47.6Q82.9 -50.8 90.1 -50.8Q97.3 -50.8 102.9 -47.6Q108.4 -44.4 111.6 -38.6Q114.7 -32.7 114.7 -24.8Q114.7 -16.9 111.5 -11.1Q108.3 -5.2 102.8 -2Q97.2 1.2 90 1.2ZM90 -8.9Q93.8 -8.9 97 -10.6Q100.2 -12.3 102.2 -15.9Q104.1 -19.4 104.1 -24.8Q104.1 -30.3 102.2 -33.8Q100.2 -37.3 97.1 -39Q93.9 -40.7 90.1 -40.7Q86.3 -40.7 83.1 -39Q79.9 -37.3 78 -33.8Q76 -30.3 76 -24.8Q76 -16.6 80.2 -12.8Q84.3 -8.9 90 -8.9Z"></path><path fill="#000055" d="M127.7 0V-9.2H139.8V-37.1Q139.8 -40.4 136.6 -40.4H128.7V-49.6H140.6Q144.7 -49.6 147.3 -47.2Q149.9 -44.9 149.9 -40.7V-39.5H150.4Q151.5 -45.1 155.2 -48Q158.8 -50.8 165.8 -50.8H173.5V-39.6H162.7Q156.8 -39.6 153.6 -35.5Q150.4 -31.4 150.4 -25.7V-9.2H165.8V0Z"></path><path fill="#000055" d="M210 1.2Q202.9 1.2 197.3 -2Q191.7 -5.2 188.5 -11.1Q185.3 -16.9 185.3 -24.8Q185.3 -32.7 188.5 -38.6Q191.7 -44.4 197.3 -47.6Q202.9 -50.8 210.1 -50.8Q217.3 -50.8 222.9 -47.6Q228.4 -44.4 231.6 -38.6Q234.7 -32.7 234.7 -24.8Q234.7 -16.9 231.5 -11.1Q228.3 -5.2 222.8 -2Q217.2 1.2 210 1.2ZM210 -8.9Q213.8 -8.9 217 -10.6Q220.2 -12.3 222.1 -15.9Q224.1 -19.4 224.1 -24.8Q224.1 -30.3 222.1 -33.8Q220.2 -37.3 217.1 -39Q213.9 -40.7 210.1 -40.7Q206.3 -40.7 203.1 -39Q199.9 -37.3 197.9 -33.8Q196 -30.3 196 -24.8Q196 -16.6 200.2 -12.8Q204.3 -8.9 210 -8.9Z"></path><path fill="#0092aa" d="M268.7 1.2Q262.1 1.2 257.1 -1.4Q252.1 -4 249.1 -8.4Q246.1 -12.9 245.5 -18.5H255.7Q256.7 -13.8 260.1 -11.1Q263.5 -8.4 268.7 -8.4Q276 -8.4 280.5 -14.8Q285 -21.1 285.7 -34.6H285Q282.5 -30.4 278.6 -27.7Q274.7 -25 267.5 -25Q261.5 -25 256.5 -27.9Q251.5 -30.7 248.5 -35.8Q245.5 -40.9 245.5 -47.6Q245.5 -54 248.4 -59.4Q251.3 -64.7 256.6 -68Q261.8 -71.2 269 -71.2Q278.2 -71.2 284.1 -67.1Q290 -62.9 292.9 -55.4Q295.7 -47.8 295.7 -37.5Q295.7 -25.9 292.5 -17.2Q289.4 -8.5 283.4 -3.6Q277.3 1.2 268.7 1.2ZM269.7 -34.5Q275.9 -34.5 279.6 -38.4Q283.4 -42.2 283.4 -48Q283.4 -53.9 279.6 -57.8Q275.9 -61.6 269.7 -61.6Q263.5 -61.6 259.8 -57.8Q256 -54 256 -48.1Q256 -42.2 259.8 -38.4Q263.5 -34.5 269.7 -34.5Z"></path><path fill="#000055" d="M330.4 1.2Q320.6 1.2 314.8 -3.4Q309 -8 308.2 -15.6H319.1Q319.7 -12.1 322.6 -9.9Q325.6 -7.7 330.5 -7.7Q335.2 -7.7 337.8 -9.7Q340.3 -11.6 340.3 -14.2Q340.3 -18 337.2 -19.4Q334.2 -20.8 328.3 -21.5Q323.2 -22.1 319 -23.9Q314.9 -25.6 312.5 -28.7Q310.1 -31.7 310.1 -36.3Q310.1 -42.8 315.2 -46.8Q320.3 -50.8 329.4 -50.8Q338.5 -50.8 343.5 -46.7Q348.5 -42.6 349.3 -35.5H339.1Q338.7 -38.5 336 -40.2Q333.3 -42 329.3 -42Q325.2 -42 322.8 -40.5Q320.4 -38.9 320.4 -36.4Q320.4 -31 332 -29.8Q337.5 -29.2 341.8 -27.8Q346.1 -26.3 348.6 -23.2Q351.1 -20.2 351.1 -14.7Q351.2 -10.2 348.5 -6.6Q345.9 -3 341.2 -0.9Q336.6 1.2 330.4 1.2Z"></path><path fill="#000055" d="M395.4 0Q388.1 0 383.8 -3.6Q379.5 -7.1 379.5 -16.2V-40.6H367V-49.6H374.4Q379.5 -49.6 380.4 -54.6L381.9 -62.6H390.1V-49.6H409.7V-40.6H390.1V-16.4Q390.1 -12.5 391.9 -10.9Q393.6 -9.4 397.9 -9.4H409.5V0Z"></path><path fill="#000055" d="M445.5 1.2Q439.6 1.2 435.6 -0.9Q431.6 -2.9 429.6 -6.4Q427.6 -9.8 427.6 -13.9Q427.6 -21.2 433 -25.3Q438.3 -29.4 448.1 -29.4H460.9V-30.5Q460.9 -41.7 450.5 -41.7Q446.2 -41.7 443.2 -39.9Q440.3 -38 439.3 -33.9H428.7Q429.5 -41.7 435.4 -46.2Q441.4 -50.8 450.5 -50.8Q461.5 -50.8 466.5 -45.4Q471.5 -40 471.5 -30.5V0H462.5L461.6 -7.3H460.9Q458.7 -3.8 455.4 -1.3Q452.1 1.2 445.5 1.2ZM447.5 -7.7Q454 -7.7 457.2 -11.7Q460.5 -15.6 460.8 -21.7H449.2Q443.5 -21.7 441.1 -19.9Q438.8 -18 438.8 -14.7Q438.8 -11.4 441.1 -9.6Q443.5 -7.7 447.5 -7.7Z"></path><path fill="#000055" d="M510.7 1.2Q503.8 1.2 498.4 -2Q492.9 -5.2 489.8 -11.1Q486.7 -16.9 486.7 -24.8Q486.7 -32.7 489.9 -38.5Q493 -44.3 498.4 -47.6Q503.8 -50.8 510.7 -50.8Q520.2 -50.8 526 -46.1Q531.9 -41.3 533.5 -33H522.4Q521.4 -36.6 518.3 -38.7Q515.3 -40.8 510.6 -40.8Q507.2 -40.8 504.1 -39Q501.1 -37.2 499.2 -33.7Q497.4 -30.1 497.4 -24.8Q497.4 -19.6 499.2 -16Q501.1 -12.4 504.1 -10.6Q507.2 -8.7 510.6 -8.7Q515.4 -8.7 518.3 -10.8Q521.2 -12.9 522.4 -16.6H533.5Q531.5 -8.4 525.7 -3.6Q519.9 1.2 510.7 1.2Z"></path><path fill="#000055" d="M549.8 0V-72H560.4V-28.8L579.4 -49.6H592.7L572 -27.6V-26.8L595.4 0H582.5L560.4 -25.5V0Z"></path></svg>
@@ -0,0 +1,69 @@
+// The Install page: asks the project's Gitea for the latest release, and gives ESP Web Tools a
+// manifest for its factory image, built here, so the page offers a new release as soon as it exists
+// and nothing is copied to this site (docs/milestones/W1.md, Q180). Gitea sits behind Caddy, which
+// allows this origin to read the release API and the downloads.
+(function () {
+  var box = document.getElementById("flasher");
+  if (!box) return;
+  var $ = function (id) { return document.getElementById(id); };
+  var status = $("flasher-status");
+  var apiOrigin = new URL(box.dataset.api).origin;
+  var downloads = box.dataset.releasesPath;
+
+  // A network error (which is also what a browser makes of a missing CORS header) and a release this
+  // page won't offer are different things to tell the visitor.
+  function fail(error) {
+    var unreachable = error instanceof TypeError;
+    status.textContent = (unreachable ? "Couldn't reach the release server (" + error.message + ")" : "This page can't offer the latest release (" + error.message + ")") +
+      ". Use the esptool steps below, or take the file from the downloads page.";
+    status.className = "msg";
+  }
+  function human(bytes) {
+    return bytes >= 1048576 ? (bytes / 1048576).toFixed(2) + " MB" : Math.round(bytes / 1024) + " KB";
+  }
+  // Only a download from the project's own server, for this repository, is ever handed to the flasher.
+  function trusted(url) {
+    try {
+      var u = new URL(url);
+      return u.origin === apiOrigin && u.pathname.indexOf(downloads) === 0 && u.pathname.indexOf("..") < 0 && !u.search;
+    } catch (e) { return false; }
+  }
+
+  fetch(box.dataset.api + "/releases/latest", { headers: { Accept: "application/json" } })
+    .then(function (r) {
+      if (!r.ok) throw new Error("answer " + r.status);
+      return r.json();
+    })
+    .then(function (rel) {
+      var assets = rel.assets || [];
+      var bin = assets.filter(function (a) { return /-factory\.bin$/.test(a.name); })[0];
+      if (!bin) throw new Error("the latest release has no factory image");
+      if (!trusted(bin.browser_download_url)) throw new Error("its download isn't on the project's server");
+      var sums = assets.filter(function (a) { return a.name === "SHA256SUMS" && trusted(a.browser_download_url); })[0];
+
+      $("f-version").textContent = rel.tag_name;
+      $("f-size").textContent = human(bin.size);
+      if (rel.html_url) $("f-link").href = rel.html_url;
+      var manifest = {
+        name: "roro9stack",
+        version: rel.tag_name,
+        builds: [{ chipFamily: "ESP32-S3", parts: [{ path: bin.browser_download_url, offset: 0 }] }]
+      };
+      var url = URL.createObjectURL(new Blob([JSON.stringify(manifest)], { type: "application/json" }));
+      var button = $("f-button");
+      button.setAttribute("manifest", url);
+      button.hidden = false;
+      $("flasher-info").hidden = false;
+      status.textContent = "Latest release: " + rel.tag_name + ".";
+
+      if (!sums) { $("f-sha").textContent = "not published"; return; }
+      return fetch(sums.browser_download_url)
+        .then(function (r) { return r.ok ? r.text() : ""; })
+        .then(function (text) {
+          var line = text.split("\n").filter(function (l) { return l.indexOf(bin.name) >= 0; })[0];
+          $("f-sha").textContent = line ? line.split(/\s+/)[0] : "not listed";
+        })
+        .catch(function () { $("f-sha").textContent = "unavailable"; });
+    })
+    .catch(fail);
+})();
@@ -0,0 +1,30 @@
+// The theme switch. Without JavaScript the page follows the visitor's setting (prefers-color-scheme);
+// this adds a button that overrides it, remembered in this browser only.
+(function () {
+  var root = document.documentElement;
+  root.classList.add("js");
+  try {
+    var saved = localStorage.getItem("theme");
+    if (saved === "dark" || saved === "light") root.setAttribute("data-theme", saved);
+  } catch (e) { /* storage blocked: the setting just isn't remembered */ }
+
+  document.addEventListener("DOMContentLoaded", function () {
+    var button = document.getElementById("theme-toggle");
+    if (!button) return;
+    function current() {
+      return root.getAttribute("data-theme") || (window.matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark");
+    }
+    function show() {
+      var next = current() === "dark" ? "light" : "dark";
+      button.textContent = next === "light" ? "Light" : "Dark";
+      button.setAttribute("aria-label", "Switch to the " + next + " theme");
+    }
+    button.addEventListener("click", function () {
+      var next = current() === "dark" ? "light" : "dark";
+      root.setAttribute("data-theme", next);
+      try { localStorage.setItem("theme", next); } catch (e) { /* see above */ }
+      show();
+    });
+    show();
+  });
+})();
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://roro9stack.net/sitemap.xml
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
@@ -0,0 +1,9 @@
+ESP Web Tools 10.4.0 (https://github.com/esphome/esp-web-tools), Apache-2.0 (see LICENSE),
+vendored so the Install page makes no request to a CDN.
+
+Only the files an ESP32-S3 needs (the Cardputer ADV): install-button.js, its chunks, and the S3
+flasher stub. The other chip families' chunks are loaded only if such a chip is detected, which this
+page's manifest never asks for.
+
+Updating: `npm pack esp-web-tools`, then copy the same set from package/dist/web/ (the chunk file
+names carry a hash and change with the version) and update the references in this README.
@@ -0,0 +1 @@
+import{ESP32ROM as t}from"./esp32-DNPRK0Ay.js";import"./install-dialog-im156JnI.js";import"./styles-sT2V1cOw.js";class i extends t{constructor(){super(...arguments),this.CHIP_NAME="ESP32-S3",this.IMAGE_CHIP_ID=9,this.EFUSE_BASE=1610641408,this.MAC_EFUSE_REG=this.EFUSE_BASE+68,this.EFUSE_BLOCK1_ADDR=this.EFUSE_BASE+68,this.EFUSE_BLOCK2_ADDR=this.EFUSE_BASE+92,this.UART_CLKDIV_REG=1610612756,this.UART_CLKDIV_MASK=1048575,this.UART_DATE_REG_ADDR=1610612864,this.FLASH_WRITE_SIZE=1024,this.BOOTLOADER_FLASH_OFFSET=0,this.SPI_REG_BASE=1610620928,this.SPI_USR_OFFS=24,this.SPI_USR1_OFFS=28,this.SPI_USR2_OFFS=32,this.SPI_MOSI_DLEN_OFFS=36,this.SPI_MISO_DLEN_OFFS=40,this.SPI_W0_OFFS=88,this.USB_RAM_BLOCK=2048,this.UARTDEV_BUF_NO_USB=3,this.UARTDEV_BUF_NO=1070526796,this.IROM_MAP_START=1107296256,this.IROM_MAP_END=1140850688,this.MEMORY_MAP=[[0,65536,"PADDING"],[1006632960,1023410176,"DROM"],[1023410176,1040187392,"EXTRAM_DATA"],[1611653120,1611661312,"RTC_DRAM"],[1070104576,1070596096,"BYTE_ACCESSIBLE"],[1070104576,1077813248,"MEM_INTERNAL"],[1070104576,1070596096,"DRAM"],[1073741824,1073848576,"IROM_MASK"],[1077346304,1077805056,"IRAM"],[1611653120,1611661312,"RTC_IRAM"],[1107296256,1115684864,"IROM"],[1342177280,1342185472,"RTC_DATA"]]}async getChipDescription(t){const i=await this.getMajorChipVersion(t),s=await this.getMinorChipVersion(t);return`${{0:"ESP32-S3 (QFN56)",1:"ESP32-S3-PICO-1 (LGA56)"}[await this.getPkgVersion(t)]||"unknown ESP32-S3"} (revision v${i}.${s})`}async getPkgVersion(t){return await t.readReg(this.EFUSE_BLOCK1_ADDR+12)>>21&7}async getRawMinorChipVersion(t){return((await t.readReg(this.EFUSE_BLOCK1_ADDR+20)>>23&1)<<3)+(await t.readReg(this.EFUSE_BLOCK1_ADDR+12)>>18&7)}async getMinorChipVersion(t){const i=await this.getRawMinorChipVersion(t);return await this.isEco0(t,i)?0:this.getRawMinorChipVersion(t)}async getRawMajorChipVersion(t){return await t.readReg(this.EFUSE_BLOCK1_ADDR+20)>>24&3}async getMajorChipVersion(t){const i=await this.getRawMinorChipVersion(t);return await this.isEco0(t,i)?0:this.getRawMajorChipVersion(t)}async getBlkVersionMajor(t){return await t.readReg(this.EFUSE_BLOCK2_ADDR+16)>>0&3}async getBlkVersionMinor(t){return await t.readReg(this.EFUSE_BLOCK1_ADDR+12)>>24&7}async isEco0(t,i){return 0==(7&i)&&1===await this.getBlkVersionMajor(t)&&1===await this.getBlkVersionMinor(t)}async getFlashCap(t){const i=this.EFUSE_BASE+68+12;return await t.readReg(i)>>27&7}async getFlashVendor(t){const i=this.EFUSE_BASE+68+16;return{1:"XMC",2:"GD",3:"FM",4:"TT",5:"BY"}[await t.readReg(i)>>0&7]||""}async getPsramCap(t){const i=this.EFUSE_BASE+68+16;return await t.readReg(i)>>3&3}async getPsramVendor(t){const i=this.EFUSE_BASE+68+16;return{1:"AP_3v3",2:"AP_1v8"}[await t.readReg(i)>>7&3]||""}async getChipFeatures(t){const i=["Wi-Fi","BLE"],s=await this.getFlashCap(t),e=await this.getFlashVendor(t),a={0:null,1:"Embedded Flash 8MB",2:"Embedded Flash 4MB"}[s],r=void 0!==a?a:"Unknown Embedded Flash";null!==a&&i.push(`${r} (${e})`);const n=await this.getPsramCap(t),_=await this.getPsramVendor(t),h={0:null,1:"Embedded PSRAM 8MB",2:"Embedded PSRAM 2MB"}[n],E=void 0!==h?h:"Unknown Embedded PSRAM";return null!==h&&i.push(`${E} (${_})`),i}async getCrystalFreq(t){return 40}_d2h(t){const i=(+t).toString(16);return 1===i.length?"0"+i:i}async postConnect(t){const i=255&await t.readReg(this.UARTDEV_BUF_NO);t.debug("In _post_connect "+i),i==this.UARTDEV_BUF_NO_USB&&(t.ESP_RAM_BLOCK=this.USB_RAM_BLOCK)}async readMac(t){let i=await t.readReg(this.MAC_EFUSE_REG);i>>>=0;let s=await t.readReg(this.MAC_EFUSE_REG+4);s=s>>>0&65535;const e=new Uint8Array(6);return e[0]=s>>8&255,e[1]=255&s,e[2]=i>>24&255,e[3]=i>>16&255,e[4]=i>>8&255,e[5]=255&i,this._d2h(e[0])+":"+this._d2h(e[1])+":"+this._d2h(e[2])+":"+this._d2h(e[3])+":"+this._d2h(e[4])+":"+this._d2h(e[5])}getEraseSize(t,i){return i}}export{i as ESP32S3ROM};
@@ -0,0 +1,129 @@
+import{w as e,y as t,a as o,_ as i,t as l,i as n,x as a}from"./styles-sT2V1cOw.js";const s=e`
+  <svg
+    version="1.1"
+    id="Capa_1"
+    xmlns="http://www.w3.org/2000/svg"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    x="0px"
+    y="0px"
+    viewBox="0 0 510.322 510.322"
+    xml:space="preserve"
+    style="width: 28px; vertical-align: middle;"
+  >
+    <g>
+      <path
+        style="fill:currentColor;"
+        d="M429.064,159.505c0-0.151,0.086-1.057,0.086-1.057c0-75.282-61.261-136.521-136.543-136.521    c-52.244,0-97.867,30.587-120.753,76.339c-11.67-9.081-25.108-15.682-40.273-15.682c-37.166,0-67.387,30.199-67.387,67.387    c0,0,0.453,3.279,0.798,5.824C27.05,168.716,0,203.423,0,244.516c0,25.389,9.901,49.268,27.848,67.171    c17.968,17.99,41.804,27.869,67.193,27.869h130.244v46.83h-54.66l97.694,102.008l95.602-102.008h-54.66v-46.83H419.25    c50.174,0,91.072-40.855,91.072-90.986C510.3,201.827,474.428,164.639,429.064,159.505z M419.207,312.744H309.26v-55.545h-83.975    v55.545H95.019c-18.184,0-35.333-7.075-48.211-19.996c-12.878-12.878-19.953-30.005-19.953-48.189    c0-32.68,23.21-60.808,55.264-66.956l12.511-2.394l-2.092-14.431l-1.488-10.785c0-22.347,18.184-40.51,40.531-40.51    c13.266,0,25.691,6.514,33.305,17.408l15.229,21.873l8.52-25.303c15.013-44.652,56.796-74.656,103.906-74.656    c60.506,0,109.709,49.203,109.709,109.644l-1.337,25.712l15.121,0.302l3.149-0.086c35.419,0,64.216,28.797,64.216,64.216    C483.401,283.969,454.604,312.744,419.207,312.744z"
+      />
+    </g>
+  </svg>
+`;let r=class extends n{render(){const e=(()=>{var e,t;const o=window.navigator.userAgent,i=(null===(t=null===(e=window.navigator)||void 0===e?void 0:e.userAgentData)||void 0===t?void 0:t.platform)||window.navigator.platform;return-1!==["macOS","Macintosh","MacIntel","MacPPC","Mac68K"].indexOf(i)?"Mac OS":-1!==["iPhone","iPad","iPod"].indexOf(i)?"iOS":-1!==["Win32","Win64","Windows","WinCE"].indexOf(i)?"Windows":/Android/.test(o)?"Android":/Linux/.test(i)?"Linux":null})();return a`
+      <ew-dialog open @closed=${this._handleClose}>
+        <div slot="headline">No port selected</div>
+        <div slot="content">
+          <div>
+            If you didn't select a port because you didn't see your device
+            listed, try the following steps:
+          </div>
+          <ol>
+            <li>
+              Make sure that the device is connected to this computer (the one
+              that runs the browser that shows this website)
+            </li>
+            <li>
+              Most devices have a tiny light when it is powered on. If yours has
+              one, make sure it is on.
+            </li>
+            <li>
+              Make sure that the USB cable you use can be used for data and is
+              not a power-only cable.
+            </li>
+            ${"Linux"===e?a`
+                  <li>
+                    If you are using a Linux flavor, make sure that your user is
+                    part of the <code>dialout</code> group so it has permission
+                    to access the device.
+                    <code class="block"
+                      >sudo usermod -a -G dialout YourUserName</code
+                    >
+                    You may need to log out & back in or reboot to activate the
+                    new group access.
+                  </li>
+                `:""}
+            <li>
+              Make sure you have the right drivers installed. Below are the
+              drivers for common chips used in ESP devices:
+              <ul>
+                <li>
+                  CP2102 drivers:
+                  <a
+                    href="https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers"
+                    target="_blank"
+                    rel="noopener"
+                    >Windows & Mac</a
+                  >
+                </li>
+                <li>
+                  CH342, CH343, CH9102 drivers:
+                  <a
+                    href="https://www.wch.cn/downloads/CH343SER_ZIP.html"
+                    target="_blank"
+                    rel="noopener"
+                    >Windows</a
+                  >,
+                  <a
+                    href="https://www.wch.cn/downloads/CH34XSER_MAC_ZIP.html"
+                    target="_blank"
+                    rel="noopener"
+                    >Mac</a
+                  >
+                  <br />
+                  (download via blue button with ${s} icon)
+                </li>
+                <li>
+                  CH340, CH341 drivers:
+                  <a
+                    href="https://www.wch.cn/downloads/CH341SER_ZIP.html"
+                    target="_blank"
+                    rel="noopener"
+                    >Windows</a
+                  >,
+                  <a
+                    href="https://www.wch.cn/downloads/CH341SER_MAC_ZIP.html"
+                    target="_blank"
+                    rel="noopener"
+                    >Mac</a
+                  >
+                  <br />
+                  (download via blue button with ${s} icon)
+                </li>
+              </ul>
+            </li>
+          </ol>
+        </div>
+        <div slot="actions">
+          ${this.doTryAgain?a`
+                <ew-text-button @click=${this.close}>Cancel</ew-text-button>
+                <ew-text-button @click=${this.tryAgain}>
+                  Try Again
+                </ew-text-button>
+              `:a`
+                <ew-text-button @click=${this.close}>Close</ew-text-button>
+              `}
+        </div>
+      </ew-dialog>
+    `}tryAgain(){var e;this.close(),null===(e=this.doTryAgain)||void 0===e||e.call(this)}close(){this.shadowRoot.querySelector("ew-dialog").close()}async _handleClose(){this.parentNode.removeChild(this)}};r.styles=[t,o`
+      li + li,
+      li > ul {
+        margin-top: 8px;
+      }
+      ul,
+      ol {
+        margin-bottom: 0;
+        padding-left: 1.5em;
+      }
+      li code.block {
+        display: block;
+        margin: 0.5em 0;
+      }
+    `],r=i([l("ewt-no-port-picked-dialog")],r);const d=async e=>{const t=document.createElement("ewt-no-port-picked-dialog");return t.doTryAgain=e,document.body.append(t),!0};export{d as openNoPortPickedDialog};
@@ -0,0 +1 @@
+const e=async t=>{let o;import("./install-dialog-im156JnI.js").then((function(e){return e.i}));try{o=await navigator.serial.requestPort()}catch(o){return"NotFoundError"===o.name?void import("./index-Dt9w-IG1.js").then((o=>o.openNoPortPickedDialog((()=>e(t))))):void alert(`Error: ${o.message}`)}if(!o)return;try{await o.open({baudRate:115200,bufferSize:8192})}catch(e){return void alert(e.message)}const n=document.createElement("ewt-install-dialog");n.port=o,n.manifestPath=t.manifest||t.getAttribute("manifest"),n.overrides=t.overrides,n.addEventListener("closed",(()=>{o.close()}),{once:!0}),document.body.appendChild(n)};class t extends HTMLElement{connectedCallback(){if(this.renderRoot)return;if(this.renderRoot=this.attachShadow({mode:"open"}),!t.isSupported||!t.isAllowed)return this.toggleAttribute("install-unsupported",!0),void(this.renderRoot.innerHTML=t.isAllowed?"<slot name='unsupported'>Your browser does not support installing things on ESP devices. Use Mozilla Firefox, Google Chrome or Microsoft Edge.</slot>":"<slot name='not-allowed'>You can only install ESP devices on HTTPS websites or on the localhost.</slot>");this.toggleAttribute("install-supported",!0);const o=document.createElement("slot");o.addEventListener("click",(async t=>{t.preventDefault(),e(this)})),o.name="activate";const n=document.createElement("button");if(n.innerText="Connect",o.append(n),"adoptedStyleSheets"in Document.prototype&&"replaceSync"in CSSStyleSheet.prototype){const e=new CSSStyleSheet;e.replaceSync(t.style),this.renderRoot.adoptedStyleSheets=[e]}else{const e=document.createElement("style");e.innerText=t.style,this.renderRoot.append(e)}this.renderRoot.append(o)}}t.isSupported="serial"in navigator,t.isAllowed=window.isSecureContext,t.style='\n  button {\n    position: relative;\n    cursor: pointer;\n    font-size: 14px;\n    font-weight: 500;\n    padding: 10px 24px;\n    color: var(--esp-tools-button-text-color, #fff);\n    background-color: var(--esp-tools-button-color, #03a9f4);\n    border: none;\n    border-radius: var(--esp-tools-button-border-radius, 9999px);\n  }\n  button::before {\n    content: " ";\n    position: absolute;\n    top: 0;\n    bottom: 0;\n    left: 0;\n    right: 0;\n    opacity: 0.2;\n    border-radius: var(--esp-tools-button-border-radius, 9999px);\n  }\n  button:hover::before {\n    background-color: rgba(255,255,255,.8);\n  }\n  button:focus {\n    outline: none;\n  }\n  button:focus::before {\n    background-color: white;\n  }\n  button:active::before {\n    background-color: grey;\n  }\n  :host([active]) button {\n    color: rgba(0, 0, 0, 0.38);\n    background-color: rgba(0, 0, 0, 0.12);\n    box-shadow: none;\n    cursor: unset;\n    pointer-events: none;\n  }\n  .hidden {\n    display: none;\n  }',customElements.define("esp-web-install-button",t);
@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+{% block title %}Not found: roro9stack{% endblock %}
+{% block main %}
+<div class="wrap page">
+  <h1>Not found.</h1>
+  <p class="prose">There's no page here. Try <a href="/">the home page</a>, <a href="/install/">Install</a> or <a href="/downloads/">Downloads</a>.</p>
+</div>
+{% endblock main %}
@@ -0,0 +1,62 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{% block title %}roro9stack: open firmware for the Cardputer ADV{% endblock %}</title>
+<meta name="description" content="{% block description %}{{ config.description }}{% endblock %}">
+<meta name="color-scheme" content="dark light">
+<meta name="author" content="Clément Martin">
+<meta name="copyright" content="© 2026 Clément Martin">
+{% if current_url %}<link rel="canonical" href="{{ current_url }}">{% endif %}
+<link rel="icon" href="/img/favicon.svg" type="image/svg+xml">
+<link rel="icon" href="/favicon.ico" sizes="32x32 48x48">
+<link rel="apple-touch-icon" href="/apple-touch-icon.png">
+<link rel="preload" href="/fonts/DMMono-Medium.woff2" as="font" type="font/woff2" crossorigin>
+<link rel="preload" href="/fonts/HankenGrotesk.woff2" as="font" type="font/woff2" crossorigin>
+<link rel="stylesheet" href="/css/site.css">
+<script src="/js/theme.js"></script>
+{% block head %}{% endblock %}
+</head>
+<body>
+<a class="skip" href="#main">Skip to the content</a>
+
+<header class="wrap bar">
+  <a class="brand" href="/" aria-label="roro9stack, home">
+    <img class="logo logo-dark" src="/img/logo-dark.svg" alt="roro9stack" width="201" height="28">
+    <img class="logo logo-light" src="/img/logo-light.svg" alt="" width="201" height="28">
+  </a>
+  <nav aria-label="Main">
+    <a href="/#apps">Apps</a>
+    <a href="/install/">Install</a>
+    <a href="/guide/">Guide</a>
+    <a href="/downloads/">Downloads</a>
+    <a href="{{ config.extra.blog }}">Blog</a>
+    <button class="link-btn js-only" id="theme-toggle" type="button">Light</button>
+    <a class="btn btn-primary n-md" href="{{ config.extra.repo }}">Source</a>
+  </nav>
+</header>
+
+<main id="main">
+{% block main %}{% endblock %}
+</main>
+
+<footer>
+  <div class="wrap">
+    <div class="foot-row">
+      <span>© 2026 Clément Martin · Licensed GPL-3.0</span>
+      <nav aria-label="Footer">
+        <a href="{{ config.extra.repo }}">Source</a>
+        <a href="{{ config.extra.repo }}/releases">Releases</a>
+        <a href="{{ config.extra.repo }}/src/branch/main/docs">Docs in the repository</a>
+        <a href="{{ config.extra.repo }}/issues">Issues</a>
+        <a href="{{ config.extra.blog }}">Blog</a>
+        <a href="mailto:{{ config.extra.contact }}">Contact</a>
+      </nav>
+    </div>
+    <small>roro9stack is an independent project. It isn't affiliated with or endorsed by M5Stack or Meshtastic: those names belong to their owners.</small>
+    <small>This site sets no cookies and has no analytics, and its pages load nothing from other sites. The Install page asks the project's own server, git.twis.la, for the latest release. Questions, corrections: <a href="mailto:{{ config.extra.contact }}">{{ config.extra.contact }}</a>, or the issue tracker.</small>
+  </div>
+</footer>
+</body>
+</html>
@@ -0,0 +1,34 @@
+{% extends "base.html" %}
+{% block title %}Downloads: roro9stack{% endblock %}
+{% block description %}{{ page.description }}{% endblock %}
+{% block main %}
+{% set releases = load_data(url=config.extra.api ~ "/releases?limit=30&draft=false&pre-release=false", format="json", required=false) %}
+<div class="wrap page">
+  <header>
+    <span class="eyebrow">Downloads</span>
+    <h1>{{ page.title }}</h1>
+    <p class="lead">{{ page.description }} To put one on a device, <a class="accent-link" href="/install/">install it from your browser</a>.</p>
+  </header>
+
+  <div class="prose">
+    <p>Each release has a <strong>signed update file</strong> (<code>.ota</code>: copy it to <code>/updates</code> on the SD card and install it from Settings → Firmware or the Storage App, or push it over Wi-Fi), a <strong>factory image</strong> (<code>-factory.bin</code>, the whole flash at offset 0 for a first install over USB), the <strong>symbols</strong> (<code>.elf.gz</code>, to decode a crash report) and <code>SHA256SUMS</code>. Debug Builds aren't published.</p>
+  </div>
+
+  {% if releases %}
+  <div class="releases">
+    {% for r in releases %}
+    <article class="release n-md">
+      <h2>{{ r.tag_name }}</h2>
+      <p class="meta">{{ r.published_at | date(format="%Y-%m-%d") }} · <a class="accent-link" href="{{ r.html_url }}">release notes</a></p>
+      <p>{{ r.body | split(pat="\n\n") | first }}</p>
+      <p class="files">
+        {% for a in r.assets %}<a href="{{ a.browser_download_url }}">{{ a.name }}</a> <span class="muted">({{ a.size | filesizeformat }})</span>{% endfor %}
+      </p>
+    </article>
+    {% endfor %}
+  </div>
+  {% else %}
+  <p class="prose">The list of releases couldn't be read when this page was built. They're all on <a class="accent-link" href="{{ config.extra.repo }}/releases">Gitea</a>.</p>
+  {% endif %}
+</div>
+{% endblock main %}
@@ -0,0 +1,24 @@
+{% extends "base.html" %}
+{% block title %}{{ section.title }}: roro9stack{% endblock %}
+{% block description %}{{ section.description }}{% endblock %}
+{% block main %}
+<div class="wrap page">
+  <header>
+    <span class="eyebrow">User guide</span>
+    <h1>{{ section.title }}</h1>
+    <p class="lead">{{ section.description }}</p>
+  </header>
+
+  <div class="prose">{{ section.content | safe }}</div>
+
+  <div class="cards">
+    {% for p in section.pages %}
+    <article class="card n-lg">
+      <div class="card-top"><span class="tag">{{ p.extra.tag }}</span><span class="num">{% if loop.index < 10 %}0{% endif %}{{ loop.index }}</span></div>
+      <h2><a href="{{ p.permalink }}">{{ p.title }}</a></h2>
+      <p>{{ p.description }}</p>
+    </article>
+    {% endfor %}
+  </div>
+</div>
+{% endblock main %}
@@ -0,0 +1,31 @@
+{% extends "base.html" %}
+{% block title %}{{ page.title }}: roro9stack user guide{% endblock %}
+{% block description %}{{ page.description }}{% endblock %}
+{% block main %}
+{% set screens = load_data(path="data/screens.toml", format="toml") %}
+<div class="wrap page">
+  <header>
+    <span class="eyebrow"><a href="/guide/">User guide</a>{% if page.extra.tag %} · {{ page.extra.tag }}{% endif %}</span>
+    <h1>{{ page.title }}</h1>
+    <p class="lead">{{ page.description }}</p>
+  </header>
+
+  {% if page.extra.screens %}
+  <div class="shots">
+    {% for s in screens.screen %}{% if s.file in page.extra.screens %}
+    <figure class="shot n-md">
+      <img src="/screens/{{ s.file }}" width="480" height="270" alt="{{ s.alt }}" loading="lazy">
+      <figcaption>{{ s.caption }}</figcaption>
+    </figure>
+    {% endif %}{% endfor %}
+  </div>
+  {% endif %}
+
+  <div class="prose">{{ page.content | safe }}</div>
+
+  <nav class="pager" aria-label="User guide">
+    {% if page.lower %}<a class="accent-link" href="{{ page.lower.permalink }}">← {{ page.lower.title }}</a>{% else %}<span></span>{% endif %}
+    {% if page.higher %}<a class="accent-link" href="{{ page.higher.permalink }}">{{ page.higher.title }} →</a>{% endif %}
+  </nav>
+</div>
+{% endblock main %}
@@ -0,0 +1,139 @@
+{% extends "base.html" %}
+{% block main %}
+{% set latest = load_data(url=config.extra.api ~ "/releases/latest", format="json", required=false) %}
+{% set apps = load_data(path="data/apps.toml", format="toml") %}
+{% set screens = load_data(path="data/screens.toml", format="toml") %}
+{% set px = [0,1,1,1,0, 1,0,0,0,1, 1,0,0,0,1, 0,1,1,1,1, 0,0,0,0,1, 0,0,0,0,1, 0,1,1,1,0] %}
+
+<section class="wrap hero" aria-labelledby="hero-title">
+  <div class="hero-grid">
+    <div>
+      <div class="eyebrow-row"><span class="dot"></span><span class="eyebrow">Open firmware · GPL-3.0{% if latest %} · <span class="v">{{ latest.tag_name }}</span>{% endif %}</span></div>
+      <h1 id="hero-title">Open firmware for a <span class="accent">pocket computer.</span></h1>
+    </div>
+    <div>
+      <p class="lead">roro9stack is firmware for the M5Stack Cardputer ADV with the Cap LoRa-1262: a LoRa scanner that reads Meshtastic traffic, GNSS, IRC, a Gemini browser, Wi-Fi tools, notes and more.</p>
+      <div class="actions">
+        <a class="btn btn-primary n-md" href="/install/">Install{% if latest %} {{ latest.tag_name }}{% endif %}</a>
+        <a class="btn btn-secondary n-md" href="{{ config.extra.repo }}">Read the source</a>
+      </div>
+      <ul class="facts">
+        <li>GPL-3.0</li>
+        <li>Docker-only build</li>
+        <li>Signed updates</li>
+      </ul>
+    </div>
+  </div>
+  <div class="slab n-lg">
+    <div class="device">{% include "illustrations/sweep.html" %}</div>
+    <div class="device">{% include "illustrations/sky.html" %}</div>
+  </div>
+  <p class="caption">Drawings of the LoRa Scanner's Sweep view and the GNSS sky view, not screenshots: the real screens are further down.</p>
+</section>
+
+<section class="wrap" aria-labelledby="status-title">
+  <div class="status-box n-md">
+    <h2 id="status-title" class="eyebrow">Where it stands</h2>
+    <p>Early software{% if latest %}, {{ latest.tag_name }}{% endif %}. The radio listens; it doesn't transmit yet. Sending and reading mesh messages is planned and waits for a second node to test with. <a href="{{ config.extra.repo }}/milestones">The milestones</a> show what's done and what's next.</p>
+  </div>
+</section>
+
+<section class="wrap" id="need" aria-labelledby="need-title">
+  <div class="section-head">
+    <span class="eyebrow">Before you start</span>
+    <h2 id="need-title">What you need.</h2>
+  </div>
+  <ul class="need">
+    <li><strong>An M5Stack Cardputer ADV</strong><span>The handheld the firmware runs on.</span></li>
+    <li><strong>The Cap LoRa-1262</strong><span>The LoRa Scanner and GNSS need it. The other Apps don't use it.</span></li>
+    <li><strong>A microSD card</strong><span>For Notes, Storage, Logs, Captures and Tracks.</span></li>
+    <li><strong>Wi-Fi</strong><span>For IRC, Gemini and updates.</span></li>
+    <li><strong>A computer, for the first install</strong><span>Chrome or Edge, and a USB-C cable. After that the device updates itself.</span></li>
+  </ul>
+</section>
+
+<section class="wrap" id="apps" aria-labelledby="apps-title">
+  <div class="section-head">
+    <span class="eyebrow">What's inside</span>
+    <h2 id="apps-title">Apps for the radio, the web and the card.</h2>
+  </div>
+  <div class="cards">
+    {% for a in apps.app %}
+    <article class="card n-lg{% if a.planned %} planned{% endif %}">
+      <div class="ic i{{ a.icon }}" aria-hidden="true"></div>
+      <div class="card-top"><span class="tag">{{ a.tag }}</span><span class="num">{{ a.num }}</span></div>
+      <h3>{{ a.title }}</h3>
+      <p>{{ a.text }}</p>
+      <span class="fact">{{ a.fact }}</span>
+    </article>
+    {% endfor %}
+  </div>
+  <p class="cards-note">Plus Settings, with its Wi-Fi and Firmware pages. Every App has a page in the <a class="accent-link" href="/guide/">user guide</a>.</p>
+</section>
+
+<section class="wrap" id="screens" aria-labelledby="screens-title">
+  <div class="section-head">
+    <span class="eyebrow">On the device</span>
+    <h2 id="screens-title">The real screens.</h2>
+  </div>
+  <div class="shots">
+    {% for s in screens.screen %}
+    <figure class="shot n-md">
+      <img src="/screens/{{ s.file }}" width="480" height="270" alt="{{ s.alt }}" loading="lazy">
+      <figcaption>{{ s.caption }}</figcaption>
+    </figure>
+    {% endfor %}
+  </div>
+</section>
+
+<section class="wrap" id="updates" aria-labelledby="updates-title">
+  <div class="updates n-lg split">
+    <div>
+      <span class="eyebrow">Updates</span>
+      <h2 id="updates-title">Update over Wi-Fi. It rolls back if it fails.</h2>
+      <p class="lead">Install a new release from the project's server in Settings, from the SD card, or push one from your computer. Every update is signed: the device checks the signature before it writes anything, restarts, and runs the new firmware on Probation. If it crashes, or can't reconnect Wi-Fi, it goes back to the previous firmware and says so.</p>
+      <div class="terminal n-md"><span class="p">$</span> scripts/flash.sh --ota 10.39.39.12</div>
+    </div>
+    <div class="aside">
+      <div class="num-row"><span class="big c1">60 s</span><p>The longest the device waits for you to stop typing before it restarts into an update.</p></div>
+      <div class="num-row"><span class="big c2">3 min</span><p>How long new firmware has to reconnect Wi-Fi on Probation before it rolls back.</p></div>
+      <div class="num-row"><span class="big c2">3</span><p>Crash restarts in a row, and it starts in Safe Mode: only Wi-Fi, updates and the Debug Console, so a fix can still be pushed.</p></div>
+    </div>
+  </div>
+</section>
+
+<section class="wrap split" id="build" aria-labelledby="build-title">
+  <div>
+    <span class="eyebrow">Build and flash</span>
+    <h2 id="build-title">Only Docker needed.</h2>
+    <p class="lead">PlatformIO and the ESP32 toolchain run in a container. The first build downloads about 1 GB; after that, builds take under a minute.</p>
+    <p class="muted">If the upload can't connect, hold G0, the button next to the screen, while plugging in USB, then retry.</p>
+    <p>Prefer a ready-made build? <a class="accent-link" href="/install/">Install it from your browser</a>, or take the factory image and the signed update file from <a class="accent-link" href="/downloads/">the downloads</a>.</p>
+  </div>
+  <div class="blocks n-lg">
+    <div class="c"># run the tests, then build</div>
+    <div><span class="p">$</span> scripts/ci.sh</div>
+    <div class="gap"></div>
+    <div class="c"># flash over USB-C</div>
+    <div><span class="p">$</span> scripts/flash.sh</div>
+    <div class="gap"></div>
+    <div class="c"># or update over Wi-Fi</div>
+    <div><span class="p">$</span> scripts/flash.sh --ota 10.39.39.12</div>
+  </div>
+</section>
+
+<section class="wrap" aria-labelledby="cta-title">
+  <div class="cta n-lg">
+    <div>
+      <h2 id="cta-title">Open source, GPL-3.0.</h2>
+      <p>Read the code, flash it, send a patch.</p>
+      <div class="actions">
+        <a class="btn n-md" href="{{ config.extra.repo }}">Source</a>
+        <a class="btn n-md" href="{{ config.extra.repo }}/releases">Releases</a>
+        <a class="btn n-md" href="{{ config.extra.repo }}/issues">Issues</a>
+      </div>
+    </div>
+    <div class="nine" aria-hidden="true">{% for v in px %}<i{% if v == 1 %} class="on"{% endif %}></i>{% endfor %}</div>
+  </div>
+</section>
+{% endblock main %}
@@ -0,0 +1,37 @@
+{% extends "base.html" %}
+{% block title %}Install roro9stack: flash a Cardputer ADV from your browser{% endblock %}
+{% block description %}{{ page.description }}{% endblock %}
+{% block head %}
+<script type="module" src="/vendor/esp-web-tools/install-button.js"></script>
+<script src="/js/install.js" defer></script>
+{% endblock %}
+{% block main %}
+<div class="wrap page">
+  <header>
+    <span class="eyebrow">Install</span>
+    <h1>{{ page.title }}</h1>
+    <p class="lead">{{ page.description }}</p>
+  </header>
+
+  <div class="flasher n-lg" id="flasher" data-api="{{ config.extra.api }}" data-releases-path="/twisla/roro9stack/releases/download/">
+    <h2>Install from your browser</h2>
+    <p id="flasher-status" class="muted" role="status">Looking for the latest release…</p>
+    <dl id="flasher-info" hidden>
+      <dt>Version</dt><dd id="f-version"></dd>
+      <dt>Size</dt><dd id="f-size"></dd>
+      <dt>SHA-256</dt><dd id="f-sha" class="hash"></dd>
+      <dt>Release</dt><dd><a class="accent-link" id="f-link" href="{{ config.extra.repo }}/releases">release notes</a></dd>
+    </dl>
+    <esp-web-install-button id="f-button" hidden>
+      <button slot="activate" class="btn btn-primary n-md" type="button">Install roro9stack</button>
+      <span slot="unsupported" class="msg">This browser can't flash a device. Use Chrome or Edge on a desktop computer, or follow the esptool steps below.</span>
+      <span slot="not-allowed" class="msg">Flashing needs a secure (https) page.</span>
+    </esp-web-install-button>
+    <noscript><p class="msg">Flashing from this page needs JavaScript. Use the esptool steps below.</p></noscript>
+  </div>
+
+  <div class="prose">
+    {{ page.content | safe }}
+  </div>
+</div>
+{% endblock main %}
@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+"""Checks a built site (docs/milestones/W1.md): what the pages promise, kept.
+
+Usage: site/tools/check_site.py <built site folder>
+
+- No page loads anything from another origin: no script, stylesheet, image, font, frame or preload
+  from elsewhere (links a visitor follows are fine).
+- Every page has a title, a description and a language, and every image has an alt attribute.
+- Every file a page references on this site exists.
+"""
+import html.parser
+import os
+import re
+import sys
+import urllib.parse
+
+ROOT = sys.argv[1] if len(sys.argv) > 1 else "public"
+HERE = os.path.dirname(os.path.abspath(__file__))
+BASE = re.search(r'base_url\s*=\s*"([^"]+)"', open(os.path.join(HERE, "..", "config.toml")).read()).group(1)
+HOST = urllib.parse.urlparse(BASE).netloc
+
+
+class Page(html.parser.HTMLParser):
+    def __init__(self):
+        super().__init__()
+        self.title = False
+        self.has_title = False
+        self.has_description = False
+        self.lang = None
+        self.loads = []  # (tag, url) of everything the page fetches by itself
+        self.images_without_alt = 0
+
+    def handle_starttag(self, tag, attrs):
+        a = dict(attrs)
+        if tag == "html":
+            self.lang = a.get("lang")
+        if tag == "title":
+            self.title = True
+        if tag == "meta" and a.get("name") == "description" and a.get("content"):
+            self.has_description = True
+        if tag in ("script", "img", "iframe", "frame", "embed", "source", "video", "audio") and a.get("src"):
+            self.loads.append((tag, a["src"]))
+        if tag == "link" and a.get("href") and a.get("rel", "") in ("stylesheet", "preload", "icon", "modulepreload", "prefetch"):
+            self.loads.append(("link " + a["rel"], a["href"]))
+        if tag == "img" and "alt" not in a:
+            self.images_without_alt += 1
+
+    def handle_data(self, data):
+        if self.title and data.strip():
+            self.has_title = True
+
+    def handle_endtag(self, tag):
+        if tag == "title":
+            self.title = False
+
+
+problems = []
+pages = 0
+for folder, _, files in os.walk(ROOT):
+    for name in files:
+        if not name.endswith(".html"):
+            continue
+        path = os.path.join(folder, name)
+        shown = os.path.relpath(path, ROOT)
+        p = Page()
+        p.feed(open(path, encoding="utf-8").read())
+        pages += 1
+        if not p.has_title: problems.append(f"{shown}: no title")
+        if not p.has_description: problems.append(f"{shown}: no description")
+        if not p.lang: problems.append(f"{shown}: no language")
+        if p.images_without_alt: problems.append(f"{shown}: {p.images_without_alt} image(s) without alt")
+        for tag, url in p.loads:
+            u = urllib.parse.urlparse(url)
+            if u.netloc and u.netloc != HOST:
+                problems.append(f"{shown}: {tag} loads {url} from another origin")
+            elif not u.netloc and not u.scheme:
+                target = os.path.join(ROOT, u.path.lstrip("/")) if u.path.startswith("/") else os.path.join(folder, u.path)
+                if u.path and not os.path.exists(target):
+                    problems.append(f"{shown}: {tag} {url} does not exist")
+            elif u.netloc == HOST:
+                target = os.path.join(ROOT, u.path.lstrip("/"))
+                if not os.path.exists(target):
+                    problems.append(f"{shown}: {tag} {url} does not exist")
+
+if not pages:
+    problems.append(f"no pages found in {ROOT}")
+for p in problems:
+    print("site check:", p)
+print(f"site check: {pages} pages, {len(problems)} problem(s)")
+sys.exit(1 if problems else 0)
@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+"""Draw the pixel "9" of static/img/favicon.svg as PNGs and an ICO, with the standard library.
+
+    python3 site/tools/make_favicons.py
+
+Writes static/favicon.ico (32 and 48 px, PNG inside) and static/apple-touch-icon.png (180 px).
+The 9 is a 7x7 grid, scaled by a whole number and centred on the background colour."""
+import struct
+import zlib
+from pathlib import Path
+
+BG = (0x00, 0x00, 0x55)
+FG = (0x00, 0xDB, 0xFF)
+# x, y, w, h: the same rectangles as favicon.svg
+RECTS = [(1, 0, 3, 1), (0, 1, 1, 2), (4, 1, 1, 5), (1, 3, 3, 1), (0, 6, 3, 1)]
+GRID = 7
+
+STATIC = Path(__file__).resolve().parent.parent / "static"
+
+
+def cells():
+    on = set()
+    for x, y, w, h in RECTS:
+        on.update((x + i, y + j) for i in range(w) for j in range(h))
+    return on
+
+
+def png(size):
+    scale = size // GRID
+    pad = (size - scale * GRID) // 2
+    on = cells()
+    rows = bytearray()
+    for py in range(size):
+        rows.append(0)
+        for px in range(size):
+            cx, cy = (px - pad) // scale, (py - pad) // scale
+            inside = 0 <= px - pad < scale * GRID and 0 <= py - pad < scale * GRID
+            rows.extend(FG if inside and (cx, cy) in on else BG)
+
+    def chunk(kind, data):
+        body = kind + data
+        return struct.pack(">I", len(data)) + body + struct.pack(">I", zlib.crc32(body))
+
+    return (b"\x89PNG\r\n\x1a\n" + chunk(b"IHDR", struct.pack(">IIBBBBB", size, size, 8, 2, 0, 0, 0)) +
+            chunk(b"IDAT", zlib.compress(bytes(rows), 9)) + chunk(b"IEND", b""))
+
+
+def ico(sizes):
+    images = [png(s) for s in sizes]
+    out = struct.pack("<HHH", 0, 1, len(images))
+    offset = 6 + 16 * len(images)
+    for s, data in zip(sizes, images):
+        out += struct.pack("<BBBBHHII", s, s, 0, 0, 1, 32, len(data), offset)
+        offset += len(data)
+    return out + b"".join(images)
+
+
+if __name__ == "__main__":
+    (STATIC / "favicon.ico").write_bytes(ico([32, 48]))
+    (STATIC / "apple-touch-icon.png").write_bytes(png(180))
+    print("wrote favicon.ico, apple-touch-icon.png")
@@ -0,0 +1,151 @@
+#!/usr/bin/env python3
+"""Writes the two illustrations on the home page (templates/illustrations/sweep.html and sky.html, inline SVG for Zola to include).
+
+They are drawings of the LoRa Scanner's Sweep view and the GNSS App's sky view on the Cardputer,
+not screenshots, and the page says so. Every colour is one of the device's own (RGB332). The shapes
+come from a deterministic generator, so running this again gives the same files:
+
+    python3 site/tools/make_illustrations.py
+"""
+import math
+import os
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+OUT = os.path.join(HERE, "..", "templates", "illustrations")
+
+BLACK, SLATE, DIM, CYAN, MAG, WHITE, LABEL, ONFILL = "#000000", "#494955", "#6d6d55", "#00dbff", "#ff00ff", "#ffffff", "#b6dbff", "#000055"
+ORANGE = "#ff9200"
+
+
+def notch(x, y, w, h, n):
+    """A rectangle with its corners cut in two steps of n/2 (the site's .n-sm, .n-md and .n-lg)."""
+    a, b = n, n // 2
+    pts = [(0, a), (b, a), (b, b), (a, b), (a, 0), (w - a, 0), (w - a, b), (w - b, b), (w - b, a), (w, a), (w, h - a),
+           (w - b, h - a), (w - b, h - b), (w - a, h - b), (w - a, h), (a, h), (a, h - b), (b, h - b), (b, h - a), (0, h - a)]
+    return " ".join(f"{x + px:g},{y + py:g}" for px, py in pts)
+
+
+def rnd(n):
+    x = math.sin(n * 127.1 + 311.7) * 43758.5453
+    return x - math.floor(x)
+
+
+def jsround(v):
+    return math.floor(v + 0.5)
+
+
+SOURCES = [(5, 0.72, 0.9), (13.5, 0.58, 1.2), (22, 0.95, 1.0), (27, 0.42, 0.8)]
+
+
+def strength(i, r):
+    s = 0.05 + 0.1 * rnd(i * 7 + r * 13)
+    for k, (c, a, w) in enumerate(SOURCES):
+        if rnd(k * 10 + r) > 0.2:
+            g = math.exp(-((i - c) ** 2) / (2 * w * w))
+            s = max(s, a * g * (0.6 + 0.4 * rnd(i * 3 + r * 5 + k)))
+    return min(s, 1)
+
+
+def frame(parts, label):
+    keys_y = 306
+    kw = (480 - 13 * 4) / 14
+    keys = []
+    for row in range(4):
+        for col in range(14):
+            x, y = 20 + col * (kw + 4), keys_y + row * 26
+            keys.append(f'<polygon points="{notch(x, y, kw, 22, 4)}" fill="{SLATE}"/>')
+    return (
+        f'<svg xmlns="http://www.w3.org/2000/svg" class="illustration" viewBox="0 0 520 426" role="img" aria-label="{label}" shape-rendering="crispEdges">'
+        f'<polygon points="{notch(0, 0, 520, 426, 16)}" fill="{BLACK}"/>'
+        f'<polygon points="{notch(20, 20, 480, 270, 8)}" fill="{SLATE}"/>'
+        + "".join(parts) + "".join(keys) + "</svg>\n"
+    )
+
+
+def label(x, y, text, fill, anchor="start", weight=400, spacing=0.08):
+    return (f'<text x="{x:g}" y="{y:g}" fill="{fill}" text-anchor="{anchor}" font-size="11" font-weight="{weight}" '
+            f'letter-spacing="{spacing}em" class="mono">{text}</text>')
+
+
+def sweep():
+    p = []
+    # Tabs and Status Bar letters
+    p.append(label(40, 44, "SNIFFER", LABEL, weight=500))
+    p.append(f'<rect x="104" y="32" width="54" height="16" fill="{CYAN}"/>')
+    p.append(label(112, 44, "SWEEP", ONFILL, weight=500))
+    p.append(label(488, 44, "CAP", LABEL, "end", 500))
+    p.append(label(457, 44, "SW", CYAN, "end", 500))
+    p.append(label(434, 44, "L", CYAN, "end", 500))
+    # Bars with peak hold
+    p.append(f'<rect x="32" y="60" width="456" height="124" fill="{BLACK}"/>')
+    colw = (448 - 31 * 2) / 32
+    for i in range(32):
+        s = strength(i, 0)
+        h = max(4, jsround(s * 100 / 4) * 4)
+        gap = jsround(rnd(i * 11 + 3) * 3) * 4
+        gap = min(gap, 112 - h - 4 if 112 - h - 4 > 0 else 0)
+        x = 36 + i * (colw + 2)
+        p.append(f'<rect x="{x:.2f}" y="{180 - h}" width="{colw:.2f}" height="{h}" fill="{MAG if s > 0.6 else CYAN}"/>')
+        p.append(f'<rect x="{x:.2f}" y="{180 - h - gap - 4}" width="{colw:.2f}" height="4" fill="{WHITE}"/>')
+    # Waterfall, newest row on top
+    p.append(f'<rect x="32" y="192" width="456" height="66" fill="{BLACK}"/>')
+    for r in range(6):
+        for i in range(32):
+            s = strength(i, r + 1)
+            if s < 0.3:
+                continue
+            color = CYAN if s < 0.6 else MAG if s < 0.85 else WHITE
+            p.append(f'<rect x="{36 + i * (colw + 2):.2f}" y="{196 + r * 10}" width="{colw:.2f}" height="8" fill="{color}"/>')
+    p.append(label(32, 276, "863", LABEL, spacing=0))
+    p.append(label(260, 276, "866.5", LABEL, "middle", spacing=0))
+    p.append(label(488, 276, "870 MHz", LABEL, "end", spacing=0))
+    return frame(p, "Illustration of the Cardputer showing the LoRa Scanner's Sweep view: bars of signal strength from 863 to 870 MHz with peak marks, and a waterfall under them")
+
+
+def sky():
+    p = []
+    p.append(label(32, 44, "GNSS", WHITE, weight=500))
+    p.append(f'<rect x="449.5" y="32" width="38.5" height="16" fill="{CYAN}"/>')
+    p.append(label(457.5, 44, "SKY", ONFILL, weight=500))
+    p.append(label(445.5, 44, "POSITION", LABEL, "end", 500))
+    p.append(f'<rect x="32" y="60" width="456" height="218" fill="{BLACK}"/>')
+    ox, oy, CELL, NC, CC = 48, 86, 5, 33, 16
+    for y in range(NC):
+        for x in range(NC):
+            dx, dy = x - CC, y - CC
+            d = math.sqrt(dx * dx + dy * dy)
+            if any(abs(d - R) <= 0.5 for R in (15, 10, 5)):
+                color = DIM
+            elif (dx == 0 or dy == 0) and d < 15 and abs(dx + dy) % 2 == 0 and d > 0:
+                color = SLATE
+            else:
+                continue
+            p.append(f'<rect x="{ox + x * CELL}" y="{oy + y * CELL}" width="{CELL}" height="{CELL}" fill="{color}"/>')
+    cols = [CYAN, MAG, ORANGE, WHITE]
+    sats = [(20, 70, 0.8, 0), (75, 40, 0.6, 1), (130, 25, 0.35, 2), (160, 60, 0.9, 0), (210, 15, 0.25, 3), (250, 50, 0.7, 1),
+            (290, 30, 0.5, 0), (320, 75, 0.85, 2), (345, 35, 0.55, 1)]
+    for az, el, snr, ci in sats:
+        r = (90 - el) / 90 * 15
+        a = az * math.pi / 180
+        cx, cy = jsround(CC + r * math.sin(a)), jsround(CC - r * math.cos(a))
+        p.append(f'<rect x="{ox + cx * CELL - 4}" y="{oy + cy * CELL - 4}" width="14" height="14" fill="{BLACK}"/>')
+        p.append(f'<rect x="{ox + cx * CELL - 2}" y="{oy + cy * CELL - 2}" width="10" height="10" fill="{cols[ci]}"/>')
+    p.append(label(ox + 82.5, 80, "N", MAG, "middle", 500, 0))
+    p.append(label(ox + 82.5, 265, "S", LABEL, "middle", 500, 0))
+    p.append(label(ox - 14, 172, "W", LABEL, "start", 500, 0))
+    p.append(label(ox + 165 + 14, 172, "E", LABEL, "end", 500, 0))
+    # Signal strength of each satellite
+    p.append(label(237, 107, "SNR", LABEL, weight=500))
+    bw = (235 - 8 * 6) / 9
+    for i, (az, el, snr, ci) in enumerate(sats):
+        h = max(8, jsround(snr * 124 / 4) * 4)
+        p.append(f'<rect x="{237 + i * (bw + 6):.2f}" y="{243 - h}" width="{bw:.2f}" height="{h}" fill="{cols[ci]}"/>')
+    return frame(p, "Illustration of the GNSS App's sky view: the satellites' positions in a circle, and the signal strength of each as a bar")
+
+
+if __name__ == "__main__":
+    os.makedirs(OUT, exist_ok=True)
+    for name, svg in (("sweep.html", sweep()), ("sky.html", sky())):
+        with open(os.path.join(OUT, name), "w") as f:
+            f.write(svg)
+        print(name, len(svg), "bytes")
Author	SHA1	Message	Date
twislaandClaude Sonnet 5.5	2f1befa7f5	Site: the user guide (phase 2): the basics, one page per App, Settings and Updates Site / build (pull_request) Successful in 8s Details Eleven pages under /guide/, written from the README, the milestone documents and the Apps' own source: the keys, the Launcher, the Status Bar and the first start; the LoRa Scanner, GNSS, Gemini, IRC, Wi-Fi tools, Notes, Storage and System; Settings (with Wi-Fi) and Updates. Real screenshots where the site has them, a Guide link in the navigation, and the home page points to it. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 20:38:40 +02:00
twisla	5e36e69d76	Merge pull request 'Site: security.txt, robots.txt, favicon fallbacks' (#62 ) from site-security-txt into main Site / build (push) Successful in 8s Details Reviewed-on: #62	2026-10-06 18:16:48 +00:00
twislaandClaude Sonnet 5.5	492d8bb187	Site: security.txt, robots.txt, and favicon fallbacks (ICO, touch icon) Site / build (pull_request) Successful in 9s Details security.txt (RFC 9116) under .well-known with the mailbox as contact and an expiry in September 2027. robots.txt allows everything and points to the sitemap. The pixel 9 gets a favicon.ico (32 and 48 px) and an apple-touch-icon.png, drawn by tools/make_favicons.py from the same rectangles as favicon.svg. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 20:12:54 +02:00
twisla	821949e3f8	Merge pull request 'Site: roro9stack.net phase 1 (home, Install with a browser flasher, Downloads), and a CI split for site changes' (#61 ) from site into main CI / build (push) Successful in 1m8s Details Site / build (push) Successful in 7s Details Reviewed-on: #61	2026-10-06 16:33:07 +00:00
twislaandClaude Sonnet 5.5	9415c62132	Site: the build goes to public/ at the repository root, which git ignores CI / build (pull_request) Canceled after 38s Details Site / build (pull_request) Successful in 8s Details output_dir in site/config.toml, so zola build in site/ and zola --root site build from the root both write ./public. The ignore is /public/, not site/public/. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 18:31:57 +02:00
twislaandClaude Sonnet 5.5	6680b752af	W1: what was built and checked in phase 1; the site in the README CI / build (pull_request) Successful in 8m27s Details Site / build (pull_request) Successful in 8s Details Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 18:20:18 +02:00
twislaandClaude Sonnet 5.5	8f4b5e0ddc	Site: roro9stack.net, phase 1 (the home page, Install with a browser flasher, Downloads) A Zola site in site/, from the design: both themes on the device's palette, notched shapes, self-hosted fonts, the wordmark and icons, two generated hero drawings, nine App cards (the mesh messenger marked planned), real screenshots, the updates and build sections. The Install page builds ESP Web Tools' manifest in the browser from the Gitea API (it needs Caddy to allow the origin), refuses any download that isn't on the project's server, and falls back to the esptool steps. Downloads lists the releases. The focus ring shows on notched controls. A page checker fails the build if a page loads from another origin. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 18:20:18 +02:00
twislaandClaude Sonnet 5.5	b92fc6e2e5	CI: a Site workflow, and the firmware workflow skips changes that touch only the site and its documents site.yml builds the site with a Zola pinned by its checksum and checks the pages when site/, docs/, README.md or CONTEXT.md change. ci.yml gets paths-ignore for the same files on pushes to main and on pull requests; a tag always runs it (Gitea doesn't apply path filters to tags). A change touching both runs both. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 18:20:18 +02:00
twislaandClaude Sonnet 5.5	a0939bf741	W1 plan: the flasher reads the release from Gitea behind Caddy's CORS header, no firmware copy Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 17:54:02 +02:00
twislaandClaude Sonnet 5.5	748890deb8	W1 plan: the project website at roro9stack.net (issue #12 ), the design round Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT	2026-10-06 17:35:25 +02:00
twisla	4f0918ceae	Merge pull request 'v0.11.0 polish: the Debug Build message, the release badge on tags, the CI timings' (#56 ) from fix-release-polish into main CI / build (push) Successful in 1m10s Details Reviewed-on: #56	2026-10-06 15:21:42 +00:00
				`@@ -0,0 +1 @@`
				`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 7 7" shape-rendering="crispEdges"><rect width="7" height="7" fill="#000055"/><g fill="#00dbff"><rect x="1" y="0" width="3" height="1"/><rect x="0" y="1" width="1" height="2"/><rect x="4" y="1" width="1" height="5"/><rect x="1" y="3" width="3" height="1"/><rect x="0" y="6" width="3" height="1"/></g></svg>`
				`@@ -0,0 +1 @@`
				<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.0 -78.0 612.0 85.2" role="img" aria-label="roro9stack"><path fill="#ffffff" d="M7.7 0V-9.2H19.8V-37.1Q19.8 -40.4 16.6 -40.4H8.7V-49.6H20.6Q24.7 -49.6 27.3 -47.2Q29.9 -44.9 29.9 -40.7V-39.5H30.4Q31.5 -45.1 35.2 -48Q38.8 -50.8 45.8 -50.8H53.5V-39.6H42.7Q36.8 -39.6 33.6 -35.5Q30.4 -31.4 30.4 -25.7V-9.2H45.8V0Z"></path><path fill="#ffffff" d="M90 1.2Q82.9 1.2 77.3 -2Q71.7 -5.2 68.5 -11.1Q65.3 -16.9 65.3 -24.8Q65.3 -32.7 68.5 -38.6Q71.7 -44.4 77.3 -47.6Q82.9 -50.8 90.1 -50.8Q97.3 -50.8 102.9 -47.6Q108.4 -44.4 111.6 -38.6Q114.7 -32.7 114.7 -24.8Q114.7 -16.9 111.5 -11.1Q108.3 -5.2 102.8 -2Q97.2 1.2 90 1.2ZM90 -8.9Q93.8 -8.9 97 -10.6Q100.2 -12.3 102.2 -15.9Q104.1 -19.4 104.1 -24.8Q104.1 -30.3 102.2 -33.8Q100.2 -37.3 97.1 -39Q93.9 -40.7 90.1 -40.7Q86.3 -40.7 83.1 -39Q79.9 -37.3 78 -33.8Q76 -30.3 76 -24.8Q76 -16.6 80.2 -12.8Q84.3 -8.9 90 -8.9Z"></path><path fill="#ffffff" d="M127.7 0V-9.2H139.8V-37.1Q139.8 -40.4 136.6 -40.4H128.7V-49.6H140.6Q144.7 -49.6 147.3 -47.2Q149.9 -44.9 149.9 -40.7V-39.5H150.4Q151.5 -45.1 155.2 -48Q158.8 -50.8 165.8 -50.8H173.5V-39.6H162.7Q156.8 -39.6 153.6 -35.5Q150.4 -31.4 150.4 -25.7V-9.2H165.8V0Z"></path><path fill="#ffffff" d="M210 1.2Q202.9 1.2 197.3 -2Q191.7 -5.2 188.5 -11.1Q185.3 -16.9 185.3 -24.8Q185.3 -32.7 188.5 -38.6Q191.7 -44.4 197.3 -47.6Q202.9 -50.8 210.1 -50.8Q217.3 -50.8 222.9 -47.6Q228.4 -44.4 231.6 -38.6Q234.7 -32.7 234.7 -24.8Q234.7 -16.9 231.5 -11.1Q228.3 -5.2 222.8 -2Q217.2 1.2 210 1.2ZM210 -8.9Q213.8 -8.9 217 -10.6Q220.2 -12.3 222.1 -15.9Q224.1 -19.4 224.1 -24.8Q224.1 -30.3 222.1 -33.8Q220.2 -37.3 217.1 -39Q213.9 -40.7 210.1 -40.7Q206.3 -40.7 203.1 -39Q199.9 -37.3 197.9 -33.8Q196 -30.3 196 -24.8Q196 -16.6 200.2 -12.8Q204.3 -8.9 210 -8.9Z"></path><path fill="#00dbff" d="M268.7 1.2Q262.1 1.2 257.1 -1.4Q252.1 -4 249.1 -8.4Q246.1 -12.9 245.5 -18.5H255.7Q256.7 -13.8 260.1 -11.1Q263.5 -8.4 268.7 -8.4Q276 -8.4 280.5 -14.8Q285 -21.1 285.7 -34.6H285Q282.5 -30.4 278.6 -27.7Q274.7 -25 267.5 -25Q261.5 -25 256.5 -27.9Q251.5 -30.7 248.5 -35.8Q245.5 -40.9 245.5 -47.6Q245.5 -54 248.4 -59.4Q251.3 -64.7 256.6 -68Q261.8 -71.2 269 -71.2Q278.2 -71.2 284.1 -67.1Q290 -62.9 292.9 -55.4Q295.7 -47.8 295.7 -37.5Q295.7 -25.9 292.5 -17.2Q289.4 -8.5 283.4 -3.6Q277.3 1.2 268.7 1.2ZM269.7 -34.5Q275.9 -34.5 279.6 -38.4Q283.4 -42.2 283.4 -48Q283.4 -53.9 279.6 -57.8Q275.9 -61.6 269.7 -61.6Q263.5 -61.6 259.8 -57.8Q256 -54 256 -48.1Q256 -42.2 259.8 -38.4Q263.5 -34.5 269.7 -34.5Z"></path><path fill="#ffffff" d="M330.4 1.2Q320.6 1.2 314.8 -3.4Q309 -8 308.2 -15.6H319.1Q319.7 -12.1 322.6 -9.9Q325.6 -7.7 330.5 -7.7Q335.2 -7.7 337.8 -9.7Q340.3 -11.6 340.3 -14.2Q340.3 -18 337.2 -19.4Q334.2 -20.8 328.3 -21.5Q323.2 -22.1 319 -23.9Q314.9 -25.6 312.5 -28.7Q310.1 -31.7 310.1 -36.3Q310.1 -42.8 315.2 -46.8Q320.3 -50.8 329.4 -50.8Q338.5 -50.8 343.5 -46.7Q348.5 -42.6 349.3 -35.5H339.1Q338.7 -38.5 336 -40.2Q333.3 -42 329.3 -42Q325.2 -42 322.8 -40.5Q320.4 -38.9 320.4 -36.4Q320.4 -31 332 -29.8Q337.5 -29.2 341.8 -27.8Q346.1 -26.3 348.6 -23.2Q351.1 -20.2 351.1 -14.7Q351.2 -10.2 348.5 -6.6Q345.9 -3 341.2 -0.9Q336.6 1.2 330.4 1.2Z"></path><path fill="#ffffff" d="M395.4 0Q388.1 0 383.8 -3.6Q379.5 -7.1 379.5 -16.2V-40.6H367V-49.6H374.4Q379.5 -49.6 380.4 -54.6L381.9 -62.6H390.1V-49.6H409.7V-40.6H390.1V-16.4Q390.1 -12.5 391.9 -10.9Q393.6 -9.4 397.9 -9.4H409.5V0Z"></path><path fill="#ffffff" d="M445.5 1.2Q439.6 1.2 435.6 -0.9Q431.6 -2.9 429.6 -6.4Q427.6 -9.8 427.6 -13.9Q427.6 -21.2 433 -25.3Q438.3 -29.4 448.1 -29.4H460.9V-30.5Q460.9 -41.7 450.5 -41.7Q446.2 -41.7 443.2 -39.9Q440.3 -38 439.3 -33.9H428.7Q429.5 -41.7 435.4 -46.2Q441.4 -50.8 450.5 -50.8Q461.5 -50.8 466.5 -45.4Q471.5 -40 471.5 -30.5V0H462.5L461.6 -7.3H460.9Q458.7 -3.8 455.4 -1.3Q452.1 1.2 445.5 1.2ZM447.5 -7.7Q454 -7.7 457.2 -11.7Q460.5 -15.6 460.8 -21.7H449.2Q443.5 -21.7 441.1 -19.9Q438.8 -18 438.8 -14.7Q438.8 -11.4 441.1 -9.6Q443.5 -7.7 447.5 -7.7Z"></path><path fill="#ffffff" d="M510.7 1.2Q503.8 1.2 498.4 -2Q492.9 -5.2 489.8 -11.1Q486.7 -16.9 486.7 -24.8Q486.7 -32.7 489.9 -38.5Q493 -44.3 498.4 -47.6Q503.8 -50.8 510.7 -50.8Q520.2 -50.8 526 -46.1Q531.9 -41.3 533.5 -33H522.4Q521.4 -36.6 518.3 -38.7Q515.3 -40.8 510.6 -40.8Q507.2 -40.8 504.1 -39Q501.1 -37.2 499.2 -33.7Q497.4 -30.1 497.4 -24.8Q497.4 -19.6 499.2 -16Q501.1 -12.4 504.1 -10.6Q507.2 -8.7 510.6 -8.7Q515.4 -8.7 518.3 -10.8Q521.2 -12.9 522.4 -16.6H533.5Q531.5 -8.4 525.7 -3.6Q519.9 1.2 510.7 1.2Z"></path><path fill="#ffffff" d="M549.8 0V-72H560.4V-28.8L579.4 -49.6H592.7L572 -27.6V-26.8L595.4 0H582.5L560.4 -25.5V0Z"></path></svg>
				`@@ -0,0 +1 @@`
				import{ESP32ROM as t}from"./esp32-DNPRK0Ay.js";import"./install-dialog-im156JnI.js";import"./styles-sT2V1cOw.js";class i extends t{constructor(){super(...arguments),this.CHIP_NAME="ESP32-S3",this.IMAGE_CHIP_ID=9,this.EFUSE_BASE=1610641408,this.MAC_EFUSE_REG=this.EFUSE_BASE+68,this.EFUSE_BLOCK1_ADDR=this.EFUSE_BASE+68,this.EFUSE_BLOCK2_ADDR=this.EFUSE_BASE+92,this.UART_CLKDIV_REG=1610612756,this.UART_CLKDIV_MASK=1048575,this.UART_DATE_REG_ADDR=1610612864,this.FLASH_WRITE_SIZE=1024,this.BOOTLOADER_FLASH_OFFSET=0,this.SPI_REG_BASE=1610620928,this.SPI_USR_OFFS=24,this.SPI_USR1_OFFS=28,this.SPI_USR2_OFFS=32,this.SPI_MOSI_DLEN_OFFS=36,this.SPI_MISO_DLEN_OFFS=40,this.SPI_W0_OFFS=88,this.USB_RAM_BLOCK=2048,this.UARTDEV_BUF_NO_USB=3,this.UARTDEV_BUF_NO=1070526796,this.IROM_MAP_START=1107296256,this.IROM_MAP_END=1140850688,this.MEMORY_MAP=[[0,65536,"PADDING"],[1006632960,1023410176,"DROM"],[1023410176,1040187392,"EXTRAM_DATA"],[1611653120,1611661312,"RTC_DRAM"],[1070104576,1070596096,"BYTE_ACCESSIBLE"],[1070104576,1077813248,"MEM_INTERNAL"],[1070104576,1070596096,"DRAM"],[1073741824,1073848576,"IROM_MASK"],[1077346304,1077805056,"IRAM"],[1611653120,1611661312,"RTC_IRAM"],[1107296256,1115684864,"IROM"],[1342177280,1342185472,"RTC_DATA"]]}async getChipDescription(t){const i=await this.getMajorChipVersion(t),s=await this.getMinorChipVersion(t);return`${{0:"ESP32-S3 (QFN56)",1:"ESP32-S3-PICO-1 (LGA56)"}[await this.getPkgVersion(t)]\|\|"unknown ESP32-S3"} (revision v${i}.${s})`}async getPkgVersion(t){return await t.readReg(this.EFUSE_BLOCK1_ADDR+12)>>21&7}async getRawMinorChipVersion(t){return((await t.readReg(this.EFUSE_BLOCK1_ADDR+20)>>23&1)<<3)+(await t.readReg(this.EFUSE_BLOCK1_ADDR+12)>>18&7)}async getMinorChipVersion(t){const i=await this.getRawMinorChipVersion(t);return await this.isEco0(t,i)?0:this.getRawMinorChipVersion(t)}async getRawMajorChipVersion(t){return await t.readReg(this.EFUSE_BLOCK1_ADDR+20)>>24&3}async getMajorChipVersion(t){const i=await this.getRawMinorChipVersion(t);return await this.isEco0(t,i)?0:this.getRawMajorChipVersion(t)}async getBlkVersionMajor(t){return await t.readReg(this.EFUSE_BLOCK2_ADDR+16)>>0&3}async getBlkVersionMinor(t){return await t.readReg(this.EFUSE_BLOCK1_ADDR+12)>>24&7}async isEco0(t,i){return 0==(7&i)&&1===await this.getBlkVersionMajor(t)&&1===await this.getBlkVersionMinor(t)}async getFlashCap(t){const i=this.EFUSE_BASE+68+12;return await t.readReg(i)>>27&7}async getFlashVendor(t){const i=this.EFUSE_BASE+68+16;return{1:"XMC",2:"GD",3:"FM",4:"TT",5:"BY"}[await t.readReg(i)>>0&7]\|\|""}async getPsramCap(t){const i=this.EFUSE_BASE+68+16;return await t.readReg(i)>>3&3}async getPsramVendor(t){const i=this.EFUSE_BASE+68+16;return{1:"AP_3v3",2:"AP_1v8"}[await t.readReg(i)>>7&3]\|\|""}async getChipFeatures(t){const i=["Wi-Fi","BLE"],s=await this.getFlashCap(t),e=await this.getFlashVendor(t),a={0:null,1:"Embedded Flash 8MB",2:"Embedded Flash 4MB"}[s],r=void 0!==a?a:"Unknown Embedded Flash";null!==a&&i.push(`${r} (${e})`);const n=await this.getPsramCap(t),_=await this.getPsramVendor(t),h={0:null,1:"Embedded PSRAM 8MB",2:"Embedded PSRAM 2MB"}[n],E=void 0!==h?h:"Unknown Embedded PSRAM";return null!==h&&i.push(`${E} (${_})`),i}async getCrystalFreq(t){return 40}_d2h(t){const i=(+t).toString(16);return 1===i.length?"0"+i:i}async postConnect(t){const i=255&await t.readReg(this.UARTDEV_BUF_NO);t.debug("In _post_connect "+i),i==this.UARTDEV_BUF_NO_USB&&(t.ESP_RAM_BLOCK=this.USB_RAM_BLOCK)}async readMac(t){let i=await t.readReg(this.MAC_EFUSE_REG);i>>>=0;let s=await t.readReg(this.MAC_EFUSE_REG+4);s=s>>>0&65535;const e=new Uint8Array(6);return e[0]=s>>8&255,e[1]=255&s,e[2]=i>>24&255,e[3]=i>>16&255,e[4]=i>>8&255,e[5]=255&i,this._d2h(e[0])+":"+this._d2h(e[1])+":"+this._d2h(e[2])+":"+this._d2h(e[3])+":"+this._d2h(e[4])+":"+this._d2h(e[5])}getEraseSize(t,i){return i}}export{i as ESP32S3ROM};
				`@@ -0,0 +1 @@`
				const e=async t=>{let o;import("./install-dialog-im156JnI.js").then((function(e){return e.i}));try{o=await navigator.serial.requestPort()}catch(o){return"NotFoundError"===o.name?void import("./index-Dt9w-IG1.js").then((o=>o.openNoPortPickedDialog((()=>e(t))))):void alert(`Error: ${o.message}`)}if(!o)return;try{await o.open({baudRate:115200,bufferSize:8192})}catch(e){return void alert(e.message)}const n=document.createElement("ewt-install-dialog");n.port=o,n.manifestPath=t.manifest\|\|t.getAttribute("manifest"),n.overrides=t.overrides,n.addEventListener("closed",(()=>{o.close()}),{once:!0}),document.body.appendChild(n)};class t extends HTMLElement{connectedCallback(){if(this.renderRoot)return;if(this.renderRoot=this.attachShadow({mode:"open"}),!t.isSupported\|\|!t.isAllowed)return this.toggleAttribute("install-unsupported",!0),void(this.renderRoot.innerHTML=t.isAllowed?"<slot name='unsupported'>Your browser does not support installing things on ESP devices. Use Mozilla Firefox, Google Chrome or Microsoft Edge.</slot>":"<slot name='not-allowed'>You can only install ESP devices on HTTPS websites or on the localhost.</slot>");this.toggleAttribute("install-supported",!0);const o=document.createElement("slot");o.addEventListener("click",(async t=>{t.preventDefault(),e(this)})),o.name="activate";const n=document.createElement("button");if(n.innerText="Connect",o.append(n),"adoptedStyleSheets"in Document.prototype&&"replaceSync"in CSSStyleSheet.prototype){const e=new CSSStyleSheet;e.replaceSync(t.style),this.renderRoot.adoptedStyleSheets=[e]}else{const e=document.createElement("style");e.innerText=t.style,this.renderRoot.append(e)}this.renderRoot.append(o)}}t.isSupported="serial"in navigator,t.isAllowed=window.isSecureContext,t.style='\n button {\n position: relative;\n cursor: pointer;\n font-size: 14px;\n font-weight: 500;\n padding: 10px 24px;\n color: var(--esp-tools-button-text-color, #fff);\n background-color: var(--esp-tools-button-color, #03a9f4);\n border: none;\n border-radius: var(--esp-tools-button-border-radius, 9999px);\n }\n button::before {\n content: " ";\n position: absolute;\n top: 0;\n bottom: 0;\n left: 0;\n right: 0;\n opacity: 0.2;\n border-radius: var(--esp-tools-button-border-radius, 9999px);\n }\n button:hover::before {\n background-color: rgba(255,255,255,.8);\n }\n button:focus {\n outline: none;\n }\n button:focus::before {\n background-color: white;\n }\n button:active::before {\n background-color: grey;\n }\n :host([active]) button {\n color: rgba(0, 0, 0, 0.38);\n background-color: rgba(0, 0, 0, 0.12);\n box-shadow: none;\n cursor: unset;\n pointer-events: none;\n }\n .hidden {\n display: none;\n }',customElements.define("esp-web-install-button",t);