Lolly para Desenvolvedores

A documentação técnica - para quem cria ferramentas, integra o Lolly a um pipeline, faz o self-host dele ou estende a plataforma.

O que você ganha com isso. Construa uma ferramenta uma vez e o pedido para de voltar pra você. Aquele "você pode só fazer um pra mim…" repetitivo que consome suas tardes vira um template que as outras pessoas preenchem sozinhas - direitinho, sem você precisar entrar no meio. Seu trabalho é HTML/CSS/JS puro: versionado, fácil de comparar, revisável, e roda sobre um engine aberto, sem vendor lock-in, então continua sendo seu. Automatize a produção e seu tempo vai para o problema interessante, não para a exportação número dez mil.

O Lolly é um engine independente de plataforma que executa o mesmo caminho de renderização em vários shells (web PWA, Tauri desktop/mobile, CLI, TUI). As ferramentas são dados, não código empacotado - um manifest, mais um template, mais hooks opcionais - então novas ferramentas são lançadas sem precisar de uma atualização do app. Comece pela Visão Geral para entender a arquitetura, e depois siga a trilha que combina com o que você está construindo.

Novo na plataforma? O Guia Rápido coloca uma marca e o seu primeiro render no lugar antes de você se aprofundar.

Entenda a arquitetura

• Visão Geral - por que o Lolly existe, a separação entre engine/shell/tools, a bridge de capacidades e os compromissos arquiteturais já definidos.
• Design Tokens - o modelo de tokens DTCG em que as marcas são expressas, e como as ferramentas os consomem.

Crie ferramentas

Cada controle abaixo foi gerado a partir de um input declarado no tool.json. Você escreve a linha do manifest, o host desenha o widget, e o mesmo modelo alimenta a CLI e a URL.

E isso escala bem além de cinco controles. Dê a um input um section e o host o recolhe, então uma ferramenta de cinquenta inputs como o D3 Chart Studio ainda abre como uma pilha curta, com o resto guardado atrás de grupos nomeados.

• Criação de Ferramentas - o guia completo: manifest, template, estilos, hooks, composição e publicação.
• Criação de Assets - assets do catálogo, tiers, locales, paletas, ícones temáveis e fontes.
• API do Host - a bridge de capacidades HostV1 contra a qual toda ferramenta é escrita (a única API que as ferramentas veem).
• Modo URL - cada input como um parâmetro de URL; parâmetros reservados, codificação compacta, links compactados.

Execute e integre

• CLI - renderização headless; o mesmo caminho de renderização da GUI, controlado por argv no formato --foo=bar.
• TUI - o shell de terminal interativo.
• Servidor MCP - o endpoint nativo que permite que um agente de IA descubra e execute ferramentas.
• Agentes de IA - controlando o Lolly a partir de um modelo: uma URL é a API.
• Extensão do Chrome - capture uma URL ao vivo como um asset reutilizável.

Publique e opere

• Guia de Build - compile cada target: CLI, TUI, desktop, mobile.
• Implantação - o app web, os apps e os serviços de backend; onde cada peça roda.
• Configuração - profiles, brand packs, capability gating, feature flags e validação do catálogo.

Confiança e dados

Direitos e autoria são inputs como quaisquer outros. O Embed & Track Image declara campos de autor, copyright, licença e contato, e a exportação grava tudo isso nos metadados do próprio arquivo e no manifest C2PA dele.

• Identidade de Content Credentials - assinatura emitida por uma CA para C2PA no dispositivo; contratos do engine e o runbook do operador.
• Transferência de Dados - o bundle lolly-backup: envelope, integridade e garantias entre shells.
• Sobre - o projeto, o limite da sua licença e o repositório.