# Caldeira

Janela de terminal escura em que a pessoa digita comandos, vê respostas coloridas e acompanha um deploy de demonstração.

> Caldeira é um componente exclusivo do THM Componentes que simula uma linha de comando no navegador: a pessoa digita ls, cd e cat num sistema de arquivos virtual, completa com Tab, volta no histórico pelas setas e vê saídas coloridas. Um deploy simulado mostra barras de progresso. Serve para documentação de CLI, tutoriais e onboarding de desenvolvedores.

- Categoria: Aplicações e produtividade
- Origem: Exclusivo THM, criado pela THM Tecnologia Inteligente; o prompt traz o código-fonte completo
- Peso no carregamento: Leve: CSS ou JavaScript leve, sem custo perceptível
- Tecnologia: Vue 3, TypeScript
- Interação: Mouse, Toque, Teclado
- URL: https://vibecode.thmtecnologia.com/componentes/caldeira/

## Como ele é

Parece a janela de um terminal de computador em modo escuro: fundo azul-marinho com um brilho anil num canto e ciano no outro, três pontinhos discretos no topo, o título no centro e botões para copiar e limpar. O texto usa fonte monoespaçada; o prompt mostra a pasta atual e uma seta, seguido de um cursor em bloco que pisca. As respostas vêm em cores, com pastas em azul e sucessos em verde. Na demonstração, os comandos se digitam sozinhos até a pessoa começar a digitar, e o deploy gira um indicador e enche barras até mostrar o endereço publicado. Também existe um tema claro.

## Você pode estar procurando isto se pediu algo assim

- “um terminal de mentira no site para mostrar como usar minha CLI”
- “janela de linha de comando que digita os comandos sozinha”
- “simular um deploy com barra de progresso na página de documentação”
- “tela escura tipo terminal em que o visitante consegue digitar comandos”
- “aquele terminal com texto colorido para a home de um produto para devs”
- “tutorial interativo em que o usuário testa comandos sem instalar nada”
- “mostrar a instalação do meu pacote num terminal animado”

## Também chamado de

terminal simulado, terminal no navegador, emulador de terminal, linha de comando, fake terminal, terminal emulator, web terminal, CLI demo

## Quando usar

- Documentação de CLI e de SDK que precisa mostrar comandos e respostas
- Home e onboarding de produtos para desenvolvedores
- Tutoriais interativos em que a pessoa testa comandos sem instalar nada
- Demonstrações de deploy ou de instalação em páginas de lançamento

## Quando evitar

- Quando os comandos precisam rodar de verdade num servidor, já que o terminal só simula, com arquivos virtuais
- Públicos que não são técnicos, para quem uma tela de terminal assusta mais do que explica

## Como pedir para a sua IA

```text
Crie um terminal simulado na página de documentação da minha CLI: comandos próprios que respondem como o produto real, Tab para completar, histórico nas setas, cores ANSI, um roteiro que digita sozinho e para quando a pessoa interage, e versão sem animação para movimento reduzido.
```

Com o THM Componentes, você cola o prompt completo do catálogo, que já traz o código-fonte deste componente, e a IA reproduz este efeito exato em vez de improvisar.

## Perguntas sobre Caldeira

### Como faço Caldeira responder aos comandos do meu produto?

Você registra comandos próprios pela prop commands, cada um com nome, descrição e uma função run que pode ser assíncrona. Ela recebe os argumentos e funções para imprimir, reescrever a última linha, esperar e ler o sistema de arquivos virtual. Caldeira também aceita a prop files para montar pastas e arquivos sob medida.

### Caldeira funciona no celular?

Funciona. A linha de comando de Caldeira é um campo de texto real, então o teclado do celular serve para digitar e enviar comandos, e a saída rola normalmente. Atalhos como Tab e Ctrl+C dependem de teclado físico, então no celular o autocompletar fica de fora. Em telas pequenas, a fonte e as margens diminuem.

### Caldeira respeita quem prefere menos movimento?

Sim. Com a preferência de movimento reduzido ativa, Caldeira mostra cada comando do roteiro de uma vez, sem a digitação letra a letra, encurta as etapas do deploy simulado e para de piscar o cursor. O roteiro também espera o terminal ficar visível na tela para continuar.

## Componentes relacionados

- [Ateliê](https://vibecode.thmtecnologia.com/componentes/atelie/): Editor de código com cores por linguagem, números de linha, busca e blocos que recolhem, direto na sua página.
- [Biombo](https://vibecode.thmtecnologia.com/componentes/biombo/): Tela dividida em áreas que você aumenta, diminui ou recolhe arrastando as linhas entre elas, como num editor de código.
- [Errata](https://vibecode.thmtecnologia.com/componentes/errata/): Mostra o que mudou entre duas versões de um código ou texto, em vermelho e verde, para aceitar ou rejeitar cada trecho.
- [Telegrama](https://vibecode.thmtecnologia.com/componentes/telegrama/): As letras aparecem uma a uma com um cursor piscando, somem e dão lugar à próxima palavra da lista.
- [Gaveteiro](https://vibecode.thmtecnologia.com/componentes/gaveteiro/): Lista de pastas e arquivos que abre e fecha com um clique, como o explorador de um editor de código.

---
THM Componentes: O THM Componentes é um catálogo de 268 componentes de interface para Vue 3 e Nuxt, 115 deles exclusivos, com demonstração ao vivo e um prompt pronto para Claude Code, Cursor e outros assistentes. Você escolhe o efeito, copia o prompt e a sua IA aplica no projeto. Acesso vitalício por R$ 497.
