Track Awesome Readme Updates Weekly

A curated list of awesome READMEs

🏠 Home · 🔍 Search · 🔥 Feed · 📮 Subscribe · ❤️ Sponsor · 😺 matiassingers/awesome-readme · ⭐ 20K · 🏷️ Miscellaneous

[ Daily / Weekly / Overview ]

Dec 01 - Dec 07, 2025

Examples

• hmpl-language/hmpl (⭐837) - Project logo, informative badges, clear description, step-by-step installation. Usage code samples. Useful Features.

Tools

• GitHub PR Stats (⭐8) - Dynamic SVG tables displaying your GitHub pull requests with dual modes: detailed PR list and repository aggregate statistics. Features status filtering, star-based sorting, and customizable fields.

Nov 17 - Nov 23, 2025

Examples

• dsplce-co/supabase-plus (⭐58) - Well-thought-out structure. Quick summary of features in the intro. ToC. Each command's use case is explained in a relatable, entertaining language. Each command-specific section has a satisfying GIF demonstrating the feature to go with the description.

Sep 22 - Sep 28, 2025

Tools

• GPRM (⭐888) - A tool to generate a customized GitHub Profile README with a modern UI.

• README Typing SVG (⭐7.9k) - Dynamically generated, customizable SVG that gives the appearance of typing and deleting text. Perfect for profile READMEs.

Aug 04 - Aug 10, 2025

Examples

• shriyanyamali/JurisMercatus (⭐2) - Project logo with badges and how to use GIF. Project purpose and development process. Simple but detailed installation instructions. License and attribution sections.

Jun 30 - Jul 06, 2025

Tools

• Github Licenses Stats (⭐10) - This tool generates a dynamic SVG that shows the top licenses used across your GitHub repositories.

May 05 - May 11, 2025

Tools

• Telegram Card (⭐11) - Dynamic preview card generator for Telegram channels, groups, and bots. Features responsive design, dark/light theme support, and displays subscriber/member/monthly users/online users counts. Perfect for GitHub profiles and portfolios.

Apr 28 - May 04, 2025

Examples

• voltagent/voltagent (⭐4k) - Clean project logo. Useful badges and links (website, docs, demo). Screenshot. Clear code examples amongst the feature list. Quickstart example.

Apr 21 - Apr 27, 2025

Examples

• Grigorij-Dudnik/Clean-Coder-AI (⭐558) - Crazy project trailer video. Beautiful logo, explanatory motion gifs. Nice badges, and schema describing the framework's principle of work. List of stargazers. Clear description of what project does.

Apr 14 - Apr 20, 2025

Examples

• yvann-ba/ft_transcendence (⭐10) - Minimalist Project banner, clear GIF gallery in table layout. Colorful architecture diagram. Clear tech stack description. Team section with contributor avatars.

Mar 24 - Mar 30, 2025

Examples

• EduardaSRBastos/my-essential-toolbox (⭐2) - Project screenshot and informative badges. Clear project description. TOC for easy navigation. Well-structured sections detailing included tools by category. Performance score with screenshots. Contribution guidelines and license information.

Jan 20 - Jan 26, 2025

Examples

• mkosir/react-parallax-tilt (⭐1k) - GIF demo. Multiple badges. Feature list. Great live demo with code examples. Easy to follow instructions for local development set up.

• sultan99/react-on-lambda (⭐264) - Project logo, comics to present the main idea, badges, examples with code snippets, demo projects, api documentations, editor configurations.

Jan 06 - Jan 12, 2025

Examples

• brenocq/implot3d (⭐1.1k) - Project banner with GIFs. Link to online demo. Multiple CI badges. Dynamic roadmap with auto-updating SVGs that reflect feature discussions in real-time, powered by GitHub Actions. Displays the 5 most recent discussions with clickable images for quick access. Clean, well-structured layout with intuitive navigation and star history.

Tools

• Readme Forge - A component-based README generator to create stunning READMEs with ease. Features an extensive and versatile README templates library.

Nov 18 - Nov 24, 2024

Examples

• php-censor/php-censor (⭐691) - Multiple badges, project logo, feature list, video demo, step-by-step installation and upgrading instructions, TOC for easy navigation.

