Skip to content

pushme-pullyou/tootoo

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

120 Commits
.archive
.archive
 
 
.claude
.claude
 
 
.github/prompts
.github/prompts
 
 
chat-gpt
chat-gpt
 
 
gemini
gemini
 
 
sample-folders-and-files
sample-folders-and-files
 
 
test-cases
test-cases
 
 
.gitignore
.gitignore
 
 
0-tootoo-agenda.md
0-tootoo-agenda.md
 
 
0-tootoo-journal.md
0-tootoo-journal.md
 
 
0-tootoo-tips.md
0-tootoo-tips.md
 
 
0-tootoo-why.md
0-tootoo-why.md
 
 
AGENTS.md
AGENTS.md
 
 
CLAUDE.md
CLAUDE.md
 
 
FORKING.md
FORKING.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
banner.png
banner.png
 
 
copy-index-to-folder.sh
copy-index-to-folder.sh
 
 
index.html
index.html
 
 
tootoo-recreate.prompt.md
tootoo-recreate.prompt.md
 
 
tootoo-screenshot.jpeg
tootoo-screenshot.jpeg
 
 
tootoo-test-load.html
tootoo-test-load.html
 
 
tootoo-test.html
tootoo-test.html
 
 
tootoo.config.js
tootoo.config.js
 
 

Repository files navigation

TooToo

Live Demo License Single File

Navigate any GitHub repo in your browser. Zero install. Single HTML file.

TooToo screenshot

Try it

Try What it demos
octocat/hello-world Tiny repo — see the basic UI in two seconds
facebook/react @ React README Big repo, deep-linked to a specific file
openai/openai-cookbook Markdown-heavy repo with notebooks
torvalds/linux @ master Stress test — token recommended for big trees
More demos

Why TooToo?

  • Instant cross-tree filter. Type a few letters, see every matching path. GitHub's web UI only filters the current folder.
  • Sticky sidebar, sticky breadcrumbs. Scroll a long file without losing context.
  • Built for phones too. A−/A+ buttons resize everything; the sidebar collapses to a sensible width on narrow screens; dark mode is one tap.
  • Works next to a local checkout. Drop index.html next to a cloned repo and TooToo reads it from disk via file:// — no API quota burn, no internet required.
  • Drag-and-drop friendly. One file. Copy it into any repo, push, enable Pages, done.

Features

  • Single file — one index.html with HTML, CSS, and JS inline
  • Auto-detect — reads .git/config, parses GitHub Pages URLs, or caches to localStorage
  • File tree — sidebar with collapsible folders, filter input, keyboard navigation
  • Content viewer — Markdown (rendered via marked), syntax-highlighted code, images, audio, video, PDF, spreadsheets (SheetJS)
  • Dark mode — toggle with persisted preference
  • Resizable sidebar — drag to resize, width saved across visits
  • Font size controls — A−/A+ buttons, helpful on phones
  • GitHub token support — optional PAT for private repos and higher rate limits (5,000/hr vs 60/hr)
  • File text cache — LRU in-memory + sessionStorage cache to reduce API calls without persisting file contents after the tab session
  • Hash routing — deep-link to any file via #path/to/file
  • Copy / New Tab — copy raw file content or open the GitHub Pages URL
  • Rendered ↔ Raw toggle — for Markdown, HTML, and SVG files; preference saved per file type
  • Safer HTML previews — rendered HTML uses a strict iframe sandbox so repository scripts do not run by default

Quick Start

On GitHub Pages — visit the live URL above.

Drop-in mode — copy index.html into any GitHub repo folder. Open it in a browser. It walks up the directory tree looking for .git/config to find the owner and repo.

Pre-configured — edit the CONFIG object at the top of the script:

const CONFIG = {
  owner: 'pushme-pullyou',
  repo: 'tootoo',
  branch: 'main',
  storagePrefix: 'tootoo',
  appName: 'TooToo',
  sourceRepoUrl: 'https://github.com/pushme-pullyou/tootoo',
};

Fork & Customize

