Pular para o conteúdo
início / methods / embeddability
Método transversal

Iframes como o primitivo universal de composição.

Todo serviço de contêiner — terminal, display, arquivos, editor de código, browser, UI SQLite — é uma URL HTTPS incorporável via iframe. Dashboards não são construídos em cima da infraestrutura; eles são montados a partir dela.

Um arquivo HTML + iframes = UI de infraestrutura customizada · sem SDK · sem postMessage

Tudo é um src de iframeHTTPS por padrão — incorpora em todo lugarControle via HTTP, estado refleteQualquer dispositivo, qualquer navegador
início / methods / embeddability / dashboard
Dashboard = infraestrutura

Não construa um dashboard sobre sua infra. Monte-o a partir da sua infra.

Dashboards tradicionais leem o banco de dados, fazem polling de APIs, renderizam números e gráficos. Um dashboard Hoody incorpora iframes dos próprios serviços — terminais ao vivo, displays em execução, árvores de arquivos editáveis. Não há latência de sincronização porque não há nada a sincronizar.

Sem camada de polling

O dashboard não faz polling de um endpoint de monitoramento. Ele incorpora a coisa sendo monitorada.

Leia e aja

Viu um pico de métrica? Clique no terminal incorporado ao lado e digite `top`. Sem troca de contexto.

Por cliente, por projeto, por ambiente

Componha dashboards a partir de URLs — qualquer combinação é um dashboard.

Componível por IA

Um LLM pode emitir HTML com URLs de iframe. UI de observabilidade customizada, gerada sob demanda.

início / methods / embeddability / control
Controle via HTTP

Mude o contêiner. O iframe reflete.

Sem postMessage. Sem protocolo pai-filho. Um iframe mostra uma URL de serviço; o serviço é atualizado via API HTTP; a próxima requisição que o iframe faz captura o novo estado. O iframe e a API são o mesmo contêiner.

1

App incorpora URL de serviço

A página pai insere um iframe apontando para uma URL de serviço de contêiner em seu layout.

2

App envia uma requisição HTTP de controle

POST /api/v1/files/upload (ou qualquer outra chamada API) — autenticado contra o mesmo contêiner.

3

Iframe puxa estado atualizado

Auto-refresh, SSE ou interação do usuário aciona uma nova requisição. O novo arquivo é visível no iframe.

4

Sem protocolo wrapper

Seu app nunca envia postMessage ao iframe. Ele apenas atualiza o contêiner; o iframe vê a mudança no seu próximo render.

início / methods / embeddability / devices
Agnóstico de dispositivo

Iframes renderizam em todo navegador. Todo navegador está em todo dispositivo.

Um dashboard Hoody incorporado funciona em um celular. Em um tablet. Em um browser de TV. Em um smartwatch. No browser de um headset VR. A propriedade de incorporação se estende por todo o ecossistema de dispositivos porque o navegador também.

O primitivo de composição é iframe + HTTPS. Ambos são universais. Essa é a única razão pela qual a paridade de dispositivo é automática.

início / methods / embeddability / ai-generated
UI gerada por IA

Um LLM pode compor um dashboard a partir de URLs de contêiner.

Peça a um agente 'crie um dashboard de verificação de saúde para esses três contêineres.' Ele emite HTML com tags iframe apontando para as URLs de terminal, display e exec que você nomeou. O resultado é um dashboard real e ao vivo em uma rodada de prompt.

1

Agente recebe a spec

'Preciso monitorar três contêineres: frontend, backend, db. Mostre o log de terminal de cada um.'

2

Agente emite HTML

Template com três tags iframe apontando para as URLs corretas de terminal-1 para cada contêiner.

3

Sirva de qualquer lugar

Cole em um arquivo estático, uma página Notion que permita embeds de iframe ou um contêiner Hoody dedicado rodando http-3000.

4

Abra a URL

Dashboard ao vivo. Composto a partir da infraestrutura, não de um produto de dashboard.

início / methods / embeddability / caveats
Ressalvas honestas

Onde a incorporação atinge os limites do navegador.

Iframes são um primitivo do navegador. O navegador impõe regras sobre o que pode e não pode ser incorporado. Estas são restrições universais, não específicas da Hoody — mas importam quando você está compondo UIs.

X-Frame-Options / CSP

URLs externas que definem `X-Frame-Options: DENY` ou `frame-ancestors 'none'` não podem ser incorporadas. Os próprios serviços Hoody não definem; URLs de terceiros que você incorpora podem.

Conteúdo misto

Incorporar uma URL HTTP dentro de uma página HTTPS está bloqueado. URLs Hoody são sempre HTTPS — funciona em todo lugar.

Cookies de terceiros

Navegadores bloqueiam cada vez mais cookies de terceiros. Auth dentro de iframes incorporados pode precisar de tokens por requisição em vez de cookies de sessão.

Armazenamento de terceiros

localStorage dentro de um iframe tem escopo para a origem do iframe. Estado entre iframes precisa vir do contêiner, não do navegador.

início / methods / embeddability / começar
Começar

Construa o dashboard a partir da infraestrutura, não sobre ela.

Um arquivo HTML. Algumas tags iframe. Contêineres em execução ao vivo. Essa é a stack completa.

Guia de incorporação

Veja também — /platform/os para composição dentro da Hoody, /kit/workspaces para o runtime Workspace, /methods/multiplayer para sessões de iframe compartilhadas.