Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .planning/STATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ gsd_state_version: 1.0
milestone: v0.5
milestone_name: GitHub Operator Setup
status: Ready for Review
last_updated: "2026-09-05T10:10:16.085Z"
last_updated: "2026-09-05T10:59:12.430Z"
last_activity: 2026-09-05
progress:
total_phases: 1
Expand All @@ -27,7 +27,7 @@ See: .planning/PROJECT.md (updated 2026-07-03)
Phase: 19 of 19 complete
Plan: 19.1 — Hardened GitHub Actions Setup
Status: Ready for review in PR #9
Last activity: 2026-09-05 - completed quick task 260905-fld: default platform installer and homepage tabs
Last activity: 2026-09-05 - completed quick task 260905-hia: minimal landing identity and GSAP reactions, PR #40


## Blockers / Concerns
Expand Down Expand Up @@ -91,6 +91,7 @@ Last activity: 2026-09-05 - completed quick task 260905-fld: default platform in
|---|-------------|------|--------|-----------|
| 260902-tfw | Fail docs deployment when Bunny configuration is absent | 2026-09-02 | 2d1e697 | [260902-tfw-make-docs-deployment-fail-when-bunny-con](./quick/260902-tfw-make-docs-deployment-fail-when-bunny-con/) |
| 260905-fld | Default platform installer and homepage tabs; native install/reinstall proof | 2026-09-05 | c415386 | [260905-fld-homepage-platform-installer](./quick/260905-fld-homepage-platform-installer/) |
| 260905-hia | Minimal landing identity, GSAP reactions and screenshot proofs in PR #40 | 2026-09-05 | 6e84a9a | [260905-hia-landing-identity](./quick/260905-hia-landing-identity/) |

## Accumulated Context

Expand Down
31 changes: 31 additions & 0 deletions .planning/quick/260905-hia-landing-identity/260905-hia-PLAN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
status: complete
---

# A compact signal-path identity for Loopwire

## Intent and design

Create an editorial, minimal landing page using warm mineral backgrounds, dark ink, geometric Sora typography,
plain text controls and fine routed lines. Integrate the existing product screenshot into the hero grid without
an enclosing panel. Remove the capability cards, stacked card shells, pills, glows, shadows and ornamental labels.
Use an original loop-path mark with a tightly spaced wordmark for a coherent audio-routing identity.

## Execution and cleanup plan

1. Lock the merged #38 install interactions with the existing browser suite. Keep commands unchanged.
2. Replace the root layout and styles; self-host a licensed variable font and retain attribution. GSAP 3.15.0 is
explicitly requested, checked against the registry (released April 13, 2026), and pinned with the lockfile.
3. Add a bounded signal-field canvas driven by GSAP. Pointer motion deforms paths, clicks send a subtle pulse,
install-tab selection transitions the background palette, and successful copying triggers a distinct response.
Reduced-motion users get immediate color changes with static linework. Pause/clean up animation offscreen.
4. Verify keyboard/copy/no-JS behavior, motion states, responsive layout, metadata, docs and builds. Review screenshots
against the user constraints; persist visual verdicts before each further visual edit.
5. Update design/testing/release docs, commit, push and open a PR with screenshot proofs embedded in its body.

## Boundaries and proof

Website and documentation only; no installer/audio/package behavior changes. No new dependencies beyond requested
GSAP; the font is a licensed local asset. Screenshot proofs will be committed under this quick-task directory and
embedded using immutable GitHub raw URLs so reviewers can inspect them without local files or CI artifact access.
Desktop/mobile proofs plus alternate-tab and copy-reaction states are required before completion.
66 changes: 66 additions & 0 deletions .planning/quick/260905-hia-landing-identity/260905-hia-SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
status: complete
---

# Loopwire landing-page identity