Want your own TooToo pointing at your own repo? It takes about a minute.

  1. Fork this repository on GitHub (top-right of the repo page).

  2. Edit CONFIG at the top of the <script> block in index.html:

    const CONFIG = {
  owner: '',                  // optional: pre-load a specific repo
  repo: '',
  branch: '',                 // empty = use the default branch
  storagePrefix: 'mybrowser', // localStorage namespace
  appName: 'MyBrowser',       // <title> + About heading
  sourceRepoUrl: 'https://github.com/you/your-fork', // file:// fallback for the header
};

    On GitHub Pages, the top-header label and link auto-detect from the hostname (<you>.github.io/<fork>/), so you don't even need to set sourceRepoUrl for the Pages deploy. It's only used as a fallback for file:// and custom domains.

  3. Customize the favicon (optional) — the inline SVG <link rel="icon" ...> in <head>.

  4. Enable Pages: in your fork's Settings → Pages, deploy from the main branch root. Your fork goes live at https://<you>.github.io/<your-fork>/.

For deeper customization (adding renderers, new buttons, etc.), see FORKING.md — covers the architecture, render pipelines, and the gotchas (file://, rate limits, blob lifecycle).

Browser storage keys

TooToo stores preferences and the GitHub token in the browser's localStorage. Recently viewed file contents are cached in sessionStorage, so they expire when the tab session ends. Keys are scoped per location.pathname, so two TooToo instances on the same origin keep separate state.

Key Purpose
tootoo:<pathname>:repo Detected owner / repo / default branch
tootoo:<pathname>:darkMode Dark mode on/off
tootoo:<pathname>:fontSize Font size override (px)
tootoo:<pathname>:sidebarWidth Last sidebar width (px)
tootoo:<pathname>:fileTextCache Session-only LRU cache of recently viewed file contents
tootoo:<pathname>:viewPref:<ext> Rendered / Raw toggle per file extension
tootoo:<pathname>:currentFile:<owner>/<repo>/<branch> Last-opened file in that repo
tootoo:<pathname>:githubToken GitHub Personal Access Token for this TooToo instance

To wipe state, click ⚙️ Token → Reset all TooToo data, or clear both localStorage and sessionStorage in DevTools.

Constraints

  • Vanilla JavaScript — no frameworks, no build tools, no Node.js
  • ES2020+ — const/let, arrow functions, template literals, async/await
  • Static hosting only — GitHub Pages or open from file://
  • External CDN deps: marked, highlight.js, DOMPurify, SheetJS

Roadmap

TooToo stays intentionally small: single-file, vanilla JavaScript, static hosting, and file:// friendly. These ideas are candidates, not promises.

Next

  • Add better text search: search within the current file first, then loaded/cached text files, with optional rate-limit-aware search across small repo text files.
  • Improve New Tab choices: keep page-like files on GitHub Pages when useful, and open data/media/extensionless files as raw content.
  • Add richer previews for common data files, starting with friendlier .csv and .json views.
  • Add visible local-mode/rate-limit status so users know whether TooToo is reading local files, raw GitHub files, or the GitHub API.
  • Expand keyboard help, including / for filter, F for file tree focus, arrows for navigation, and Rendered/Raw toggles.

Later

  • Improve Markdown navigation: README anchors, relative links with query/hash, and GitHub folder links.
  • Add search results with matching file paths, line snippets, next/previous navigation, and clear filename-vs-content search modes.
  • Add share/copy actions for deep links, raw URLs, and GitHub URLs.
  • Polish mobile behavior with an easier sidebar toggle and simpler header layout.
  • Expand test-cases/ for CSV, extensionless files, Markdown links, text search, and New Tab routing.

Maybe

  • Lightweight image/file metadata panels.
  • Optional JSON tree viewer.
  • More fork-customization helpers for app name, favicon, storage prefix, and source repo URL.

Project Structure

index.html                    ← canonical single-file app
README.md                     ← user-facing docs (this file)
FORKING.md                    ← architecture + recipes for forkers
AGENTS.md                     ← AI agent guidance
CLAUDE.md                     ← Claude-specific pointer file
0-tootoo-agenda.md            ← priorities and ideas
0-tootoo-journal.md           ← development notes
tootoo-test.html              ← standalone test harness for pure helpers
tootoo-test-load.html         ← manual GitHub raw-file load tester for this repo
test-cases/                   ← file rendering fixtures (with index README)
sample-folders-and-files/     ← sample local tree content
.archive/                     ← older snapshots
.github/prompts/              ← generation/merge/rebuild prompts
gemini/                       ← alternate-model experiments

License

MIT — Copyright pushme-pullyou. See LICENSE.

Change Log

  • 2026-05-18 — Restored repo-local agent guidance as AGENTS.md with CLAUDE.md as a small pointer file, so TooToo-specific workflow rules are active again
  • 2026-05-18 — File-content cache now uses sessionStorage instead of localStorage; legacy persistent file-cache entries are cleared on restore/reset
  • 2026-05-18 — Markdown link rewriting now keeps custom schemes intact, avoids treating query strings/fragments as filenames, and handles GitHub blob links on branches containing /
  • 2026-05-18 — New Tab now opens data/media files such as .csv and extensionless files through raw URLs instead of GitHub Pages, and opens the tab synchronously to avoid popup blockers
  • 2026-04-25 — Top-header label and GitHub icon now derive from APP_ORIGIN (where this app instance is hosted), independent of the currently browsed repo; on file:// it reads the surrounding .git/config
  • 2026-04-25 — Token panel auto-opens on rate-limit (403) with explanation of why a token is needed and where to get one
  • 2026-04-25 — Pinned CDN versions (marked@12.0.2, dompurify@3.4.1, xlsx@0.20.3) to insulate against upstream breakage
  • 2026-04-25 — README auto-select now matches more variants (README, README.markdown, README.mkd, README.mdown, README.txt); falls back to the About page if no root README exists
  • 2026-04-25 — probeLocalMode now respects the abort signal so probes stop when the user navigates away mid-load
  • 2026-04-25 — Filter and visible-tree-item logic now use an .is-hidden class instead of inline-style sniffing
  • 2026-04-25 — View-toggle buttons (Rendered/Raw) drive their styling from aria-pressed instead of inline style="opacity:..."
  • 2026-04-25 — Removed duplicate / keyboard handler; merged the two beforeunload listeners
  • 2026-04-25 — Active tree-item scroll uses behavior: 'auto' so rapid keyboard navigation no longer fights smooth-scroll
  • 2026-04-25 — renderCode now always builds via textContent, skipping the escape pass for very large files
  • 2026-04-25 — Configured defaults now act as a fallback after repo auto-detection instead of short-circuiting URL, cache, Pages, and .git/config detection
  • 2026-04-25 — 403 responses in repo-info and authenticated file fetches now surface the same rate-limit warning used by tree loading
  • 2026-04-25 — Repo breadcrumb now resets to a true home state instead of leaving the previously opened file view onscreen
  • 2026-04-25 — Last-opened file persistence is now scoped per owner/repo/branch and ignores stale paths not present in the current tree
  • 2026-04-25 — Markdown now resolves relative image paths against the current file location in the repository browser
  • 2026-04-25 — Renamed: the app is now simply "TooToo" (the previous "LT" suffix is dropped); older/full TooToo files moved to their own repository
  • 2026-04-25 — HTML rendered previews now use a strict sandbox so repository scripts do not run by default
  • 2026-04-09 — Help button with live rate limit, tips section
  • 2026-04-09 — GitHub Pages URL auto-detection, file:// XHR detection
  • 2026-04-07 — Style adjustments, About button
  • 2026-04-06 — New tab: use raw URL when not on Pages

About

Browse any GitHub repo in your browser. Zero install. One HTML file.

pushme-pullyou.github.io/tootoo/

Topics

github-api vanilla-javascript static-site markdown-viewer github-pages-website no-build repository-browser single-file-app

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 1

V 2026-04-22 Latest
Apr 23, 2026

Contributors

Languages