Read .gram files on iPhone and iPad · r0

Archived revision r0, recorded 2026-10-12T08:08:28.794Z. Current page: Read .gram files on iPhone and iPad.

Read, do not edit

Thegram for iOS is documented as a viewer for iPhone and iPad. It opens .gram documents from folders or files the person chooses, including iCloud Drive and other file providers. The app does not edit the source document. Treat this as an inspection surface: if a decision needs revision, use an authoring client such as the Mac app and verify the resulting file separately.

Bring a file into the library

Choose a folder or individual file through the system file-provider flow, open a .gram document from another app, or put a document in the app’s own Documents folder. The app declares a .gram document type and supports opening files in place. For a folder, iOS security-scoped access is retained so the app can revisit the chosen location. The app coordinates file reads and keeps a cache mirror for multi-document recall and semantic indexing; that mirror is not the canonical file. If iCloud has not downloaded a file, the app requests it and reads it on a later refresh.

A practical import sequence is: select the folder or file you intend to read; wait for provider download if needed; refresh the library; open the document; compare its visible title and content with the expected file. For an app-local transfer, Finder file sharing or the Files app can place .gram files in Thegram’s Documents folder. Opening a .gram from another app adds the single-file source to the library rather than importing it into a mutable iOS editor.

Use history, graph and search

The iOS README describes document, dashboard, graph, inspector, timeline and search experiences. Selecting a revision changes the views together. Historical display is for review; it is not a write operation. Search can use literal keywords and a local semantic index. The README describes an embedded quantized EmbeddingGemma model and background indexing conditions; semantic results are derived aids, not explicit stored relations or proof that a sentence is true. The cached snapshot and semantic index are app data, not alternate versions of the user’s .gram source.

Optional Google Drive reading

Google Drive is not automatically available simply because the app is installed. The README describes signing in to a Thegram account first, adding a Google account through the server’s /drive page, and then seeing .gram files from the Drive Thegram folder as a read-only downloaded copy. The app keeps tokens in Keychain and removes fetched copies when signing out. This route has more identity and network dependencies than opening a local provider file. If you do not need that route, use a file or folder you already control instead.

Example

A teammate sends review.gram. Open it from Files or the mail attachment, check that the document and expected records appear, and use history to inspect how the decision developed. If you need to propose a correction, do not assume an edit control exists or alter the read-only copy outside its owning provider workflow. Ask the document owner for an authoring path, then reopen the resulting canonical file to confirm the change.

Security and boundaries

The app reads chosen files through system-granted access; a security-scoped bookmark does not mean the app can browse every file on the device. Caches and search indexes are local derived data. Account-backed Drive reads transmit requests and involve Vault plus Google authorization; they are different from local import. The privacy manifest lists account-related data categories such as email, name, and user ID for app functionality, with tracking declared false. Do not translate that manifest into an unsupported claim that no personal data is processed, nor into a claim that all document content is uploaded. The README specifically describes Drive documents as fetched read-only copies; local and account flows have distinct paths.

For exact current behavior, read the iOS README, project configuration, library implementation and privacy manifest. The iOS beta or distribution state should be confirmed from the official product page at the time of use. This guide does not assert App Store availability or promise editing, synchronization, or full parity with Mac.

Sources

Based on the checked iOS README, app configuration, library source and privacy manifest, with public product guidance for cross-device context.

Source

Source: iOS viewer README

Reference: https://github.com/clab-one/thegram-ios/blob/main/README.md

Source: iOS document and platform configuration

Reference: https://github.com/clab-one/thegram-ios/blob/main/project.yml

Source: iOS library access implementation

Reference: https://github.com/clab-one/thegram-ios/blob/main/App/Sources/Library/Library.swift

Source: iOS privacy manifest

Reference: https://github.com/clab-one/thegram-ios/blob/main/App/Resources/PrivacyInfo.xcprivacy

Source: Public iPhone and iPad product information

Reference: https://thegram.one/

Knowledge

Knowledge: iOS is a read-only document viewer

The app can inspect chosen .gram files and history but does not author changes to the source document.

Reference: → Supports: iOS reads chosen files and folders

Knowledge: iOS reads chosen files and folders

File-provider access, app Documents, and optional read-only Drive copies are distinct sources with different access boundaries.

Risk

Risk: Local import and Drive account flow have different data paths

Do not generalize the local-file path into a claim about account-backed authorization or downloaded copies.

Reference: → Supports: iOS is a read-only document viewer

Source and renderer evidence

Canonical source SHA-256: ad47ac70a37373b7428ba2de8392f7162b7b84a312960abff76c86cb5473ef7f
Selected revision: r0 · sha256:2a75393dc2b6de65e1dab2567864c163c1fefa4f25d535dd9ec3c902c459ac9d
Local renderer: configured local Thegram renderer · API thegram-web-render/1
Core source: git+https://github.com/clab-one/thegram-format.git?rev=b16489e1d0d77d38f82d2f61776524737aa31557#b16489e1d0d77d38f82d2f61776524737aa31557

Canonical source: 0.gram