ReRAC website
The website of ReRAC, the unofficial native PC port of Ratchet & Clank (PS2, 2002), served at
https://re-rac.github.io: a showcase home page with the ReRAC Launcher download, and the player documentation under
/docs. The game lives in re-rac/rerac and the launcher in
re-rac/rerac-launcher.
It is a static Astro site with Starlight for the docs, and it
deploys to GitHub Pages.
ReRAC is an unofficial fan project, not affiliated with or endorsed by Sony Interactive Entertainment or Insomniac
Games. The site ships no game assets. The two pieces of game art it uses are listed in
src/assets/third-party/README.md and can be switched off.
Running it
Needs Node 22.12 or later, and npm.
npm install # install the pinned dependencies (package-lock.json)
npm run dev # dev server at http://localhost:4321
npm run build # static build into dist/
npm run preview # serve dist/ locally
The build works offline: without network access (or without releases) it falls back to "Coming soon" data.
Where things live
| Path | What |
|---|
src/config.ts | The one config file: GitHub org, launcherRepo, gameRepo, siteUrl, base path, the download switches, the stable download asset names per platform, and the thirdPartyArt toggles |
src/pages/index.astro | Home page |
src/pages/status.astro | The status page (/status): per-planet and per-area progress bars |
src/data/status.ts | The status data, hand-maintained: read by the status page and the home page's Where it stands lists |
src/pages/docs/changelog.astro | Changelog, built from both repos' GitHub releases (/changelog redirects here) |
src/content/docs/docs/*.md(x) | Docs pages (Starlight). The sidebar is in astro.config.ts |
src/lib/releases.ts | Build-time GitHub release fetch, with the fallback |
src/components/ | Home page parts: download CTA (DownloadCtaScript.astro is the only client script: OS detection, loaded only when the download is live), space scene, panels |
src/starlight/ | Starlight overrides: site title, footer, header download button, single dark theme |
src/styles/ | tokens.css (colours, fonts) shared by home and docs; site.css (home); starlight.css (docs theme) |
src/data/screenshots.ts | The home page screenshot slots; fill them here |
src/assets/brand/ | The ReRAC logo (rerac-logo.png, the wordmark in the hero, header and docs) and icon (rerac-icon.png, the favicon source) |
src/assets/third-party/ | All third-party art, with a README of each file's origin |
src/assets/fonts/ | Russo One and Exo 2 (SIL OFL 1.1, licence texts included) |
public/favicon.ico, favicon-32.png, apple-touch-icon.png | Favicons, generated from the icon by node scripts/favicons.mjs |
public/og.png | Social preview image with the ReRAC logo; its source is scripts/og-image.html |
Configuration
Edit src/config.ts, or set these environment variables at build time:
| Variable | Default | Meaning |
|---|
RERAC_ORG | re-rac | GitHub owner of the game and launcher repos |
SITE_URL | https://<org>.github.io | Origin the site is served from |
SITE_BASE | / | Path prefix: / for an org site (https://re-rac.github.io) or a custom domain, /<repo> for a project site (https://<owner>.github.io/<repo>/) |
GITHUB_TOKEN | none | Raises the GitHub API rate limit; needed to read releases of private repos |
RELEASES_OFFLINE | unset | 1 skips the release fetch entirely |
RELEASES_FIXTURES | unset | Local preview only: a folder with <repo>.json files in the GitHub API shape, used instead of the network. Never set it in CI |
For example, a local build as a project site:
SITE_URL=https://example.github.io SITE_BASE=/rerac-site npm run build
Download switches
Two constants in src/config.ts control the home page's download block (the hero button and the one at the bottom of
the page); the first also sets the header button. Both are false until the launcher has real releases.
| Constant | false (now) | true |
|---|
launcherDownloadEnabled | The button reads Coming soon, has no link, is aria-disabled and styled neutral; the OS-detection script is not loaded. The header button (home and docs) reads Coming soon and links to the status page; the footer has no Download link | The button reads Download the Launcher and, with a release, points at the installer for the visitor's OS (see Release data); the header button reads Download |
showPlatformDownloads | Nothing under the button | The latest-release line, one card per platform (a platform without an asset says "Coming soon") and a short note linking to the supported versions |
When the first launcher release is published, set both to true and rebuild. The release fetch runs either way, so the
changelog is unaffected. The supported disc (region, serial, version) is named only in the docs: Supported versions,
the FAQ and Dumping your disc.
Release data
At build time (never in the browser), src/lib/releases.ts calls
GET https://api.github.com/repos/{org}/{repo}/releases for the launcher and the game repo.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
