Wraith Protocol — Landing Page

The landing page for usewraith.xyz. A minimal, dark, developer-focused single-page site that explains what Wraith Protocol is and links to docs, demo, and console.

Stack

• Vite + React + TypeScript
• Tailwind CSS v4
• Deployed to Vercel

Development

pnpm install
pnpm dev

Build

pnpm build

The build pipeline performs the following steps:

1. Compiles TypeScript and builds the client production assets via Vite.
2. Runs the Open Graph image generator (scripts/og.ts) to pre-render cards for all routes and patches the output HTML files with page-specific titles, descriptions, and JSON-LD breadcrumb schemas.
3. Runs the sitemap generator (scripts/gen-sitemap.mjs) to generate a fresh sitemap.xml covering all static and dynamic routes.

Serverless routes

vite preview only serves the static build, so the API routes (/api/subscribe in api/subscribe.ts and /api/og in src/api/og.tsx) are unavailable locally and on CI runners. pnpm preview:functions serves the same dist/ output with those routes mounted on port 4174:

pnpm build
pnpm preview:functions

Smoke tests

pnpm test:smoke

Smoke tests run against scripts/preview-server.ts over HTTP: the subscribe proxy (including invalid input, provider conflicts, outages and the unconfigured case) and the OG image endpoint (rendering, query escaping, cache headers and the failure response). Buttondown is stubbed, so no mail is sent and no test touches the network. The suite runs on every pull request in CI.

SEO & Metadata

• robots.txt: Located in public/robots.txt and copied to the build root. It allows search engine crawling while excluding staging, preview, admin, and 404 routes, and points crawlers to the sitemap location.
• sitemap.xml: Dynamically compiled during build time into dist/sitemap.xml and public/sitemap.xml.
• JSON-LD: Embedded in the site's <head>:
  • Global Organization schema representing Wraith Protocol.
  • Global SoftwareApplication schema representing the Wraith SDK.
  • Page-specific BreadcrumbList schema dynamically injected for each static route slug (e.g. /stellar, /faq, etc.) at build time.

Format

pnpm format        # write
pnpm format:check  # check only