• PlexRipper/PlexRipper (⭐561) - Multiple badges, project logo, feature list, explanation, demonstration video, TOC for easy navigation.

Sep 02 - Sep 08, 2024

Presentations

• "Build a Better README" - Jason A. Crome at The Perl and Raku Conference in 2024 in Las Vegas, Nevada, USA.

Aug 26 - Sep 01, 2024

Examples

• dutrevis/spark-resources-metrics-plugin (⭐1) - Highlights an interactive Mermaid diagram in the Developer section, showcasing the code architecture. Has a patch-inspired logo, useful badges (CI, coverage, version links), and a concise ToC. Installation section is well-organized with expandable blocks for different scenarios. Usage section covers current functionalities and examples, also with expandable blocks. Includes technology badges, and also prior art and next steps sections.

Jul 01 - Jul 07, 2024

Examples

• aregtech/areg-sdk (⭐303) - Logo. Multiple info and statistics badges. List of contributors and stargazers with pictures. TOC and "Back to top" links for easy navigation. Headlines with graphics. Topic hide/show menu. Project description and philosophy. Clone and integration instructions. Quick build with multiple tools. Tools configuration instructions. Reference to examples and Demo projects. Reference to use cases. References to guidance and Wiki pages. Links with badges to contact. Links with badges to share the project on social networks.

• Armync/Arminc-AutoExec (⭐343) - Rich Markdown functions, modern layout, clear description, and compliance with the recommended community standards.

• eylon-44/Buzz-OS (⭐17) - Project logo. Colorful emojis. GIFs for project demo, examples, and instructions. Fast and simple copy-paste instructions for installation and usage. Pretty table of contents. A quick overview of project's main features.

• GTruf/Driver-Drowsiness-Detector (⭐6) - Beautiful project logo. Concise and clear project description. Exhaustive TOC. Feature list. Project screenshots and video snippets. Comprehensive informative sections. Useful links. Clear instructions for setting up and building the project. Presence of prepared releases.

• Stack-in-a-box/triumphmayflowerclub.com (⭐12) - Stands-out because, while only a simple website, it is presented as a very open project for lesser-experienced developers to cut their teeth on, with a friendly, inclusive tone and accessible setup instructions. Includes many common elements found in other beautiful READMEs.

• stevenfoncken/multitool-for-spotify-php (⭐5) - Concise introductory description. Clear overview of features. Why-section with easter egg (heading). Informative badges. Clear disclaimer. Step-by-step setup instructions. Expandable TOC. Headlines with emojis. Detailed usage section. Shortlinks at the top. Back-to-top link in the footer. Credits to third-party code/libraries.

• supunlakmal/thismypc (⭐178) - Project logo. Useful badges. Website URL. Screenshot. GIF step-by-step instructions for installation. Project folder structure.

• teles/array-mixer (⭐41) - Clean project logo, badges. Table of contents. Contribution section. Many illustrated examples.

• thelounge/thelounge (⭐6.1k) - Project logo. Useful badges and links (website, docs, demo). Screenshot. Feature list. Step-by-step instructions for installation, development, and testing. Link to the contribution guide. Good mobile summary.

• themerdev/themer (⭐5.7k) - Project logo. Visual description (flowchart) of what the project does. Build badges. TOC. Demo screenshot. Concise installation and usage sections, including common workflows. Colorful previews.

• vhesener/Closures (⭐1.8k) - Project logo, cognitive funnel, animated examples. Color-coordinated. Clean documentation.

• zenml-io/zenml (⭐5k) - Clean project logo. Useful TOC. Clear code examples amongst the feature list. Quickstart example.

Creating GIFs

• Gifski (⭐8.2k) - FREE - More vivid colors than the rest, but still keeps size low.

• Giphy Capture - FREE - Easy to upload to giphy.com, with a slightly annoying UX.

• LICEcap - FREE - Less intuitive, but with more features.

• ScreenToGif (⭐26k) - FREE - Open source, with a customizable UI and easily editable GIFs, easy to get started.

• terminalizer (⭐16k) - FREE - Record your terminal and generate animated GIF images or share a web player.

