FoldRender / Guides / Read a whole GitHub repo on your phone
FoldRender guide

Read a whole GitHub repo on your phone

This is the loop FoldRender is actually finished for: clone a public repository anonymously, then read every file in it — Markdown, source, notebooks, PDFs — from one file tree. It has been run on a clean device. What follows is that procedure step by step, including the parts that are slow, and a straight account of where the git half stops.

Get it on Google Playfree See what FoldRender does

Step by step

  1. Install from Google Play

    FoldRender is on the Play Store as FoldRender: Git Repo Reader, package id dev.foldrender.app, free and distributed worldwide. Install it the ordinary way — no allow installs from this source prompt to approve, and updates arrive on their own. The app declares minSdk 30, so it needs Android 11 or newer; Play will tell you if a device is below that rather than letting you install a build that cannot run.

  2. Clone the repository

    Open the git panel with the branch glyph in the top bar. Paste an HTTPS URL into Clone an HTTPS repository URL — the placeholder shows the expected shape, https://github.com/you/repo.git — and tap Clone. For a public repository that is all of it: no account, no token, no sign-in. HTTPS only; SSH remotes are not supported.

  3. Wait for the first tree listing

    FoldRender opens the clone as the workspace and begins listing it. On a repository of roughly 4,600 files this takes a long time and shows only a spinner — no percentage, no file count, no estimate. It does complete. Small and medium repositories are quick; it is the large ones where the missing progress indicator is felt.

  4. Start at the README

    The Files tab is the tree, with a type badge on every row and .gitignore-aware hiding so vendored directories and build output stay out of the way. Tap README.md. Unfolded, the tree stays on the left and the document renders on the right; folded, the document takes the screen and the tree becomes a back step.

  5. Read the code

    Source files render with whole-file lexical highlighting and line numbers, under a header giving the detected language and the line count, with a Wrap chip for long lines. JSON, YAML, TOML and lockfiles open as a collapsible tree with a copyable path breadcrumb; CSV opens as a sortable table with a frozen header; logs get severity colouring; PDFs get a page counter and a tap-to-jump thumbnail strip; notebooks show their cells, execution counters and saved outputs.

  6. Find things across the whole repo

    The Search tab greps the entire workspace — literal or regex, results streaming in as path:line rows with a preview line, tap to open at that line. It respects .gitignore, skips binaries and anything over about 1.5 MB, and caps at 500 hits with the status line telling you it capped. On a phone this is the difference between reading a repository and scrolling one.

  7. Keep your place

    Scroll position is stored per document and restored when you reopen it. The Recent tab collects the files you have opened, and a long-press in the tree pins a file as a favourite — worth doing for the two or three files you keep returning to in an unfamiliar codebase.

  8. Check the repository's state

    Back in the git panel, each clone has a chip; the header shows the current branch, ahead and behind counts, and either “· clean” or “· N changed”. Underneath are Pull, Browse files, the local branch chips, and the recent commit list showing each commit's short id and author.

How FoldRender handles it

Everything in the repo, one reader

Markdown, source in around sixty languages, JSON/YAML/TOML, CSV/TSV, images including SVG, PDF, HTML, logs and Jupyter notebooks all open in the same pane from the same tree. Rendering has been verified on device for Markdown, source, PDF and notebooks.

Selection is by content, not filename

Each format is a stateless renderer scoring the file on name, MIME type and magic bytes together, and the highest score wins. An extensionless file that starts with %PDF or <svg still lands in the right renderer.

Built for the unfolded screen

Two panes — tree left, document right — appear when the window is wide enough or the device is genuinely half-open; folded it collapses to one column with the tree a back step away. The activity handles configuration changes itself rather than being recreated.

What does FoldRender not do?

The honest list — shipped-but-unverified behaviour included, so you can tell before installing whether this build does the thing you came for.

How does FoldRender compare with the other ways to read a repo on Android?

Four apps people actually reach for, and the one axis that separates them: whether the repository ends up on the phone, and whether anything renders it once it is there.

ToolDownload priceWhere you get itClones to the deviceRenders PDF / notebook / MarkdownEditor or shell
FoldRender 0.8.2US$0Google Play, worldwideYes — HTTPS, anonymous for public reposYes — native Compose renderersNo, deliberately: a reader, not an IDE
GitHub MobileUS$0Google Play and the App StoreNo — it reads repositories hosted on GitHubOnly what GitHub itself renders, onlineEdits files inside a pull request
Termux + gitUS$0F-Droid or GitHubYes — the real git CLINo — terminal text onlyYes, a full shell and any CLI editor
MGit 1.7.0 (2023)US$0F-Droid onlyYes — clone, pull, push, HTTPS or SSH keysNoNo — its own listing says it ships no text editor

Prices are for the download. GitHub Mobile’s capabilities follow your GitHub plan; Termux and MGit are both free software. MGit’s version and date are from its F-Droid listing.

What are the numbers behind FoldRender?

Every figure here is read out of the shipping build or off a primary source listed at the foot of this page — nothing is rounded up for effect.

FAQ

Can I browse and read a full GitHub repository on a phone?
Yes, and it is the path that has been verified on a clean device: clone a public HTTPS repository anonymously, then read every file from a two-pane tree and document view. Rendering was confirmed for Markdown, source code, PDFs and Jupyter notebooks.
Do I need a GitHub account?
Not for a public repository. Anonymous clone works with nothing entered. A private repository needs either a personal access token or GitHub's device-flow sign-in.
How long does cloning and listing a big repository take?
The clone itself is a normal git clone over HTTPS. The part that drags is the first tree listing — on a repository of roughly 4,600 files it takes a long time behind a spinner with no progress indicator. It finishes; there is just nothing to watch.
Is this a code editor?
No. There is no editor, no terminal, no build. FoldRender opens, renders, searches and exports the contents of a repository.
Can I read the repo on a plane?
Yes, once it is cloned. Every renderer works on the local file, and even the mermaid and KaTeX island runs entirely from assets bundled in the APK with network loads blocked. Only git operations that talk to the remote need a connection.
Where is the clone stored?
In app-private storage, in a repos directory under the app's files directory — git needs a real filesystem, which the storage-access framework does not provide. No storage permission is requested and no other app can read it.
How much does FoldRender cost?
US$0. It is free on Google Play, distributed worldwide, with no billing library in the build, no subscription and no paid tier. The current release is version 0.8.2.
Which Android versions does FoldRender run on?
Android 11 and newer. The app declares minSdk 30 — the API level Android 11 shipped with in 2020 — and is compiled and targeted against API 36. It is developed and tested on a Galaxy Z Fold 7, which launched in 2025.
Does FoldRender work offline?
Yes, once a repository is on the device. Cloning and pulling need the network; reading, searching, and rendering Markdown, source, PDFs and notebooks out of a clone or a picked folder do not. Signing in to GitHub is optional and only matters for private repositories.
How is this different from GitHub Mobile, Termux or MGit?
GitHub Mobile reads repositories hosted on GitHub and does not clone to the phone. Termux and MGit both clone and then leave rendering to you — Termux gives you a shell, MGit ships no text editor at all. FoldRender clones over HTTPS and renders what it clones, on the inner screen.

Where can I check these claims?

The primary documents behind the figures above, so you can confirm any of them without taking our word for it.

Page last reviewed 2026-08-27, against FoldRender 0.8.2.

More FoldRender guides