Veklom Frontend

This repository builds the public website and browser-facing Veklom application. The frontend is a client and proxy surface; it is not a consequence-authority engine. CAPPO remains the final ALLOW/DENY boundary for consequential execution.

Current architecture

• Core V1 runs on Veklom-owned/local hardware with Docker and Cloudflare Tunnels.
• This frontend is currently delivered as a Docker service behind the Cloudflare Tunnel. GitHub Actions verifies the source; merging to main does not deploy or restart production.
• Cloudflare Pages may be used for separately assigned static surfaces; do not infer that this application is deployed there.
• Coolify, Hetzner, Vercel, Headless, and legacy Control Plane/BYOS materials are not current architecture instructions. Historical references remain only as evidence to reconcile.
• The canonical architecture lock is in reprewindai-dev/veklom-ops-command/CURRENT_ARCHITECTURE_LOCK.md.

Stack

• Next.js App Router
• React and TypeScript
• Tailwind CSS
• Jest unit tests

Local development

Use Node.js 22, matching the repository CI configuration. Install the committed npm lockfile and start the development server:

npm ci --legacy-peer-deps
npm run dev

The local development server defaults to port 3002.

Verification

npm run lint
npm run typecheck
npm test
npm run build

Passing these checks establishes frontend source/build behavior only; it is not evidence of a deployed release or the full LockerPhycer → VLink → cAPI → CAPPO consequence journey.

Historical material

The prior README snapshot is preserved at docs/README_LEGACY_2026-09-24.md. It includes superseded BYOS/UACP and Coolify/Hetzner topology claims. The detailed legacy architecture files are likewise marked superseded; do not follow them as current product or deployment specs.