• ttystudio (⭐3.3k) - FREE - For command-line tools, a terminal-to-GIF recorder minus the headaches.

• vhs (⭐18k) - FREE - Generate beautiful terminal GIFs with a simple scripting language

Jun 10 - Jun 16, 2024

Examples

• Abblix/Oidc.Server (⭐79) - Project banner with informative badges. Clear project description, certification details with informative tables, and unicode icons. Detailed installation guide, links to comprehensive documentation and a getting started guide, and licensing information. Easy navigation with a table of contents for quick access to all sections.

• lobehub/lobe-chat (⭐68k) - Modern badge design. Clear feature introductions accompanied by visual design graphics. Ecosystem introduction. Descriptions of project characteristics and development methods. Contributors section.

• lobehub/sd-webui-lobe-theme (⭐2.6k) - Feature list and demo. I18n support. Navigation with Header and TOC. Clear instructions.

Architecture Examples

• esbuild (⭐39k) - Great use of graphics for visualisations and project structure. Includes a list of important principles for the project.

• Flutter Engine (⭐174k) - Good use of high level diagrams to show the stack and its parts. Describes the main processes. Describes platform invariants.

• GitLab - Calls out design decisions.

• Linux cryptography (⭐207k) - Calls out different types of components, provides searchable areas, calls out invariants of different components, and describes structure with diagrams.

• Neovim (⭐95k) - Describes the main processes/lifecycle.

• Oh My Zsh (⭐183k) - Describes the initialization process, calls out environment requirements.

• Redis (⭐72k) - Good source code map. Overviews of key files. Good use of documentation comments in-code rather than inline comments.

• VS Code (⭐179k) - Good use of high-level diagrams. Describes source organisation.

Apr 15 - Apr 21, 2024

Architecture Examples

• Tauri (⭐99k) - Well made source code map, discusses architecture considerations, calls out important dependencies.

Articles

• Architecture
  • "ARCHITECTURE.md" - Alex Kladov
  • "Two open source projects with great documentation" - John Jago

Apr 01 - Apr 07, 2024

Examples

• serpro69/kotlin-faker (⭐501) - Project logo. Badges. Concise description and clear getting-started instructions with a link to the full documentation website. Test, build and contributing guidelines. Licence info.

Mar 11 - Mar 17, 2024

Examples

• hywax/mafl (⭐612) - Project logo. Clear description of what the project does. TOC for easy navigation. Usage code samples.

Feb 26 - Mar 03, 2024

Examples

• IgorAntun/node-chat (⭐771) - Project screenshot. Informative badges. Clear description. Easy installation/use instructions. Live demo.

Jan 15 - Jan 21, 2024

Examples

• L0garithmic/FastColabCopy (⭐33) - Project logo. Minimalist description. Badges. GIF demo. About The Project. How To Use. Examples. Credits. Additional Examples.

Jan 01 - Jan 07, 2024

Examples

• Owloops/updo (⭐688) - Well-structured, visually appealing, and provides comprehensive information about the tool, from its purpose and features to installation and usage, in a clear and user-friendly manner.

Oct 30 - Nov 05, 2023

Examples

• AntonioFalcaoJr/EventualShop (⭐409) - The project has a logo and well-defined sections such as: information about the project, the architectural solution, along with reference links such as articles, videos, and documentation. It explains how to run the project in different environments (development and production). It has documented load tests, it also describes which technologies are used, and it has diagrams for the archetype.

Oct 23 - Oct 29, 2023

Examples

• skydio/revup (⭐356) - Project logo. Animated GIF demo + GIFs for major stages of the step-by-step tutorial. Concise explanation, installation instructions, and contribution section.

Oct 09 - Oct 15, 2023

Examples

• gowebly/gowebly (⭐1.2k) - Clean project banner with logo. Useful badges and links (languages switcher, test cover, docs). Clear description of what the project does with quickstart, understandable feature list, links to the introduction video and article, well-documented CLI command examples, project philosophy notes ("motivation to create"), tables with project components, links to addons and helpers, list of stargazers, and more.

Mar 20 - Mar 26, 2023

Examples

