Skip to content

Website Guide

Jump to bottom
Kuray Karaaslan edited this page Oct 5, 2026 · 1 revision

Website Guide

The companion website is a static Next.js export in tepegoz-browser-website. It is the public marketing/documentation site, but its claims are sourced from the product repo.

Core Idea

The website owns layout and rendering. The product repo owns the copy and claims under tepegoz-browser/docs/website/.

This prevents the site from drifting away from the code. If product behavior changes, the source copy should change in the same review.

Stack

  • Next.js static export.
  • React.
  • KUI React vendored locally.
  • Content data modules under modules/marketing/content.
  • Media ledger and provenance checks for screenshots/recordings.
  • No third-party analytics or tracking.

Commands

From tepegoz-browser-website:

npm install
npm run dev
npm run check
npm run build

npm run build runs npm run check first.

Important Checks

  • KUI import check.
  • Media manifest and asset checks.
  • Alt-text stamp checks.
  • Content rules.
  • Source drift check against tepegoz-browser/docs/website.
  • i18n extraction/check.
  • Route check.
  • TypeScript and lint.

Deployment

The site is configured for Vercel static export. vercel.json pins the build command so production uses the same gated build path as local builds.

Sources

  • tepegoz-browser-website/README.md
  • tepegoz-browser/docs/website/README.md
  • tepegoz-browser-website/package.json
  • tepegoz-browser-website/vercel.json

Clone this wiki locally