---
title: "Instalar como aplicativo"
description: "Instale o Notarium como PWA: uma casca offline (mas não os dados offline) e atualizações."
---

# Instalar como aplicativo

O Notarium é um PWA (Progressive Web App): você pode **instalá-lo como aplicativo**, com um ícone na tela inicial ou no seu launcher, e executá-lo em uma janela própria, sem abas nem barra de endereço do navegador. Ele abre na hora graças ao pré-cache dos recursos estáticos.

> [!important] O que fica disponível offline é a casca, não os dados
> A instalação cobre **apenas a casca do aplicativo**: a capacidade de instalação, o cache de recursos estáticos e um fallback offline para a própria casca. Os **dados** offline (ler e editar notas sem conexão, sincronizar, resolver conflitos) **não** entram nisso. Os dados ficam no servidor, e o service worker não os armazena em cache.

## Como instalar

A instalação fica em **Settings → About**. O que você vê depende do seu navegador e da sua plataforma:

- **Um botão "Install app"** — quando o navegador ofereceu a instalação e o aplicativo ainda não foi instalado.
- **Um status "Installed"** — quando o Notarium já está rodando em uma janela própria.
- **Instruções de Add to Home Screen** — no iOS, onde não há prompt do sistema e o aplicativo é adicionado manualmente pelo Safari.
- **Uma dica** — para navegadores que não têm suporte à instalação.

## O que funciona offline

A casca em si é entregue offline para qualquer requisição de navegação — os recursos estáticos (código, estilos, ícones, fontes) são pré-cacheados no momento do build. Mas as requisições de dados (`/api`) e ao gateway MCP (`/mcp`) **sempre vão para a rede**: sem conexão, elas retornam um erro de rede, e o aplicativo mostra seu próprio estado de erro em vez de trocar as notas por uma versão desatualizada do cache.

## Atualizações

Uma atualização nunca recarrega a página sozinha por baixo dos seus pés. Quando uma nova versão foi construída, o aplicativo mostra um toast fixo **"A new version is available"** com uma ação **"Reload"** — só ao clicar nele você passa para a nova versão. A mesma ação é espelhada por um botão **"Reload to update"** em Settings → About.

Para iniciar o Notarium do zero, veja o [Início rápido](/docs/getting-started/); para as fontes e temas que ficam em cache para a casca offline, veja [Leitura e aparência](/docs/guides/reading/).