• ivanperez-keera/Yampa (⭐470) - Clear description. Feature list. TOC for easy navigation. Simple install instructions. Usage code samples. Project samples with GIFs and links to app stores. Documentation and publications. Clear development / contribution rules.

Dec 12 - Dec 18, 2022

Examples

• dbt-labs/dbt-core (⭐12k) - Project banner, super clear description (friendly to people brand new to the product), screenshot of the docs the tool generates, and concise links to other comprehensive pages explaining Getting Started, Joining the dbt Community, Bug Reports, Code Contribution, and Code of Conduct

Nov 28 - Dec 04, 2022

Examples

• refinedev/refine (⭐33k) - Clean project logo. Brief description at top. Multiple badges. Usage description and examples. Use cases and demo links. Screenshots. Key Features. Contributors. Stargazers. Contribution guidelines.

Oct 24 - Oct 30, 2022

Examples

• ankitwasankar/mftool-java (⭐48) - Project logo with a short display of what can be achieved with it, TOC for easy navigation, important badges, clean installation guide, and multiple code snippets showing how to use the functionality.

Oct 17 - Oct 23, 2022

Examples

• iterative/dvc (⭐15k) - ReStructuredText format example, PyPi compatible. Logo, custom website-like menu. Smooth how-it-works animation. Badges. Nice contribution section with the hall-of-fame.

Aug 01 - Aug 07, 2022

Tools

• user-statistician (⭐93) - A GitHub Action that generates SVG of detailed GitHub user activity for profile readmes.

Jun 20 - Jun 26, 2022

Examples

• NASA/ogma (⭐503) - Clear description. Feature list. Demo GIFs. Simple install instructions. Usage code samples. TOC for easy navigation.

Jun 13 - Jun 19, 2022

Examples

• httpie/httpie (⭐37k) - Description of what the project does. Demo screenshots. Project logo. TOC for easy navigation. Build badges. Quick and simple installation and usage sections. Includes an examples section.

Articles

• "Art of Readme - Learn the art of writing quality READMEs." (⭐7.1k) - Stephen Whitmore

Tools

• Common Readme (⭐395) - A common readme style for Node. Includes a guide and a readme generator.

May 02 - May 08, 2022

Articles

• "Elegant READMEs" - Yegor Bugayenko

Feb 28 - Mar 06, 2022

Examples

• amplication/amplication (⭐16k) - Clear project logo. Brief explanation. All features explained. Clean documentation. Useful links (website, docs, discord). List of contributors with their pictures and usernames.

• emalderson/thephish (⭐1.3k) - Project logo, informative badges, useful TOC, clear description, screenshots, step-by-step installation and configuration guide, contributor guidelines, code of conduct, UML diagrams, coherent tags, issue and pull request templates, well-documented and well-commented code, examples.

Jan 10 - Jan 16, 2022

Tools

• GitHub Readme Stats (⭐77k) - Dynamically generated customizable GitHub cards for README. Stats, extra pins, top languages and WakaTime.

Oct 18 - Oct 24, 2021

Examples

• alichtman/shallow-backup (⭐1.3k) - Clear description of what the project does. GIF Demo. TOC for easy navigation. Badges. Links for further reading. Simple install instructions.

Sep 27 - Oct 03, 2021

Examples

• xnbox/DeepfakeHTTP (⭐529) - Original hero section. Clear navigation. Minimalist design. Appendices.

Sep 13 - Sep 19, 2021

Tools

• StackEdit - A user-friendly online editor that allows you to quickly customize all the sections you need for your project's readme.

Aug 16 - Aug 22, 2021

Examples

• chroline/well_app (⭐75) - Features attention-grabbing project thumbnail with clean badges, as well as download information and quick navigation links. Organized into multiple descriptive sections, each of which have a title with a yellow emoji. Includes details about the project itself, as well as the technologies used and how to contribute.

Jun 07 - Jun 13, 2021

Tools

• Amazing GitHub Template (⭐654) - Useful README.md, LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, GitHub Issues, Pull Requests and Actions templates to jumpstart your projects.

May 17 - May 23, 2021

Tools

• READMINE (⭐73) - A thorough, clear and self-describing README file template for software projects; copy it and edit it as needed.

