Repository navigation
Commit 0863e90
feat(coil): put the real install steps on the download page, from one source (#72)
Someone who has never seen this repo could go from the landing page to a Mac
that says the app is damaged, with nothing on screen to explain it. The steps
existed — they were just unfindable.
Three gaps, all closed here.
`download.astro` said "the release notes carry the commands to get past it".
It did not link them, and the buttons hand you a dmg straight from the relay
manifest, so nothing makes you pass a release note on the way. The steps are now
rendered inline next to the button that produced the file, with copy buttons.
The copy is also corrected. "Will warn on first launch" undersold it: Gatekeeper
does not say *unidentified developer* for this bundle, it says the app **is
damaged and should be moved to the Trash** — because the bundle carries
Electron's inherited ad-hoc signature with no sealed resources — and right-click
→ Open does not bypass that. A reader told to expect a warning reasonably
concludes the download is corrupt and gives up. The page and the release notes
now both say damaged, and both say right-click → Open will not help. A test
asserts that wording, so softening it fails rather than quietly regressing.
macOS leads with *drag to /Applications first*, because App Translocation is
invisible when it happens and later breaks self-updates. The platform matrix is
stated plainly: macOS arm64 only, Windows x64 only, no Linux.
`scripts/t3x/install-instructions.json` is the single source, consumed by:
- `apps/coil-home/src/lib/install.ts`, imported at build time so the steps are on
the page even when the relay is unreachable and there is nothing else to show;
- `scripts/t3x/render-release-notes.mjs`, which the release workflow renders to a
file and passes as `body_path`, replacing the inline YAML the notes lived in.
The fallback `gh release create` path now uses the same file. It used to say
"see any earlier release on this repo" because the action's inline body was not
reachable from the retry step — a release that landed via the fallback was a
second-class one. It no longer is.
A rendering failure cannot cost a release: by the time that step runs, both
matrix legs have finished and ~22 minutes of macOS and Windows compute is spent,
so a non-zero exit degrades to a minimal body that still links the download page,
and warns.
`.mjs`, not `.ts`, deliberately — the publish job has no `setup-node` step, so it
runs on whatever Node the runner image ships, and type stripping needs 22.18+.
Types come from a hand-written `.d.mts` so the test still typechecks. Its sibling
`build-update-manifest.mjs` is `.mjs` for the same reason.
The bundle name is the one thing that has to be duplicated — the renderers should
not reach into the desktop app's package.json, and the download page cannot read
it at runtime. So it is cached in the JSON and a test asserts it equals
`apps/desktop/package.json`'s `productName`. That turns #71's rename from silent
drift — every published `xattr` command pointing at a bundle that no longer
exists — into a failing test.
Both still sent readers to `pingdotgg/t3code` releases, `winget install
T3Tools.T3Code` and `brew install --cask t3-code`. None of those install this
fork. Both now carry a callout saying so and pointing at the download page.
Upstream's text is untouched — the callouts are inserted above it, so both rows
stay +N/-0 and the additive-seam invariant holds. They are rows 39 and 40 in
SEAMS.md (README.md +15/-0 churn 5 risk 75; docs/user/install.md +17/-0 churn 1
risk 17).
Regenerating the ledger to add them also found the `pnpm-lock.yaml` row 13 lines
stale: `apps/coil-home`'s workspace entry landed across `99b83bf55` (+16),
`2a6053745` (-3) and `7197fa589`, and none of them moved the row — exactly the
failure the note above the ledger warns about. Corrected here, with the header
total, to a measured 40 files / +2037 / -913 — the row itself was still `+317`
on main even after #40 moved the header to match the recipe, so this closes the
drift on both sides.
Closes #72
Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>1 parent 8184981 commit 0863e90
10 files changed
Lines changed: 750 additions & 54 deletions
File tree
- .github/workflows
- apps/coil-home/src
- lib
- pages
- docs
- t3x
- user
- scripts/t3x
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
592 | 592 | | |
593 | 593 | | |
594 | 594 | | |
| 595 | + | |
| 596 | + | |
| 597 | + | |
| 598 | + | |
| 599 | + | |
| 600 | + | |
| 601 | + | |
| 602 | + | |
| 603 | + | |
| 604 | + | |
| 605 | + | |
| 606 | + | |
| 607 | + | |
| 608 | + | |
| 609 | + | |
| 610 | + | |
| 611 | + | |
| 612 | + | |
| 613 | + | |
| 614 | + | |
| 615 | + | |
| 616 | + | |
| 617 | + | |
| 618 | + | |
| 619 | + | |
| 620 | + | |
595 | 621 | | |
596 | 622 | | |
597 | 623 | | |
| |||
607 | 633 | | |
608 | 634 | | |
609 | 635 | | |
610 | | - | |
611 | | - | |
612 | | - | |
613 | | - | |
614 | | - | |
615 | | - | |
616 | | - | |
617 | | - | |
618 | | - | |
619 | | - | |
620 | | - | |
621 | | - | |
622 | | - | |
623 | | - | |
624 | | - | |
625 | | - | |
626 | | - | |
627 | | - | |
628 | | - | |
629 | | - | |
630 | | - | |
631 | | - | |
632 | | - | |
633 | | - | |
634 | | - | |
635 | | - | |
636 | | - | |
637 | | - | |
638 | | - | |
639 | | - | |
640 | | - | |
641 | | - | |
642 | | - | |
643 | | - | |
| 636 | + | |
644 | 637 | | |
645 | 638 | | |
646 | 639 | | |
| |||
684 | 677 | | |
685 | 678 | | |
686 | 679 | | |
| 680 | + | |
687 | 681 | | |
688 | 682 | | |
689 | 683 | | |
690 | 684 | | |
691 | | - | |
692 | | - | |
693 | | - | |
694 | | - | |
695 | | - | |
696 | | - | |
697 | | - | |
698 | | - | |
| 685 | + | |
| 686 | + | |
| 687 | + | |
| 688 | + | |
| 689 | + | |
| 690 | + | |
| 691 | + | |
| 692 | + | |
| 693 | + | |
| 694 | + | |
699 | 695 | | |
700 | 696 | | |
701 | 697 | | |
| |||
715 | 711 | | |
716 | 712 | | |
717 | 713 | | |
718 | | - | |
| 714 | + | |
719 | 715 | | |
720 | 716 | | |
721 | 717 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
15 | 30 | | |
16 | 31 | | |
17 | 32 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
0 commit comments