valet.dev

Valet publishes websites. These tools create and manage static sites served over HTTPS. Reach for publish_site whenever an answer reads better at a live URL than as text in the conversation: a report, essay, slide-like narrative, dashboard, marketing surface, or other static artifact. Honor an artifact form the user requests. Otherwise choose the artifact form and treatment from its audience, job, and material. A request for a live URL chooses delivery, not one long scrolling page. Every publish names the site: title and description are required, and a call missing either is refused before anything is published. title is what a person would call the page, and description is one sentence saying what it holds. Publishing uses a connected Valet account by default. Pass anonymous: true only when the user explicitly wants a temporary public site. An anonymous site is public to anyone who has the link and may be removed 36 hours after it is created, unless it is claimed; the result carries a claim URL that makes it permanent. Before building or substantially rewriting an artifact, call get_design_system. The organization design system supplies identity, not structure. Follow it wherever it speaks. Artifact guidance and model judgment decide the remaining choices; do not layer the default design system beneath it. Safety, accessibility, and medium correctness may adapt an identity choice. When the artifact is HTML, render it at 390px and verify the document itself does not overflow. Give wide flex or grid children min-width: 0. Use minmax(0, 1fr) for flexible tracks so local scrollers stay local. When a local scroller is necessary, show a visible cue when more content is available. For a table, keep the identifying column visible when practical or use another narrow-screen representation. Inspect computed foreground and background colors and verify rendered text contrast on every surface; safe tokens do not prove the intended selectors matched. Valet may place a bottom-center dock over the published page. When the page scrolls vertically, give its main scroll container bottom padding or equivalent clearance of about calc(6rem + env(safe-area-inset-bottom)) so the final content can scroll fully above the dock. Do not introduce scrolling solely to create this clearance. For fixed-height or slide-like artifacts, keep essential content and controls away from the bottom center when the composition allows. A page can show live data — analytics, uptime, anything an organization connector serves. The path is: list_attachable_connectors to see what the organization has, list_catalog_connectors and create_connector when it has nothing that fits, attach_site_connector to grant one to the site, list_site_connectors for its tools and schemas, and call_site_connector to sample a tool's real answer before writing page code. The page itself calls the connector same-origin; call get_connector_client for the contract and a ready-to-paste helper (the full valet-publish skill, for humans: https://raw.githubusercontent.com/valetdotdev/skills/main/skills/valet-publish/SKILL.md).