feat(website): add the project site and deploy it to GitHub Pages

A Vite + React + TypeScript + Tailwind v4 site under website/, built from
the soulseek-rs design system so the site and the TUI stay one product.
The colour tokens in src/index.css are the same values as
soulseek-rs/src/ui/styles.rs; change one, change both.

The hero is a working recreation of the TUI: it plays one scripted run and
then takes the keyboard, or lands on the resting state directly under
prefers-reduced-motion. Its sample data is invented or public domain, per
the tone-of-voice guardrail against naming copyrighted material.

Static output rather than an SPA shell. `bun run build` compiles the client,
compiles the same app for Node, then renders every route in src/lib/routes.ts
to its own file with that route's title, description and canonical URL. A
direct link to /install therefore answers 200 with real markup instead of
GitHub's 404 page. routes.ts is keyed into App.tsx by literal path, so adding
one without the other fails typecheck rather than shipping a page whose body
says "not found" under the right title.

Theme is resolved once by an inline script before first paint and adopted by
React through useSyncExternalStore, so there is no flash and no hydration
mismatch on the toggle. Light mode re-cuts the semantic hues darker: phosphor
and tape read on vinyl but wash out on manila.

CI and release skip website-only pushes, and Pages skips Rust-only ones. The
two Rust workflows share one paths-ignore list so they can only skip
together, which keeps the release ci-gate from polling for a run that was
never queued. That gate also now treats a cancelled CI as "keep waiting"
rather than a failure, since cancel-in-progress cancels the older SHA on
every back-to-back push.
This commit is contained in:
Michel de Graaf
2026-07-24 23:42:41 +02:00
parent 54feb3bc5a
commit 33bfc34dc8
58 changed files with 5239 additions and 1 deletions
+40
View File
@@ -0,0 +1,40 @@
import { useCallback, useEffect, useRef, useState } from 'react'
const RESET_MS = 1400
/**
* Copy-to-clipboard with a self-clearing "copied" flag.
*
* no execCommand fallback. `navigator.clipboard` is available in
* every secure context, and the site only ever ships over HTTPS (GitHub
* Pages) or localhost. If a copy does fail, the flag stays off and the text
* is still selectable by hand.
*/
export const useCopy = (): { copied: boolean; copy: (text: string) => void } => {
const [copied, setCopied] = useState(false)
const timer = useRef<ReturnType<typeof setTimeout> | null>(null)
useEffect(
() => () => {
if (timer.current !== null) clearTimeout(timer.current)
},
[],
)
const copy = useCallback((text: string) => {
navigator.clipboard.writeText(text).then(
() => {
setCopied(true)
if (timer.current !== null) clearTimeout(timer.current)
timer.current = setTimeout(() => {
setCopied(false)
}, RESET_MS)
},
() => {
// Permission denied or no clipboard: leave the button untouched.
},
)
}, [])
return { copied, copy }
}
+23
View File
@@ -0,0 +1,23 @@
import { useEffect } from 'react'
import { useLocation } from 'react-router'
import { metaFor } from '@/lib/routes'
/**
* Keeps the title and meta description in step with the current route.
*
* Each route is also prerendered with its tags already in the HTML, so
* crawlers never depend on this running; it only covers client-side
* navigation after the first paint.
*/
export const usePageMeta = (): void => {
const { pathname } = useLocation()
useEffect(() => {
const meta = metaFor(pathname)
document.title = meta.title
document
.querySelector('meta[name="description"]')
?.setAttribute('content', meta.description)
}, [pathname])
}