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
72 changes: 72 additions & 0 deletions .github/workflows/landing.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
name: Landing

# The landing is its own deployment (sterish.xyz) and its own pnpm project, so
# it needs its own gate: the Frontend workflow is filtered to `frontend/**` and
# would never see a change here.
#
# `frontend/**` is in the triggers on purpose, even though nothing in this job
# builds the dashboard. The landing carries a copy of the design tokens and
# `tokens.drift.test.ts` compares it against `frontend/app/globals.css`, so a
# token edit made only on the dashboard side has to run this job — otherwise
# the guard sits there green while the two apps quietly diverge.
on:
push:
branches: [main]
paths:
- 'landing/**'
- 'frontend/app/globals.css'
- '.github/workflows/landing.yml'
pull_request:
branches: [main]
paths:
- 'landing/**'
- 'frontend/app/globals.css'
- '.github/workflows/landing.yml'
workflow_dispatch:

concurrency:
group: landing-${{ github.ref }}
cancel-in-progress: true

jobs:
build:
name: landing install + lint + build
runs-on: ubuntu-latest
defaults:
run:
working-directory: landing
steps:
- uses: actions/checkout@v4

# Before setup-node: `cache: pnpm` needs the pnpm binary on PATH to
# resolve the store directory. The version comes from `packageManager` in
# landing/package.json, pinned in one place.
- name: Set up pnpm
uses: pnpm/action-setup@v4
with:
package_json_file: landing/package.json

- name: Set up Node 20
uses: actions/setup-node@v4
with:
node-version: '20'
cache: pnpm
cache-dependency-path: landing/pnpm-lock.yaml

- name: Install dependencies
run: pnpm install --frozen-lockfile

- name: Type check
run: pnpm typecheck

- name: Lint
run: pnpm lint

# Covers the two figures the page states as fact and the token drift
# guard, which fails if landing/app/globals.css and
# frontend/app/globals.css have stopped agreeing.
- name: Test
run: pnpm test

- name: Build
run: pnpm build
16 changes: 15 additions & 1 deletion docs/deployments.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,25 @@ address has not changed and is the same contract it always was — see
| **API** | **https://api.sterish.xyz** | VPS `187.53.142.100` via Cloudflare Tunnel (STE-54) | Canonical. `REPORT_BASE_URL`, the x402 `resource.url` and the STE-48 `challenge_url` all use it |
| API (alias) | https://api-sterish.jameshub.fun | same stack, same tunnel | Kept so anything already pointing at it keeps working |
| **Dashboard** | **https://app.sterish.xyz** | Vercel | Public since 24 September; renders live registry data and calls the API at `api.sterish.xyz` |
| Landing | https://sterish.xyz | — | Reserved for the landing page (STE-23); currently 404 |
| **Landing** | **https://sterish.xyz** | Vercel, **root directory `landing/`** | Its own deployment and its own pnpm project, separate from the dashboard (STE-23) |

The API allows any origin (`api-spec.md` §6): everything it serves is public ledger data, so the
dashboard moving hostnames needs no change on the API side.

**Two Vercel projects, one repo.** The landing and the dashboard are separate deployments
because they answer different first questions: someone arriving at `sterish.xyz` has usually
never heard of Sterish and needs the argument, while someone opening `app.sterish.xyz`
already knows and wants the registry. So the landing has no product nav and no wallet button.

Set each project's **Root Directory** in Vercel: `landing/` for `sterish.xyz`, `frontend/` for
`app.sterish.xyz`. Each installs its own `pnpm-lock.yaml`. Neither needs environment variables
to build; `NEXT_PUBLIC_API_URL` defaults to `https://api.sterish.xyz` in the landing.

The two apps share the design tokens by **copy**, not by import, and the copy is guarded:
`landing/src/modules/landing/tokens.drift.test.ts` reads both `globals.css` files and fails
the build when they disagree. Change tokens in `frontend/app/globals.css` first, then bring
the change across. The Landing workflow runs on changes to that file for exactly this reason.

---

## Testnet — 2026-09-03 (STE-13)
Expand Down
13 changes: 0 additions & 13 deletions frontend/app/landing/page.tsx

This file was deleted.

11 changes: 11 additions & 0 deletions landing/.env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Copy to .env.local and edit. .env.local is gitignored; this file is tracked.
# Everything here is public: NEXT_PUBLIC_ values are inlined into the browser
# bundle, so no secret ever belongs in this file or in .env.local.

# Where the verification API lives. Must be absolute: these reads also run in
# server components, where a relative path has no origin to resolve against.
# Defaults to the production API, so the landing builds with no env at all.
#
# live testnet API https://api.sterish.xyz
# local API http://localhost:8000
NEXT_PUBLIC_API_URL=https://api.sterish.xyz
9 changes: 9 additions & 0 deletions landing/.npmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Read by pnpm (it honours .npmrc). `pnpm install --frozen-lockfile` is what CI
# and `make install-dashboard` use, so pnpm-lock.yaml is the source of truth.
save-exact=false
fund=false

# Next.js resolves its own plugins (SWC, eslint-config-next) through the package
# it was required from, so pnpm's default isolated store works. Nothing is
# hoisted on purpose: an undeclared import should fail here, not in production.
strict-peer-dependencies=false
59 changes: 59 additions & 0 deletions landing/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# Sterish landing (`sterish.xyz`)

A separate deployment from the dashboard, on purpose.

| | Deployment | Root directory |
|---|---|---|
| **Landing** | `sterish.xyz` | `landing/` |
| Dashboard | `app.sterish.xyz` | `frontend/` |

Two audiences that want different things on arrival. Someone who reaches
`sterish.xyz` has usually never heard of Sterish and needs the argument;
someone who opens `app.sterish.xyz` already knows and wants the registry. Same
brand, same tokens, different first frame — which is why this app has no
product nav and no wallet button.

## Running it

```bash
pnpm install
pnpm dev # http://localhost:3000
pnpm test # data layer + the token drift guard
pnpm typecheck
pnpm build
```

No env is required: `NEXT_PUBLIC_API_URL` defaults to `https://api.sterish.xyz`.
Point it at `http://localhost:8000` to develop against a local API.

## The numbers are read, never typed

`src/modules/landing/liveStats.ts` derives every figure on the page from
`GET /skills` at render time, and the rug pull from two `/check` reads. A
number typed into copy is accurate exactly once, and this page states facts to
people who cannot check them.

When the API does not answer, the page still renders and **labels itself
stale** rather than showing a stale number as if it were live.

Both reads sit behind Suspense boundaries. `GET /skills` costs roughly 2.8s
against the live API; awaiting it before rendering gave a 3.5s blank page,
measured in a production build. Streaming brings first paint to about 11ms.

## Design tokens are a copy, and the copy is guarded

`app/globals.css` is `frontend/app/globals.css` minus two imports whose
packages this app does not install. Everything else is byte-for-byte identical.

A copy is the arrangement that drifts quietly, so it is not left to anyone
remembering: `src/modules/landing/tokens.drift.test.ts` reads both files and
fails the build when they disagree. **Change tokens in
`frontend/app/globals.css` first**, then re-run the test and bring the change
across.

## Claims

Every factual claim on the page was verified before it was written, and the
record is in `docs/evidence/ste-23-landing-claims-2026-09-20.json`: both CVEs
against their published advisories, the x402 and USDC SAC wording against
Stellar's own docs, and the rug pull against the live registry.
Binary file added landing/app/apple-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading