> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Acesso offline

Uma cache de leitura por workspace que mantém os ecrãs úteis sem rede.

## O que a cache guarda

Debaixo da diretoria de documentos da app, ficheiros JSON em supastack-offline/ guardam leituras recentes bem-sucedidas, nomeados por um hash do utilizador, do workspace e da chave — identificadores crus nunca aparecem nos caminhos. As entradas expiram ao fim de sete dias, limitam-se a 256 KB cada, e ficheiros corrompidos ou grandes demais são apagados ou recusados. Todo o I/O de cache é best-effort e nunca bloqueia um ecrã.


## Rede primeiro, cache como recurso

As leituras em cache tentam sempre a rede e persistem uma cópia fresca. A cache só serve em falhas de conectividade — um host inalcançável ou um erro de cliente com status 0. Falhas HTTP como 401 ou 500 voltam a lançar: recursos negados nunca servem dados velhos, e uma sessão morta nunca é prolongada por uma resposta em cache.


## Quando a cache é limpa

O sign-out limpa tudo, e iniciar sessão com outra conta também. Mudar de workspace mantém a cache — os âmbitos são isolados, por isso um workspace nunca lê as linhas de outro.


## O que o utilizador vê

Os ecrãs em cache mostram um banner localizado — You're offline, showing data saved some time ago — anunciado como um alerta de acessibilidade com tempos relativos. Os ecrãs de home, faturação, notificações, conteúdo, comércio e lista de chat leem através da cache.


## Verificação e resolução de problemas

Testa cada ecrã em cache em modo avião: as leituras sobrevivem, as escritas falham limpo e o banner reporta a idade dos dados guardados. Sai e confirma que não fica nada da conta anterior.


## Seguinte

[Bloqueio da app e segurança do dispositivo](https://supastack.dev/pt/docs/mobile/security.md)
