3,000+ READMEs generated. Average quality score: 81/100.

Your code deserves documentation that actually matches it.

Paste a GitHub URL. Get a production-quality README in 30 seconds. ReadMeForge reads your actual code — not a template.

Free for public repos. No account required. Pro plan $9/month.

Trusted by developers at

GitHubVercelSupabaseLinearRaycastExpo

You shipped the code.
The README is still "coming soon."

Every developer has 3-5 GitHub repos with embarrassing documentation. A blank README or a template that still says [Project Name] at the top.

It's not laziness. Writing documentation requires stepping outside your own head and explaining your project to someone who has never seen it. That's hard. By the time you want to do it, the context has evaporated.

README generators exist, but they're all forms with different clothes. You still write every word. You still have to look up which shields.io badge works for your project.

ReadMeForge is different. It reads your code.

README.md — Before

# My Awesome Project

 

TODO: Add description

 

## Installation npm install

Score: 84/100
README.md — After ReadMeForge

# My Awesome Project

[![Build](badge)] [![License: MIT](badge)] [![npm](badge)]

Generates X from Y with Z.

## Installation

```bash pnpm install my-pkg ```

## Configuration

| Variable | Required |

Three steps. Thirty seconds. One README you can actually ship.

01
01

Paste your GitHub URL

Public repo? No login required. Private repo? Connect your GitHub account in one click.

02
02

We analyze your actual code

Reads package.json, scans source files, extracts API routes, identifies environment variables, maps dependency stack. Not guessing — reading.

03
03

Get a README worth shipping

Accurate installation instructions, real code examples, configuration reference, stack-matched badges, and a quality score that tells you exactly where it could be stronger.

Not a template. Documentation that reflects your project.

Every section is generated from actual code analysis, not filled-in blanks.

Accurate Installation Instructions

Detect your package manager from your lockfile. pnpm repos get pnpm commands. Dockerfile present? Docker instructions included. No more npm/yarn mismatches.

Real Environment Variable Reference

Scans .env.example and source files for every process.env call. Complete configuration table with variable names, descriptions, and required/optional status.

API Route Documentation

Express, Next.js, FastAPI, Django, Flask, Gin — enumerate your actual routes and generate a reference table with method, path, and inferred description.

Stack-Matched Badges

Detect your CI system, package registry, test framework, and deployment target. Badges that work for your specific project with valid shields.io URLs.

Usage Examples from Your Code

Pull real code patterns from your source files to illustrate how the project is used. Not invented examples — yours.

Quality Score with Actionable Feedback

Every README gets a score from 0 to 100 across completeness, accuracy, clarity, visual structure, and currency. Low section? Specific fix suggestions.

The only README generator that tells you how good your docs actually are.

Most README tools give you output and wish you luck. ReadMeForge runs your generated README through a five-part quality analysis the moment it's generated.

30

Completeness

All essential sections present and substantive

30

Accuracy

Claims match actual codebase — package names, commands, env vars

20

Clarity

First sentence passes the 'what does this do' test

10

Visual Structure

Badges valid, TOC present for long docs, heading hierarchy

10

Currency

Dynamic version badges, CI status, maintenance signals

Example Quality Score

example/repo

84B
Completeness27/30
Accuracy26/30
Clarity16/20
Visual Structure8/10
Currency7/10

Private repos. Auto-updating docs. Team consistency. $9/month.

The free tier is genuinely useful. The paid tier is where ReadMeForge becomes part of your workflow.

Private Repository Support

Connect your GitHub account and generate READMEs for private repos. Read-only access. No code stored.

Auto-Regeneration on Push

Register a webhook and get a pull request with an updated README every time you push to main. Documentation that evolves with your code.

Changelog Generation

Generate a CHANGELOG.md from your commit history and merged PRs. 90 days of activity, Keep a Changelog format.

Team Style Guides

Define required sections, section order, tone, preferred badges, and custom sections. Every repo follows the same standard.

Custom Sections with Auto-Preserve

Add content ReadMeForge doesn't generate. Mark it as custom and it survives every auto-regeneration.

Unlimited Generations

No daily caps. Generate READMEs for all your repos. Re-generate after major feature launches. Use it in your pipeline.

Not all README tools are the same.

FeatureReadMeForgereadme.soChatGPTCopilot
Reads actual source codeYesNoNoPartial
Accurate install commandsYesNoNoNo
Environment variable extractionYesNoNoNo
API route documentationYesNoNoNo
Quality scoringYesNoNoNo
Private repo supportProNoN/AYes
Auto-regeneration on pushProNoNoNo
Changelog generationProNoNoNo
Team style guidesProNoNoNo
PriceFree / $9/moFree$20/mo$10/mo

"I've been shipping side projects for 8 years. The README is always the last thing I do and it always shows. ReadMeForge generated a README for my CLI tool that was more accurate than what I would have written myself. It found the env vars I forgot to document."

Marcus Chen

Indie hacker, author of 12 npm packages

"We have 40 internal repos. Every one has a different README format, different levels of quality, some are completely empty. We set up a team style guide and ran it against everything in a weekend. Onboarding new engineers went from 2.5 days to less than 1."

Priya Sharma

Tech Lead at a Series A fintech startup

"The quality score is what sold me. I thought my READMEs were fine. They scored 52/100 on average. The accuracy section was failing because I'd hardcoded outdated package names. Fixed them all in an afternoon."

Daniel Novak

Open source maintainer, 3 projects with 1k+ stars

"The auto-regeneration webhook is exactly what I needed. My project's API changes constantly during early development. Before, my README was wrong within a week. Now it just stays accurate."

Aisha Williams

Developer at a developer tools startup

Start free. Upgrade when it's clearly worth it.

Free

$0/month
  • 3 README generations per day
  • Public repositories only
  • Full quality scoring
  • Badge suggestions
  • Install instructions and API docs
  • Copy and download README.md
Start for Free — No Account Required
Most Popular

Pro

$9/month
  • Everything in Free
  • Unlimited generations
  • Private repository support
  • Auto-regeneration on push (webhook)
  • Pull request creation with changes
  • Changelog generation from commit history
  • Team style guides
  • Custom sections with auto-preserve
  • Priority generation queue
Start 14-Day Free Trial

No credit card required

Frequently asked questions

Does the free tier require an account?
No. Generate READMEs for public repos without signing up. Usage is tracked by IP and browser fingerprint. Create an account to save your generation history.
What happens to my code after generation?
Nothing. We read it to generate the README and don't store it. The generated README is cached for 24 hours keyed to the specific commit SHA. We never use your code or READMEs to train AI models.
Does this work for non-JavaScript projects?
Yes. Python (pip/poetry/pipenv), Go (go modules), Rust (Cargo), Java (Maven/Gradle), and Ruby (Bundler) are all supported. API route extraction covers Express, Next.js, FastAPI, Django, Flask, and Gin.
Can I cancel anytime?
Yes. Cancel from your dashboard and you keep Pro access until the end of the billing period. No cancellation fees, no retention calls.
What if I'm not happy with the generated README?
The quality score tells you exactly what needs work. You can edit directly in our side-by-side editor, regenerate individual sections, or regenerate after pushing a commit that improves your repo description or .env.example.
What's the generation time limit?
Free tier generations complete within 30 seconds for standard-sized repos. Pro tier has priority queue access. Repos over 1GB are not currently supported.

Your next project ships with documentation.

Pick any repo you've been meaning to write a README for. Paste the URL. Thirty seconds from now, you'll have a README that makes the project look like it deserves the stars it doesn't have yet.

Or start the 14-day Pro trial and bring your private repos.