Canonical public site: https://getsillage.github.io/
Source repository: getsillage/getsillage.github.io
This is the product showcase site for Sillage — a self-hosted, single-user space for private records, history review, and AI answers grounded in your own notes.
Sillage is available through its responsive Web interface in English or Simplified Chinese. Users access their instance from desktop or mobile browsers without installing a client.
This repository is separate from the product monorepo. Documentation, releases, engineering governance (make check, constitution, CI), and the application itself live in the main project (sillage). Keep the public one-line product description, Web-only access, and “no multi-user / no official hosting” claims aligned with the current monorepo READMEs.
- Single-page product landing (English / Simplified Chinese)
- Light and dark themes
- Interactive demo at
#/demo, using the actual Sillage Web UI with 96 fictional records, photos, history, calendar, search, favorites, and archives - SEO: Open Graph, Twitter cards, JSON-LD, robots.txt, sitemap
- Hash-based Content Security Policy, security headers, and HTML cache controls
- Latest release tag pulled from GitHub for the Docker quick start
- Static build suitable for Cloudflare Pages, GitHub Pages, Netlify, etc.
The demo can be opened from the navigation, hero, or illustrated product preview. It renders an unchanged snapshot of the actual Sillage Web client in a separate document, preserving the product's sidebar, Markdown editor, record rows, calendar, details, Ask, settings, mobile drawer, and themes. Only the outer demo notice and browser-local API/data adapter are specific to the experience page. The 96 fictional records include older entries for On This Day; images appear in record details as in the product. Demo changes stay in the current browser and can be reset from the demo notice. Ask uses clearly labelled preset answers and real demo-record references without calling an AI provider. No product server or account is needed. Photos are bundled locally; sources are documented in public/demo/SOURCES.md.
The Web UI snapshot and its upstream revision are recorded in src/demo/product/UPSTREAM.md. Refresh it from the adjacent product checkout with node scripts/sync-demo-product.mjs. The website repository includes the snapshot so standalone builds do not require a second checkout. Do not modify the copied product components to change the demo. Interface language follows the real product behavior: changing language translates controls, not existing record content.
File uploads and real account/AI-provider configuration are unavailable in this browser-only demo; unsuccessful uploads retain the draft. Hosting CSP and frame headers allow only same-origin embedding for the isolated product document.
- Vite + React + TypeScript
- Tailwind CSS v4
- Node.js 20+
npm install
npm run devmake check # install, audit, lint, typecheck, tests, build, docs, Actions pins
make check-web
make check-docs
make check-actionsCI runs make check on pull requests and main. The gate includes component, interaction, accessibility, release-fallback, and post-build security/SEO tests. The GitHub Pages workflow runs the same gate before uploading a deployable artifact. Third-party Actions are pinned to immutable commit SHAs, dependency lifecycle scripts are deny-by-default, and Dependabot checks npm plus GitHub Actions weekly.
Optional local env (see .env.example):
cp .env.example .env
# set VITE_SITE_URL=https://your.domainVITE_SITE_URL=https://your.domain npm run build
npm run previewOutput is written to dist/. The post-build step rewrites robots.txt / sitemap.xml, injects absolute canonical / OG URLs when VITE_SITE_URL is set, generates a base-aware 404.html, and applies a CSP whose hashes match the final inline bootstrap scripts. Production jobs may set REQUIRE_SITE_URL=1 to reject missing, non-HTTPS, or base-mismatched public URLs.
- Use the organization Pages repository name
getsillage.github.io. - Settings → Pages → Source: GitHub Actions.
- The default public URL is
https://getsillage.github.io/; set the repository variableSITE_URLonly when using a custom domain. - Push to
main— workflow Deploy GitHub Pages builds and publishesdist/at the root path.
For a custom domain, add a CNAME file under public/ (or configure it in the Pages UI) and set SITE_URL to that domain.
| Setting | Value |
|---|---|
| Build command | npm run build |
| Build output | dist |
| Node version | 22 (or 20) |
| Env var | VITE_SITE_URL = your public origin |
public/_headers and public/_redirects are included for security headers and SPA fallback.
Upload the contents of dist/ after npm run build.
Copy tracks the main repository:
Update src/config/site.ts (defaultReleaseTag) if the pinned fallback release changes. The live site prefers GitHub’s latest release API.
MIT (aligned with Sillage).