> ## 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

# 오프라인 액세스

네트워크 없이도 화면을 유용하게 유지하는 워크스페이스 범위 읽기 캐시.

## 캐시가 저장하는 것

앱의 문서 디렉터리 아래 supastack-offline/의 JSON 파일은 최근 성공한 읽기를 저장하며, 사용자·워크스페이스·키의 해시로 이름이 지정됩니다 — 원시 식별자는 경로에 나타나지 않습니다. 항목은 7일 후 만료되고 각 256KB로 제한되며, 손상되거나 크기가 초과된 파일은 삭제되거나 거부됩니다. 모든 캐시 I/O는 best-effort이며 화면을 차단하지 않습니다.


## 네트워크 우선, 캐시는 대체

캐시된 읽기는 항상 네트워크를 먼저 시도하고 새 복사본을 저장합니다. 캐시는 연결 실패 — 도달할 수 없는 호스트나 status-0 클라이언트 오류 — 에서만 제공됩니다. 401이나 500 같은 HTTP 실패는 다시 throw됩니다. 거부된 리소스는 오래된 데이터를 제공하지 않고, 죽은 세션은 캐시된 응답으로 연장되지 않습니다.


## 캐시가 지워지는 시점

로그아웃은 모든 것을 지우고, 다른 계정으로 로그인해도 마찬가지입니다. 워크스페이스 전환은 캐시를 유지합니다 — 범위가 격리되어 있으므로 한 워크스페이스가 다른 워크스페이스의 행을 읽는 일은 없습니다.


## 사용자에게 보이는 것

캐시된 화면은 현지화된 배너 — "You're offline — showing data saved {ago}" — 를 표시하며 상대 시간과 함께 접근성 알림으로 알립니다. home, billing, notifications, content, commerce, chat 목록 화면이 캐시를 통해 읽습니다.


## 검증 및 문제 해결

각 캐시된 화면을 비행기 모드로 테스트하세요. 읽기는 살아남고, 쓰기는 깔끔하게 실패하고, 배너는 저장된 시점을 보고해야 합니다. 로그아웃하고 이전 계정의 흔적이 남지 않는지 확인하세요.


## 다음

[앱 잠금과 기기 보안](https://supastack.dev/ko/docs/mobile/security.md)