> ## Documentation Index
> Fetch the complete documentation index at: https://docs.habitify.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget

Os widgets do Habitify oferecem uma visão rápida e completa do progresso dos seus hábitos diretamente na **Tela de Início**; assim, não é necessário abrir o aplicativo apenas para conferir sua situação.

Os widgets do Habitify foram criados para oferecer uma visão rápida, mas ainda completa, do progresso dos hábitos diretamente na Tela de Início e na Tela Bloqueada.

Este artigo apresenta todos os widgets disponíveis no Habitify.

## Tipos de widget

> [tab]  iOS
>
> ## Widgets da Tela de Início
>
> ### **Cadeias de progresso**
>
> ![Widget Cadeias de progresso no iOS](https://mintcdn.com/habitify/BdTMaSGNjs_f-fA8/images/Progress-Chain-Widget-iOS.png?fit=max\&auto=format\&n=BdTMaSGNjs_f-fA8\&q=85\&s=e9041deb76e0e34cfbdaf0ee68bd0ee8)
>
> O widget Cadeias de progresso mostra a lista de hábitos, com o progresso de cada hábito representado por um mapa de calor.
>
> As opções de intervalo de datas são: *Últimos 7 dias*, *Últimos 14 dias*, *Últimos 21 dias*, *Últimos 30 dias*, *Esta semana* e *Este mês*.
>
> Para a lista exibida, você pode escolher Todos os hábitos, Período atual do dia ou uma área personalizada.
>
> O widget está disponível em três tamanhos:
>
> * o tamanho Pequeno mostra no máximo três hábitos;
> * o tamanho Médio mostra no máximo três hábitos;
> * o tamanho Grande mostra no máximo oito hábitos.
>
> ### Sequência atual
>
> ![Widget Sequência atual no iOS](https://mintcdn.com/habitify/BdTMaSGNjs_f-fA8/images/Current-Streak-Widget-iOS.png?fit=max\&auto=format\&n=BdTMaSGNjs_f-fA8\&q=85\&s=5e19202600856deefa54821a827f1779)
>
> Este widget foi criado exclusivamente para motivar. Ele exibe o número da sequência atual de qualquer bom hábito escolhido por você.
>
> Ver sua sequência crescer diretamente na Tela de Início é um lembrete poderoso do seu compromisso.
>
> O widget está disponível apenas no tamanho Pequeno.
>
> ### Grade de consistência
>
> ![Widget Grade de consistência no iOS](https://mintcdn.com/habitify/BdTMaSGNjs_f-fA8/images/Consistency-Grid-Widget-iOS.png?fit=max\&auto=format\&n=BdTMaSGNjs_f-fA8\&q=85\&s=9c9cad8f8121b6675c50ae0aa60b0e4e)
>
> O widget Grade de consistência foi criado para mostrar o mapa de calor do progresso de um bom hábito.
>
> Ele está disponível em dois tamanhos:
>
> * o widget Pequeno mostra o progresso dos últimos 96 dias;
> * o widget Médio mostra o progresso dos últimos 216 dias.
>
> ### **Hábitos de hoje**
>
> ![Widget Hábitos de hoje no iOS](https://mintcdn.com/habitify/BdTMaSGNjs_f-fA8/images/Today-Habits-Widget-iOS.png?fit=max\&auto=format\&n=BdTMaSGNjs_f-fA8\&q=85\&s=423f622d40be9d3430835d10285adff4)
>
> O widget Hoje mostra, em um layout compacto, a lista de bons hábitos configurados para se repetir no dia atual. Você pode configurá-lo para mostrar Todos os hábitos, os hábitos no Período atual do dia ou os hábitos de uma área personalizada. Ao lado de cada hábito aparece sua sequência atual.
>
> Nesse widget, os hábitos seguem a ordem personalizada definida em Ajustes → Todos os hábitos.
>
> O widget está disponível em três tamanhos:
>
> * o tamanho Pequeno mostra no máximo três hábitos;
> * o tamanho Médio mostra no máximo três hábitos;
> * o tamanho Grande mostra no máximo oito hábitos.
>
> ### Toque para acompanhar
>
> ![Widget Toque para acompanhar no iOS](https://mintcdn.com/habitify/BdTMaSGNjs_f-fA8/images/Tap-to-Track-widget-iOS.png?fit=max\&auto=format\&n=BdTMaSGNjs_f-fA8\&q=85\&s=0c1a5434a9372256bc73a28debb979bc)
>
> O widget Toque para acompanhar permite atualizar o status do hábito diretamente na Tela de Início. Ele tem dois botões, que podem ser configurados para marcar o hábito como Concluído, Pulado ou Não realizado, ou para iniciar uma sessão do Cronômetro.
>
> O widget está disponível apenas no tamanho Pequeno.
>
> ### Dias desde
>
> ![Widget Dias desde no iOS](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Days-Since-Widget-iOS.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=18d8dfd7fc7be002fce5d9387d9e549c)
>
> O widget Dias desde ajuda você a acompanhar, diretamente na Tela de Início, um único hábito ruim cuja meta é abandoná-lo. Ele não tem botão para fazer check-in nem registrar progresso, pois, naturalmente, não incentivamos essa ação.
>
> Nesse widget, você pode ver a sequência atual alcançada ao permanecer longe do hábito ruim.
>
> O widget está disponível apenas no tamanho Pequeno.
>
> ### Progresso da meta
>
> ![Widget Progresso da meta no iOS](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Goal-Progress-Widget-iOS.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=32cca63a2c72ddc72bad07166699bb89)
>
> O widget Progresso da meta mostra uma barra de progresso de um bom hábito cuja meta é definida por semana, mês ou ano.
>
> O widget está disponível apenas no tamanho Pequeno.
>
> ### Acompanhamento do limite
>
> O widget Acompanhamento do limite representa a barra de progresso de um hábito ruim cuja meta é limitá-lo. No centro da barra, uma linha vertical vermelha marca o limite que não deve ser ultrapassado. Se você ultrapassá-lo, o valor excedente será representado em vermelho.
>
> O widget está disponível apenas no tamanho Pequeno.
>
> ![Widget Acompanhamento do limite no iOS](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Limit-Tracker-Widget-iOS.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=b9629225122278412918194902d562dc)
>
> ## Widgets da Tela Bloqueada
>
> Desde o iOS 16, a Apple oferece suporte a widgets diretamente na Tela Bloqueada. O Habitify disponibiliza um conjunto de widgets — Hábitos de hoje, Grade de consistência e Toque para acompanhar — criados especificamente para esse espaço, permitindo que você veja o progresso dos hábitos antes mesmo de desbloquear o telefone.
>
> **Como adicionar um widget à Tela Bloqueada:**
>
> 1. Mantenha pressionada a Tela Bloqueada até o botão **Personalizar** aparecer.
> 2. Toque em **Personalizar**.
> 3. Selecione **Tela Bloqueada**.
> 4. Toque na área de widgets da Tela Bloqueada para abrir a galeria.
> 5. Encontre **Habitify** na lista e escolha o widget que deseja adicionar.
> 6. Toque fora da tela de personalização para salvar as alterações.
>
>    ![Widget da Tela Bloqueada no iOS](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Lockscreen-widget-iOS.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=20af59353a15d182678147eb18414955)
>
> ## Fazer check-in com widgets
>
> Quando você toca em um hábito no widget, **o aplicativo abre na visualização Diário e destaca o hábito.** Isso ajuda você a encontrá-lo na lista e a registrar seu progresso com mais facilidade.
>
> Em especial, no widget **Toque para acompanhar**:
>
> * ao tocar no botão para Concluir, Pular ou marcar como Não realizado, o check-in é processado e salvo diretamente na Tela de Início;
> * ao tocar no Cronômetro, o aplicativo abre e leva você diretamente a ele.
>
> ## Redimensionar widgets: possibilidades e limitações
>
> O iOS da Apple tem um design mais rígido para a Tela de Início. Não é possível redimensionar widgets livremente arrastando seus cantos. Em vez disso, a capacidade de "redimensionar" se limita à escolha entre tamanhos padrão predefinidos.
>
> ### **Como redimensionar**
>
> Se você usa um tipo de widget disponível em vários tamanhos, pode alternar livremente entre eles com estas etapas simples:
>
> 1. Mantenha o widget pressionado.
> 2. Se outro tamanho estiver disponível, escolha-o no menu de contexto exibido.
>
> ### **Limitação**
>
> Outros widgets, criados em um único tamanho, podem ser redimensionados para o formato de ícone do aplicativo. No entanto, depois não será possível restaurar o tamanho sem removê-los e adicioná-los novamente pela galeria de widgets.
>
> ## Perguntas frequentes
>
> > [accordion] **Não encontro os widgets do Habitify. O que devo fazer?**
> >
> > Primeiro, confirme que a versão mais recente do Habitify está instalada no dispositivo. Para verificar se há atualizações:
> >
> > * Abra a **App Store**.
> > * Toque no ícone do seu perfil no canto superior direito.
> > * Role para baixo e veja se há uma atualização disponível para o Habitify.
> > * Se houver uma atualização, toque em **Atualizar**.
> >
> > Em segundo lugar, confirme que nenhuma restrição está impedindo o widget de aparecer:
> >
> > * Abra **Ajustes**.
> > * Acesse **Tempo de Uso** → **Conteúdo e Privacidade**.
> > * Confirme que widgets são permitidos.
> >
> > Às vezes, uma simples reinicialização resolve o problema:
> >
> > * Mantenha pressionado o botão de energia até o controle deslizante aparecer.
> > * Deslize-o para desligar.
> > * Depois que o dispositivo desligar, mantenha o botão de energia pressionado novamente até o logotipo da Apple aparecer.
> >
> > Se o widget ainda não aparecer, tente reinstalar o aplicativo:
> >
> > * Mantenha pressionado o ícone do aplicativo Habitify e selecione **Remover App**.
> > * Acesse a **App Store** e reinstale o Habitify.
>
> > [accordion] **O widget não reflete as alterações do hábito. O que devo fazer?**
> >
> > Estes são os principais motivos de atraso:
> >
> > * **Otimização agressiva da bateria:** este é o motivo mais comum. Para oferecer bateria durante o dia inteiro, o sistema operacional do telefone — tanto iOS quanto Android — limita ativamente a frequência com que processos em segundo plano, como widgets, podem "despertar" para buscar dados novos. O sistema pode decidir adiar uma atualização por vários minutos ou mais.
> >
> > * **Widgets são processos separados:** um widget é um miniaplicativo na Tela de Início. Ele precisa se comunicar com o aplicativo principal do Habitify para obter as informações mais recentes. Se o aplicativo principal tiver sido suspenso pelo sistema operacional, algo especialmente comum no Android, o widget não conseguirá obter novos dados e exibirá as últimas informações recebidas.
> >
> > Antes de acessar configurações específicas do dispositivo, tente estas etapas simples, que resolvem os problemas mais comuns de widgets em qualquer plataforma.
> >
> > 1. **Abra o aplicativo Habitify:** a primeira etapa mais simples é abrir o aplicativo principal do Habitify e deixá-lo em primeiro plano por 30 a 60 segundos. Isso geralmente força o widget a sincronizar os dados mais recentes.
> > 2. **Remova e adicione novamente o widget:** se isso não funcionar, remova o widget da Tela de Início e adicione-o novamente. Isso força o recarregamento completo da configuração.
> > 3. **Reinicie o dispositivo:** uma reinicialização completa do telefone é uma solução clássica por um bom motivo: ela pode eliminar falhas temporárias do sistema que estejam afetando os widgets.
> >
> > Os widgets do iOS são atualizados de acordo com uma programação gerenciada pelo sistema. Se o cache estiver desatualizado, você poderá forçar uma atualização.
> >
> > * **Edite o widget:** mantenha pressionado o widget do Habitify e toque em **Editar Widget**. Tente alternar a fonte de dados — por exemplo, mude de "Todos os hábitos" para uma "Área" e depois volte — ou selecione novamente o hábito específico na lista. Essa ação muitas vezes força o recarregamento dos dados.
> > * **Ative a Atualização em 2º Plano:** permita que o iOS atualize o widget em segundo plano. No iPhone, acesse **Ajustes → Geral → Atualização em 2º Plano** e confirme que a configuração está ativada e que o Habitify também está habilitado.
>
> > [accordion] **Por que os hábitos ruins não aparecem em alguns widgets?**
> >
> > Hábitos ruins não são compatíveis com os widgets Hábitos de hoje e Cadeias de progresso. O principal motivo dessa escolha é manter sua lista diária de tarefas concentrada e motivadora.
> >
> > 1. **Sua "Lista de hoje" serve para você agir.** Esse widget foi criado como uma lista diária, lembrando as ações positivas que você precisa **realizar**. Incluir um hábito ruim, como "Não fumar", em uma lista de coisas *a fazer* pode ser contraproducente. O objetivo é evitar e esquecer o hábito ruim, e não ser lembrado dele junto às tarefas positivas.
> > 2. **A "Cadeia de progresso" serve para celebrar o sucesso.** O objetivo desse widget é criar uma cadeia visual e satisfatória das suas conquistas. Nos hábitos ruins, o sucesso é obtido por meio da *inação* ou da *abstenção*. Se esses hábitos fossem incluídos, o widget exibiria apenas uma sequência de blocos vazios ou com falha ("X"), o que não é muito motivador para ver todos os dias na Tela de Início.
> >
> > Ao manter esses widgets concentrados em seus bons hábitos, buscamos criar um painel mais positivo e voltado à ação no seu dia.
>
> > [accordion] **Por que meu widget do Habitify desaparece quando o iPhone está bloqueado?**
> >
> > Isso não é um erro: é um recurso de privacidade do iOS. Por padrão, o iOS oculta todo o conteúdo dos widgets quando o telefone está bloqueado para impedir que informações confidenciais sejam vistas sem autenticação.
> >
> > Se quiser que os hábitos do Habitify permaneçam visíveis na Tela Bloqueada o tempo todo, altere essa configuração. Siga estas etapas:
> >
> > 1. Abra os **Ajustes** do iPhone.
> > 2. Role para baixo e toque em **Face ID e Código** (ou **Touch ID e Código**, dependendo do modelo do iPhone).
> > 3. Digite o código da tela.
> > 4. Role para baixo até a seção **Permitir Acesso Quando Bloqueado**.
> > 5. Ative a opção **Widgets da Tela Bloqueada** (em versões anteriores do iOS, ela pode ser chamada de **Visualização Hoje e Busca**).

> [tab] 🤖 Android
>
> ## Widgets da Tela de Início
>
> ### **Grade de consistência**
>
> O widget Grade de consistência foi criado para representar o mapa de calor do progresso de um bom hábito. A quantidade de histórico exibida depende do tamanho definido na Tela de Início.
>
> ![Widget Grade de consistência no Android](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Consistency-Grid-widget-Android.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=02e77e5a75ce03567fdbd9b771a06131)
>
> ### **Dias desde**
>
> O widget Dias desde ajuda você a acompanhar, diretamente na Tela de Início, um único hábito ruim cuja meta é abandoná-lo. Ele não tem botão para fazer check-in nem registrar progresso, pois, naturalmente, não incentivamos essa ação.
>
> Nesse widget, você pode ver a sequência atual alcançada ao permanecer longe do hábito ruim.
>
> ![Widget Dias desde no Android](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Days-Since-Widget-Android.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=19a44431a88c0c53ba5cb1a2ba65d114)
>
> ### **Acompanhamento da meta**
>
> O widget Acompanhamento da meta foi criado para ajudar você a acompanhar um hábito com meta semanal, mensal ou anual, seja ele um bom hábito ou um hábito ruim que você deseja limitar.
>
> * Em um bom hábito, ele mostra uma barra do progresso em direção à meta.
>
>   ![Widget Progresso da meta no Android](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Goal-progress-widget-Android.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=6d1aed2637b856cce92df16ff61def02)
>
> * Em um hábito ruim que deve ser limitado, ele mostra uma barra de progresso em relação ao limite, com uma linha vertical vermelha no centro para marcar o valor que não deve ser ultrapassado. Se você ultrapassá-lo, o valor excedente será representado em vermelho.
>
>   ![Widget Acompanhamento do limite no Android](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Limit-Tracker-Widget-Android.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=c373f3e081a766d73ea23837cb8ccadc)
>
> ### Sequência atual
>
> Este widget foi criado exclusivamente para motivar. Ele exibe o número da sequência atual de qualquer hábito escolhido por você.
>
> ![Widget Sequência atual no Android](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Current-Streak-Widget-Android.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=a3c25caba8b8ffdd8a6e2ba600572472)
>
> ### Hábitos de hoje
>
> O widget Hoje mostra, em um layout compacto, a lista de bons hábitos configurados para se repetir no dia atual. Você pode configurá-lo para mostrar todos os hábitos ou a lista de hábitos de uma área. Ao lado de cada hábito aparece sua sequência atual.
>
> Nesse widget, os hábitos seguem a ordem definida por você na tela Diário do aplicativo.
>
> Quando um hábito é concluído:
>
> * sua sequência é atualizada;
> * ele é movido para o fim da lista, priorizando os hábitos ainda não concluídos.
>
>   ![Widget Hábitos de hoje no Android](https://mintcdn.com/habitify/ACnRM_li7bdhOwZq/images/Today-habits-widget-Android.png?fit=max\&auto=format\&n=ACnRM_li7bdhOwZq\&q=85\&s=d02876729754ed046927e089aa8f6813)
>
> ## Fazer check-in com widgets
>
> Quando você toca em um hábito no widget, o aplicativo abre na visualização Diário e move a tela até o hábito. Isso ajuda você a encontrá-lo na lista e a registrar seu progresso com mais facilidade.
>
> ## **Redimensionar widgets: possibilidades e limitações**
>
> O sistema operacional Android foi criado para ser muito flexível, permitindo que o usuário redimensione livremente a maioria dos widgets depois de posicioná-los.
>
> ### **Como redimensionar**
>
> 1. Posicione um widget do Habitify na Tela de Início.
> 2. Mantenha o widget pressionado até aparecerem as alças de redimensionamento — pontos ou linhas nas bordas.
> 3. Arraste as alças para aumentar ou diminuir o widget até o tamanho desejado.
> 4. O conteúdo do widget se ajustará automaticamente às novas dimensões.
>
> ### **Limitação**
>
> A principal limitação no Android pode ser o iniciador específico do dispositivo. Alguns fabricantes apresentam pequenas diferenças no modo de redimensionar widgets.
>
> ## Perguntas frequentes
>
> > [accordion] **Os widgets não atualizam o progresso dos hábitos. O que devo fazer?**
> >
> > Antes de acessar configurações específicas do dispositivo, tente estas etapas simples, que resolvem os problemas mais comuns de widgets em qualquer plataforma.
> >
> > 1. **Abra o aplicativo Habitify:** a primeira etapa mais simples é abrir o aplicativo principal do Habitify e deixá-lo em primeiro plano por 30 a 60 segundos. Isso geralmente força o widget a sincronizar os dados mais recentes.
> > 2. **Remova e adicione novamente o widget:** se isso não funcionar, remova o widget da Tela de Início e adicione-o novamente. Isso força o recarregamento completo da configuração.
> > 3. **Reinicie o dispositivo:** uma reinicialização completa do telefone é uma solução clássica por um bom motivo: ela pode eliminar falhas temporárias do sistema que estejam afetando os widgets.
> >
> > No Android, os problemas com widgets quase sempre são causados por configurações agressivas de otimização da bateria que impedem o aplicativo de funcionar em segundo plano.
> >
> > * **Defina a bateria como Sem restrições:** esta é a etapa mais importante. No telefone, acesse **Definições** → **Aplicativos** → **Habitify** → **Bateria** → altere a configuração para **Sem restrições**.
> > * **Bloqueie o aplicativo nos recentes, principalmente em Xiaomi/OnePlus/Oppo:** abra a tela "Aplicativos recentes". Mantenha pressionada a prévia do Habitify e toque no ícone de cadeado. Isso informa ao sistema do telefone que o Habitify deve ser priorizado e não encerrado automaticamente.
> > * **Verifique as permissões de início automático:** nas definições do telefone, encontre o gerenciador de **Início automático** ou **Inicialização** e confirme que o Habitify está ativado.
>
> > [accordion] **Por que meus hábitos ruins não aparecem em alguns widgets?**
> >
> > Hábitos ruins não são compatíveis com o widget Hábitos de hoje. O principal motivo dessa escolha é manter sua lista diária de tarefas concentrada e motivadora.
> >
> > 1. **Sua "Lista de hoje" serve para você agir.** Esse widget foi criado como uma lista diária, lembrando as ações positivas que você precisa **realizar**. Incluir um hábito ruim, como "Não fumar", em uma lista de coisas *a fazer* pode ser contraproducente. O objetivo é evitar e esquecer o hábito ruim, e não ser lembrado dele junto às tarefas positivas.
> > 2. **A "Cadeia de progresso" serve para celebrar o sucesso.** O objetivo desse widget é criar uma cadeia visual e satisfatória das suas conquistas. Nos hábitos ruins, o sucesso é obtido por meio da *inação* ou da *abstenção*. Se esses hábitos fossem incluídos, o widget exibiria apenas uma sequência de blocos vazios ou com falha ("X"), o que não é muito motivador para ver todos os dias na Tela de Início.
> >
> > Ao manter esses widgets concentrados em seus bons hábitos, buscamos criar um painel mais positivo e voltado à ação no seu dia.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.