May 10 - May 16, 2021

Examples

• priyavrat-misra/xrays-and-gradcam (⭐56) - TOC for easy navigation. Clear introduction of what the project does. Complete list of all files in the repo and what their function is. Usage section. Clean and concise tables.

May 03 - May 09, 2021

Examples

• create-go-app/cli (⭐2.7k) - Clean project logo. Useful badges (version, code style, test cover, docs). Clear readme with quickstart, understandable installation and usage manual, video screencast, ToC with well-documented project features (with a demo recording of the work in the terminal), project philosophy notes ("the why another"), most frequently asked questions, and more.

• dowjones/react-dropdown-tree-select (⭐482) - Clear readme with GIF screenshot for quick demo. Multiple badges, concise ToC, online playground, storybook, detailed description and more.

• gofiber/fiber (⭐39k) - Clean project logo. Useful badges and links (languages switcher, code style, test cover, docs, Discord channel). Clear description of what the project does with quickstart, benchmark charts, well-documented code examples (with the ability to hide long content), project philosophy notes ("the why of project"), tables with project addons, list of contributors, star growth statistics, and more.

• ma-shamshiri/Human-Activity-Recognition (⭐121) - Beautiful table of contents. Project logo. Animated project banner. Complete project folder structure. Clear description of what the project does. Nice contributors’ section. Easy navigation.

• ma-shamshiri/Pacman-Game (⭐95) - Beautiful table of contents. Project logo. Animated project banner. Suitable GIFs to display each part of the project. Complete list of project files in the repo along with their function. Complete execution instruction.

• ma-shamshiri/Spam-Detector (⭐40) - Complete project file description. Project logo. Animated project banner. Concise project description. Clear execution instruction.

• PostHog/posthog (⭐30k) - Custom-made section icons, demo GIF, deploy button, profile images for contributors, concise, clear structure, project logo.

• Rebilly/redoc (⭐25k) - Multiple badges, project logo, live demo link, GIF-animations of the key features, TL;DR usage.

• release-it/release-it (⭐8.7k) - Clear overview of project features with a demo GIF. Badges. Expandable TOC. Usage description and examples. Contribution guidelines. Detailed releases.

• sidneycadot/oeis (⭐50) - Overview. List of required dependencies. Complete list of all files in the repo and what their function is. Visual graph of how it all ties together.

Articles

• "Readme Driven Development" - Tom Preston-Werner

Tools

• Readme.so - A simple editor that allows you to quickly add and customize all the sections you need for your project's readme.

Sep 07 - Sep 13, 2020

Examples

• MananTank/radioactive-state (⭐316) - Badges (version, downloads, coverage, size), Twitter Intent, Project Logo, Feature list, Motivation, Installation, Example with GIFs, Emojis, Collapsible Sections, Live Demos, API detailed usage, FAQs, Chat link.

Jul 13 - Jul 19, 2020

Examples

• kopach/karma-sabarivka-reporter (⭐54) - Project logo. Useful badges, clear readme with screenshots for quick demo. Concise ToC.

Mar 02 - Mar 08, 2020

Examples

• sulu/sulu (⭐1.3k) - Project logo, useful badges, clear instructions on where to find more information and report bugs, GIF screenshots, nice use of emoticons.

Aug 19 - Aug 25, 2019

Examples

• ai/size-limit (⭐6.8k) - Project logo, clear description, screenshot, step-by-step installing instructions.

• aimeos/aimeos-typo3 (⭐1.3k) - Project logo. Clear description of what the project does. Demo screenshot. TOC for easy navigation. Easy installation and setup sections with screenshots. Links for further reading.

• alichtman/stronghold (⭐1.1k) - Project logo. Clear description of what the project does. GIF Demo. TOC for easy navigation. Badges. Links for further reading. Simple install instructions.

• amitmerchant1990/electron-markdownify (⭐1.1k) - Project logo. Minimalist description of what it is. GIF demo of the project. Key features. How to install guide. Credits.

• athityakumar/colorls (⭐5.1k) - Multiple badges. Clean screenshots. Simple install instructions. TOC for easy navigation. Good contributor guidelines.

