History

axiomlogicnexus 737e160f85 Add production env readiness templates		2026-06-22 02:39:52 +00:00
..
public/branding	Add website auth surfaces and package validation proof	2026-06-22 02:18:59 +00:00
scripts	Add production env readiness templates	2026-06-22 02:39:52 +00:00
server	Add production env readiness templates	2026-06-22 02:39:52 +00:00
src	Add website runtime deployment diagnostics	2026-06-22 02:30:46 +00:00
.env.example	Add website runtime deployment diagnostics	2026-06-22 02:30:46 +00:00
.env.production.example	Add production env readiness templates	2026-06-22 02:39:52 +00:00
index.html	Add website auth surfaces and package validation proof	2026-06-22 02:18:59 +00:00
package-lock.json	Add website auth surfaces and package validation proof	2026-06-22 02:18:59 +00:00
package.json	Add website deployment readiness check	2026-06-22 02:36:28 +00:00
README.md	Add production env readiness templates	2026-06-22 02:39:52 +00:00
tsconfig.json	Add website auth surfaces and package validation proof	2026-06-22 02:18:59 +00:00
tsconfig.node.json	Add website auth surfaces and package validation proof	2026-06-22 02:18:59 +00:00
vite.config.ts	Add website auth surfaces and package validation proof	2026-06-22 02:18:59 +00:00

README.md

HyperTwist Website

First-party hypertwist.app surface for HyperTwist:

public homepage, about, resources, pricing, support, and legal pages
browser-facing operator/account dashboard
shared SuperTokens auth posture reused from the FamiliarOS and ScriptoriumAI website lane
desktop download posture and desktop-link handshake endpoints
Paddle-ready pricing/check-out wiring
dashboard-side launch-readiness surface for download, checkout, auth, and notice configuration
runtime diagnostics that distinguish local, mixed, and public auth deployment posture
public open-source notices surface required by HyperTwist's MPL distribution doctrine

Why this app exists

HyperTwist already ships an embedded browser runtime inside Unreal under Content/Browser/. That runtime is not the same thing as a public website, checkout surface, or browser account shell.

This website/ directory is the dedicated public and operator-facing web surface for:

marketing and product positioning
account/authentication
billing/pricing posture
browser dashboard access
desktop distribution
public legal and open-source notices

Local development

cd /home/dev/src/HyperTwist/website
npm install
npm run dev

Frontend default URL:

http://localhost:4273

Environment templates:

local development: website/.env.example plus website/server/.env.example
public deployment scaffold: website/.env.production.example plus website/server/.env.production.example

Validation

npm run type-check
npm run test
npm run build
npm run check:runtime-readiness -- --frontend-env .env --server-env server/.env --health-url https://hypertwist.app

frontend app: website/src/
auth server: website/server/
embedded Unreal browser runtime: Content/Browser/
HyperTwist feature authority: docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md
HyperTwist roadmap authority: docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md

Deployment note

Before public launch, configure:

SuperTokens frontend/backend env vars
production download URLs
production Paddle checkout URLs
the public corresponding-source URL for MPL-covered shipped material

Do not launch the public pricing/download pages without a valid open-source notices and corresponding-source destination.

Recommended production posture is documented in:

docs/ops/HYPERTWIST_WEBSITE_RUNTIME_CONFIGURATION_GUIDE_2026-06-22.md

Use the runtime-readiness command before public launch or deployment approval: