Portal Getting Started

The portal is the SaaS control plane for the local-first xyva runtime.

What the portal already does

Protected /app area with login flow
Billing entry point under /app/billing
Shared project, runner, swarm and report views
Team context switching between personal and team scope
Local agent bridge status in the top bar

Prerequisites

A reachable portal deployment or local landing-site/xyva-homepage instance
AUTH_SECRET
At least one auth provider if you want OAuth or magic-link login
DATABASE_URL for profile, billing, reports and teams

Open /login.
Sign in with Google, GitHub or magic link when configured.
After login you land in /app.
Use the agent badge in the portal chrome to connect the local agent.

Recommended local startup

bash

cd landing-site/xyva-homepage
npm run build
npm run start -- --hostname 127.0.0.1 --port 3005

The portal health endpoint is available at /api/health.

What stays local

Repository contents
Playwright execution
Swarm browser activity
Local secrets stored by the agent

The portal stores summaries, team data, subscriptions and license state, not your codebase.