• ccostan/Home-AssistantConfig (⭐5.1k) - Project Banner. Badges. Easy navigation.

• choojs/choo (⭐6.8k) - Badges, clean, clear. Beautiful little menu above the fold with useful links. An FAQ inside of it for the main questions. Backers. Good language.

• Day8/re-frame (⭐5.5k) - Badges, logo, TOC, etc. Stands out by being a giant, well-written essay about the tech, how to use it, the philosophy behind it, and how it fits into the greater ecosystem.

• github-changelog-generator/github-changelog-generator (⭐7.5k) - TOC for easy navigation. Concise project description. Installation and usage sections. Output example. Great feature overview. List of alternatives. FAQ.

• gitpoint/git-point (⭐4.8k) - Clear description. Project Logo. App Store logos. TOC. Clean screenshots. List of features. Detailed installation process. Landing Page.

• Hexworks/Zircon (⭐782) - Dogfood in readme. Clear description of what the project does. Demo screenshot. TOC for easy navigation. Easy installation and setup sections with screenshots. Links for further reading.

• iharsh234/WebApp (⭐96) - Project landing page. Clear description of what the project does. Demo screenshot. Simple install and usage sections. Includes an examples section with common uses and a mobile demo section.

• karan/joe (⭐2.9k) - Project logo. Clear description of what the project does. GIF demo. Easy install and usage sections.

• Martinsos/edlib (⭐570) - Informative badges (build, version, publication). Concise description. Feature list. TOC. Screenshots. Concise instructions with examples for building and including in your project. Common code examples to get you started quickly.

• nhn/tui.editor (⭐18k) - Project logo. Clear overview of project features with a demo GIF. Badges. TOC for easy navigation. Colorful icons in front of titles.

• NSRare/NSGIF (⭐932) - Project logo. GIF Demo. Usage artwork. Usage code samples.

• rstacruz/hicat (⭐407) - GIF demo. Easy installation and setup sections with screenshots. Build badges. Great examples of use cases.

• ryanoasis/nerd-fonts (⭐61k) - Clean project logo. Brief description at top. Sankey diagram, quick links, badges, OS specific icons, TOC, detailed release changelog.

• sebyddd/SDVersion (⭐1.3k) - Project logo. Build badges. Documentation structuring for multiple programming languages. Usage examples.

• shama/gaze (⭐1.2k) - Project logo. Concise description. Feature list. Usage section. FAQ. Great API documentation. Release history.

• sindresorhus/pageres (⭐9.7k) - Project logo. Clear description of what the project does. Build badges. Demo screenshot. Simple install and usage sections. Includes an examples section with common uses.

• sourcerer-io/sourcerer-app (⭐6.7k) - Clean animated screenshot. Customized call to action badge. Usage showcase.

• sr6033/lterm (⭐57) - Clean logo using characters. Brief updates on development. Detailed contribution guidelines. Contribution suggestions.

Tools

• Hall-of-fame (⭐951) - Helps show recognition to repo contributors on README. Features new/trending/top contributors. Updates every hour.

• README best practices (⭐922) - A place to copy-paste your README.md from

• readme-md-generator (⭐11k) - A CLI that generates beautiful README.md files

• Standard Readme (⭐6.2k) - A standard README style specification. Has a generator to help create spec-compliant READMEs, too.

• Zalando's README Template (⭐805) - Simple template to help you cover all the basics.

Creating GIFs

• Peek (⭐11k) - FREE - Simple and easy to use for Linux users.

Aug 12 - Aug 18, 2019

Articles

• "How To Write A Great README" - Caleb Thompson (thoughtbot)

• "What I learned from an old GitHub project that won 3,000 Stars in a Week" - KyuWoo Choi

Jan 08 - Jan 14, 2018

Tools

• Make a README - A guide to writing READMEs. Includes an editable template with live Markdown rendering.

Nov 13 - Nov 19, 2017

Get Feedback

• maintainer.io - Free README standardization and feedback, if you click on 'Book an audit'.

Dec 05 - Dec 11, 2016

Articles

• "Top ten reasons why I won’t use your open source project" - Adam Stacoviak