Issue: [#39](https://github.com/sandwichfarm/loopwire/issues/39)
PR: [#40](https://github.com/sandwichfarm/loopwire/pull/40)
Implementation and screenshot commit: `6e84a9a`
Base: merged #38, `4c1fc48`

## Result

The root page now uses a flat Sora wordmark, an original interlocking loop-path mark, dark ink and nine mineral
palettes. The existing product screenshot is integrated into the hero without added framing; the crop emphasizes
routing and links to the full image. Capability cards, stacked panels, pills, shadows, glow, and redundant hero copy
were removed. Installation requirements use a disclosure control while all nine commands stay directly accessible.

GSAP responds to pointer movement and clicks, transitions the palette when an install tab is selected, and gives
successful copying a distinct finite pulse. Pointer/click/copy motion stops under reduced motion; palettes change
immediately. Idle canvas draw counts stay stable. The visibility boundary stops drawing and restores interactions.
The implementation bounds paths, samples and pixel density and removes listeners/tweens on teardown.

The PR body embeds desktop, mobile, Ubuntu palette and copy-response screenshot proofs using immutable raw GitHub
URLs. Each embedded URL was fetched successfully and its PNG bytes matched the committed local proof.

## Changed files and simplifications

- `apps/site/src/pages/index.astro`: compact composition, integrated preview, plain accessible controls and animation hooks.
- `apps/site/src/layouts/SiteLayout.astro`: lean mineral/color/type rules; removed decorative backgrounds and panel tokens.
- `apps/site/src/lib/signalField.ts`: bounded, event-driven GSAP field and palette lifecycle.
- `apps/site/public/loopwire-mark.svg`, `apps/site/public/fonts/`: original loop mark and locally served Sora with its OFL license.
- `apps/site/package.json`, `pnpm-lock.yaml`: exactly pinned GSAP 3.15.0, explicitly requested and version/age checked.
- `scripts/e2e-site-install.mjs`: installation regressions, animation pixel/color/draw checks, accessibility and reproducible proof capture.
- `scripts/verify-static-site.mjs`: current identity/background contract instead of removed capability-card content.
- `apps/docs/docs/developer/landing-page.md`, `apps/docs/docs/developer/e2e.md`,
`apps/docs/docs/release-notes/unreleased.md`: design decisions, dependency tradeoff, font attribution and test instructions.
- This plan, summary, `proofs/`, and `.planning/STATE.md`: durable acceptance and review evidence.

No installer, audio/backend, desktop app, package recipe, or original screenshot changes.

## Validation

- The existing #38 browser suite passed before the redesign. The new static identity gate failed against the old page.
- `pnpm lint`: workspace typechecks passed; Svelte reported zero errors and warnings.
- `pnpm test`: all 295 TypeScript tests passed.
- `pnpm build`: production builds for the workspaces and combined static site passed.
- `pnpm verify:docs`, `pnpm verify:site`, `node --check scripts/e2e-site-install.mjs`, and `git diff --check` passed.
- `pnpm e2e:site --screenshots ...` passed on Chromium: all commands still match the install guide; all nine palettes
are distinct; keyboard focus, copying/failure recovery, no-JavaScript and unavailable-canvas fallbacks work.
- Browser checks confirmed Sora actually loaded and the key layout/control elements have no borders, corner radii,
shadows or filters. All tab views fit 320, 390, 768 and 1440px widths without page overflow.
- Motion tests compare actual canvas pixels, computed background colors and intercepted real draw calls. Pointer,
click, copy, palette interpolation, idle draw stability and live reduced-motion behavior passed. Visibility was
simulated at the document boundary; drawing stopped and resumed correctly.
- Removing the successful-copy hook from the built test artifact made the canvas regression fail. Restoring the
original artifact returned all checks to green; the combined bundle matches the unmodified build output.
- Independent visual/code review passed. Final visual verdict: 96/100 against the user constraints.
- PR #40 is open and all four embedded screenshot URLs serve the exact committed PNGs.

## Remaining limits

Automated browser execution used Chromium. Other browser engines and physical mobile devices were not exercised.
No live audio, installer or native-package tests were repeated because those paths did not change. Screenshots show
individual animation frames; pixel/color tests supply the interactive evidence. No production deployment or merge
was performed.
20 changes: 20 additions & 0 deletions .planning/quick/260905-hia-landing-identity/proofs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Landing-page review proofs

Generated from the combined production web build with:

```sh
pnpm build:web
PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium pnpm e2e:site --screenshots .planning/quick/260905-hia-landing-identity/proofs
```

| Image | Viewport | State |
| --- | --- | --- |
| `desktop.png` | 1440 × 1000 | Automatic tab, idle signal field |
| `mobile.png` | 390 × 844 | Automatic tab; full-page capture |
| `ubuntu-palette.png` | 1440 × 1000 | Ubuntu selected; completed mineral/terracotta transition; full-page capture |
| `copy-response.png` | 1440 × 1000 | Automatic command copied through the real Clipboard API; finite pulse in progress |

These are actual Chromium screenshots, without compositing or post-processing. The copy pulse is captured during
animation, so its exact line positions can vary between runs. The product preview uses the existing application
screenshot and links to its full version. Automated pixel/color tests cover the interactions that still images
cannot demonstrate, including motion reduction, idle stability and a visibility-boundary simulation.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions apps/docs/docs/developer/e2e.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,3 +88,7 @@ Checks cover the automatic default, every platform tab, keyboard navigation/focu
mobile overflow, shell command syntax, agreement with the install guide, and the no-JavaScript fallback. It also
rejects the obsolete pre-release deployment notice. This browser check does not execute installation commands or
modify host packages/audio. Run `pnpm verify:install` for isolated signed-installer and package-manager fixtures.

The root page also checks its [signal-path design and GSAP reactions](./landing-page.md), including real canvas
pixel changes, tab palettes, idle stability, reduced-motion preferences and unavailable-canvas fallback. To capture
review proofs, run `pnpm e2e:site --screenshots <output-directory>` after the combined web build.
53 changes: 53 additions & 0 deletions apps/docs/docs/developer/landing-page.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Landing-page design

The root page uses a signal-path identity: a geometric wordmark, two intersecting loops, dark ink on mineral
colors, and fine routed lines. Sora is the shared wordmark and interface typeface. The product preview belongs to
the hero composition; it has no added frame, shadow, or rounded shell. It is cropped to emphasize routing and links
to the full application screenshot.

## Design rules

- Use typography and spacing to establish hierarchy. Avoid ornamental panels, pills, glows and shadows.
- Reserve strokes for the original loop mark, background paths, selected-tab indicator and keyboard focus.
- Keep installation commands visible. Put extended requirements behind the native disclosure control.
- Keep the automatic installer and all platform/source commands from the install guide in sync.
- Keep metadata and no-JavaScript installation access intact.

## Motion

`apps/site/src/lib/signalField.ts` owns the decorative canvas and palette. GSAP animates plain state objects;
rendering is coalesced through a requested animation frame. There are 24 paths with 72 samples each, and backing
resolution is capped at 1.5 device pixels per CSS pixel. There is no idle drawing loop.

Pointer movement bends nearby paths. A click sends a brief traveling displacement. Successful clipboard completion
sends a separate, slightly stronger pulse; a delayed or failed copy cannot acknowledge the wrong selected tab.
Each installation tab selects a distinct mineral background and ink accent through a short color transition.
The pattern remains static for reduced motion, while palette changes happen immediately. Preference changes are
handled live. Hidden documents stop their motion, and unload removes listeners and tweens. Animation is local and
does not need a network service.

GSAP **3.15.0** is pinned in the site package and lockfile. It was explicitly requested for this design, verified
against the registry on September 5, 2026, and had been published on April 13, 2026. The tradeoff is an additional
client bundle in return for reusable pointer tweens, coordinated color/pulse motion and interruption control.
See the official [quickTo documentation](https://gsap.com/docs/v3/GSAP/gsap.quickTo()/) for the reusable tween API.

## Font asset

`apps/site/public/fonts/sora-latin-variable.woff2` is the locally served Sora Latin variable font, weights 100–800.
It comes from the [Google Fonts Sora distribution](https://fonts.google.com/specimen/Sora), v17, with the original
SIL Open Font License retained in `OFL-Sora.txt`. Source font URL:
[versioned WOFF2](https://fonts.gstatic.com/s/sora/v17/xMQbuFFYT72XzQUpDg.woff2).
The build never fetches fonts, and the page makes no external font requests.

## Verification and screenshot proofs

Run `pnpm build:web`, `pnpm verify:site`, and `pnpm e2e:site` with the existing system Playwright setup described in
[the browser-test guide](./e2e.md). The suite checks actual canvas pixels and computed background colors, including
pointer/click/copy responses, transitions, idle stability, live reduced-motion changes and an unavailable canvas.
It also checks the loaded font, absence of decorative framing, command copying, keyboard focus, no-JavaScript
fallback, and layouts from 320px to 1440px.

Use `pnpm e2e:site --screenshots <output-directory>` to produce desktop, mobile, Ubuntu palette and successful-copy
proofs. Screenshots use the real page and clipboard API. The copy screenshot captures the finite pulse in progress,
so its line positions vary slightly between runs. Commit review proofs with the task record and embed their raw
GitHub URLs in the PR body. A static screenshot alone does not prove interactive motion; retain the test results too.
7 changes: 7 additions & 0 deletions apps/docs/docs/release-notes/unreleased.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,13 @@ These notes describe source-tree progress. They are not a public release announc
- The signed installer is now live at `https://loopwire.app/install.sh`; AppImage, deb, and RPM artifacts are available
from the `v0.1.0` GitHub Release, with native files documented as direct downloads rather than distro repositories.

## Landing page

- The root page now uses a flat Sora wordmark and signal-path identity, with the product screenshot integrated into
the main composition. Decorative panels, capability cards, pill controls, shadows and glow have been removed.
- A GSAP background responds to pointer movement, clicks, platform tabs and successful copying. Reduced motion
keeps the linework static and changes palettes immediately. Existing installation commands remain unchanged.

## Installation

- The homepage defaults to a one-command installer with accessible platform tabs, selected-command copying, and
Expand Down
3 changes: 3 additions & 0 deletions apps/site/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,8 @@
"devDependencies": {
"astro": "7.2.9",
"typescript": "6.0.3"
},
"dependencies": {
"gsap": "3.15.0"
}
}
93 changes: 93 additions & 0 deletions apps/site/public/fonts/OFL-Sora.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
Copyright 2019 The Sora Project Authors (https://github.com/sora-xor/sora-font)

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: https://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.
Binary file added apps/site/public/fonts/sora-latin-variable.woff2
Binary file not shown.
Loading
Loading