# ReadmeUp

> Surfaces README files at the top of repository pages

Canonical page: [https://chrome-stats.com/d/readmeup](https://chrome-stats.com/d/readmeup)

## Overview

- **ID:** `readmeup`
- **Platform:** Firefox
- **Type:** Firefox add-on
- **Status:** Available
- **Publisher:** Esgalha
- **Category:** web-development,appearance
- **Version:** 1.1.0
- **Last updated:** 2026-06-06
- **First published:** 2026-05-30
- **Size:** 34 KB
- **Data as of:** 2026-09-06
- **Store listing:** [Firefox Add-ons Store](https://addons.mozilla.org/firefox/addon/readmeup/)
- **Website:** [https://github.com/Esgalha/readmeup](https://github.com/Esgalha/readmeup)
- **Privacy policy:** [https://addons.mozilla.org/firefox/addon/readmeup/privacy/](https://addons.mozilla.org/firefox/addon/readmeup/privacy/)

## Description

A browser extension that moves the README to the top of repository pages on GitHub, GitLab, and Bitbucket, above the branch picker and file browser. 

When you land on a repository page, ReadmeUp physically reorders the existing DOM elements so the README (and Contributing/License sections) appears first, above the branch chooser and file listing. No new elements are injected and no extra network requests are made. The original page order is restored when you navigate away and re-applied on each SPA navigation.

Features:
- Works with markdown READMEs and plain-text READMEs
- Collapse/expand toggle to hide the README when you need it out of the way, with the state remembered per repo across browser sessions
-Per-repo toggle in the popup to permanently disable ReadmeUp on any individual repository

## Rankings

- #131,929 — Overall

## Permissions and access

### Permissions

- `storage`
- `https://github.com/*`
- `https://api.github.com/*`
- `https://gitlab.com/*`
- `https://api.gitlab.com/*`
- `https://bitbucket.org/*`
- `https://api.bitbucket.org/*`

### Content script matches

- `github.com`
- `gitlab.com`
- `bitbucket.org`

## Safety

- **Risk impact:** High risk impact
- **Risk likelihood:** High risk likelihood

### Analysis details

- Request access to the following domains: github.com, gitlab.com, bitbucket.org
- This extension has low user count. Unpopular extensions may not be stable or safe.

> Some risk analysis details are omitted from this free response. [Upgrade to view the full analysis](https://chrome-stats.com/pricing).

## Similar extensions and apps

- [GitHub Readme First](https://chrome-stats.com/d/github-readme-first) — 8 users
- [Synapse Web Clipper](https://chrome-stats.com/d/synapse-web-clipper)
- [Markdown Reader](https://chrome-stats.com/d/markdown-reader-ext) — 6,109 users, 5.00 / 5
- [Reddit Nav Sidebar Collapser](https://chrome-stats.com/d/reddit-nav-sidebar-collapser) — 1 users
- [Markdown Viewer](https://chrome-stats.com/d/empiric-markdown-viewer) — 48 users
- [Ream - Reader Mode](https://chrome-stats.com/d/ream) — 1,129 users, 4.80 / 5
- [FastRead Tweaked](https://chrome-stats.com/d/fastread-tweaked) — 4 users, 5.00 / 5
- [Markdown Viewer & Reader](https://chrome-stats.com/d/markdown-viewer-reader) — 55 users, 4.50 / 5
- [Readability Toggle](https://chrome-stats.com/d/readability-toggle) — 3 users
- [GitHub Diff Explorer](https://chrome-stats.com/d/github-diff-explorer) — 2 users, 5.00 / 5
- [Markdown Viewer Pro](https://chrome-stats.com/d/markdown-viewer-pro) — 10 users, 5.00 / 5
- [Markdown Reader Pro](https://chrome-stats.com/d/markdown-reader-pro) — 1 users

---

Source: [Chrome-Stats](https://chrome-stats.com/d/readmeup)