Web Presence (web-presence)¶
Audience: Brand / marketing visitors · Dev port: see compose · Stack: React 19 + Vite + TypeScript + Tailwind · Purpose: the public brand site with an embedded agent-first RAG chat canvas; fronts the apex domain.
The Web Presence app is the company's production-quality brand surface. Its centrepiece is an augmented generative-UI chat canvas: a RAG-backed conversation that can render structured blocks (service cards, contact form, narrated pages) from a fixed, GEO-safe block registry.
At a glance¶
| Property | Value |
|---|---|
| App directory | frontends/web-presence/ |
| Prod URL | https://portugalodyssey.pt (apex; the cutover target) |
| Audience | Prospective travellers, partners, press |
| Backend | ai-service /api/v1/chat (RAG) via the API Gateway public lane |
Key concepts¶
- Agent-first chat canvas — the landing experience is a chat, not a static hero. Language-change greeting, suggestion chips, nav-feeds-chat wiring.
- Render directive registry — the LLM emits directives; the frontend deterministically renders a fixed set of blocks (service-card, contact form, passive-page narration). Validated client-side.
- Autonomy toggle — Guided (default) vs Classic; Classic suppresses chips/greeting/interception.
- Share/OG cards — Satori-rendered Open Graph images per landing/lugar.
Documentation¶
- HTML-on-canvas explanation — the rendering approach behind share/OG cards.
- How to render an OG card with Satori — practical recipe.
- HTML-on-canvas reference — the API surface.
See also¶
- Frontend Applications overview — all four frontends.
- Public Frontend — the booking app that web-presence hands travellers off to.