@streavent/sv-runtime

The runtime behind Streavent Vibe Sites — custom event websites, hand-built as plain HTML/CSS/JS and bound to live event data.

You write ordinary markup. <sv-*> elements and data-bind attributes mark the places where event data belongs. The same engine renders that markup on the server when the site is published, and hydrates it in the browser for interactive parts — so a preview on your laptop and the published site cannot drift apart.

This package is the tooling, not the starting point. To build a site, clone the starter: https://github.com/streavent/vibe-starter — it ships a complete example project, mock data, and the full contract (DESIGNER_CONTRACT.md).

Install

npm install --save-dev @streavent/sv-runtime

CLI

sv dev        # dev server with live preview and a contract report on every page
sv validate   # one-shot contract check, exit code 1 on errors (CI-friendly)
sv package    # validate, then zip src/ + streavent.config.json for upload

sv validate runs the same validator the Streavent platform runs when the bundle is uploaded. If it passes locally, it passes on upload.

Components

<sv-event> · <sv-speakers> · <sv-agenda> · <sv-sponsors> · <sv-events> · <sv-gallery> · <sv-capacity> · <sv-collection> · <sv-langswitch> · <sv-image>

Each list component takes your own <template> — there is no imposed markup or styling. The generated dist/COMPONENT_CATALOG.md and dist/custom-elements.json document every bindable field; editors that understand Custom Elements Manifest pick the latter up automatically.

Data source

By default the CLI renders against local mock-data/*.json, so a site can be built end to end without a backend. Pointing it at a real Streavent instance is opt-in:

VIBE_DATA_SOURCE=api \
VIBE_API_BASE_URL=https://api.streavent.de/api/app \
VIBE_EVENT_ID=<eventId> \
npx sv dev

Only public, already-published event data is read.

Browser bundle

The same components run standalone as custom elements, for embedding an agenda or speaker list on an existing site:

<script src="https://cdn.streavent.de/sv/v1/sv-runtime.js" defer></script>
<sv-agenda api-base="https://api.streavent.de/api/app" event-id="..."></sv-agenda>

sv/v1 is a stable major channel — patch releases land there automatically. Exact-version copies (sv/<version>/sv-runtime.js) exist for pinning.

License

MIT © Streavent UG (haftungsbeschränkt)