Top 50 Awesome List

matiassingers/awesome-readme

Miscellaneous  4 days ago  12.2k
A curated list of awesome READMEs
View byDAY/WEEK/README
View on Github

Jun 20th

Examples

  • NASA/ogmastars192 - Clear description. Feature list. Demo GIFs. Simple install instructions. Usage code samples. TOC for easy navigation.
  • Jun 16th

    Examples

  • httpie/httpiestars22.2k - 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."stars6k - Stephen Whitmore
  • Tools

  • Common Readmestars347 - A common readme style for Node. Includes a guide and a readme generator.
  • Jun 11th

    Creating GIFs

  • Recordit - FREE - Simple, clean UI, but auto-uploads to Recordit.
  • May 6th

    Articles

  • "Elegant READMEs" - Yegor Bugayenko
  • Mar 11th

    Creating GIFs

  • Gifox - $14.99 - Clean UI, hotkeys, lots of advanced features.
  • Gifskistars6.1k - FREE - More vivid colors than the rest, but still keep size low.
  • LICEcap - FREE - Less intuitive, more features.
  • terminalizerstars12.7k - FREE - Record your terminal and generate animated gif images or share a web player.
  • Mar 6th

    Examples

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

    Examples

  • emalderson/thephishstars586 - 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 11th

    Tools

  • GitHub Readme Statsstars42.7k - Dynamically generated customizable GitHub cards for README. Stats, extra pins, top languages and WakaTime.
  • Dec 11th, 2021

    Examples

  • zenml-io/zenmlstars2.1k - Clean project logo. Useful TOC. Clear code examples amongst feature list. Quickstart example.
  • Nov 24th, 2021

    Examples

  • ajeetdsouza/zoxidestars6.7k - Badges, project GIF, concise description, quick links, stepwise installation instructions.
  • Oct 23rd, 2021

    Examples

  • alichtman/shallow-backupstars915 - Clear description of what the project does. GIF Demo. TOC for easy navigation. Badges. Links for further reading. Simple install instructions.
  • aregtech/areg-sdkstars66 - Description of the project and use cases with explanation graphics. Build with multiple tools and integration instructions, reference to the guidance to create the first project. Examples. Project logo. Multiple badges. Headlines with graphics. TOC for easy navigation.
  • Oct 9th, 2021

    Examples

  • OliverOverend/gym-simplifiedtetrisstars2 - GIF demo. Short description of the project. Badges. TOC. Installation and usage intructions, with copy-pastable comments and dependencies. Contributing file. Overview of the environments and agents provided.
  • Sep 28th, 2021

    Examples

  • xnbox/DeepfakeHTTPstars396 - Original hero section. Clear navigation. Minimalist design. Appendices.
  • Sep 17th, 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 15th, 2021

    Examples

  • chroline/well_appstars33 - 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.
  • Jul 24th, 2021

    Examples

  • L0garithmic/FastColabCopystars17 - Project logo. Minimalist description. Badges. GIF demo. About The Project. How To Use. Examples. Credits. Additional Examples.
  • Jun 13th, 2021

    Tools

  • Amazing GitHub Templatestars192 - Useful README.md, LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, GitHub Issues, Pull Requests and Actions templates to jumpstart your projects.
  • May 18th, 2021

    Tools

  • READMINEstars29 - A thorough, clear and self-describing README file template for software projects; copy it and edit it as needed.
  • May 14th, 2021

    Examples

  • priyavrat-misra/xrays-and-gradcamstars32 - 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 9th, 2021

    Tools

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

  • "Readme Driven Development" - Tom Preston-Werner
  • Examples

  • dowjones/react-dropdown-tree-selectstars402 - Clear readme with GIF screenshot for quick demo. Multiple badges, concise ToC, online playground, storybook, detailed description and more.
  • iterative/dvcstars9.9k - ReStructuredText format example, PyPi compatible. Logo, custom website-like menu. Smooth how-it-works animation. Badges. Nice contribution section with the hall-of-fame.
  • ngcolombia/medellinstars153 - Project banner. Badges for stats. Well placed emoticons. Contributor's photos.
  • Rebilly/redocstars17.6k - Multiple badges, project logo, live demo link, GIF-animations of the key features, TL;DR usage.
  • release-it/release-itstars5.3k - Clear overview of project features with a demo GIF. Badges. Expandable TOC. Usage description and examples. Contribution guidelines. Detailed releases.
  • sidneycadot/oeisstars38 - 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.
  • PostHog/posthogstars8.2k - Custom-made section icons, demo GIF, deploy button, profile images for contributors, concise, clear structure, project logo.
  • easybase/easybase-reactstars69 - Project banner and logo. Badges. Expandable walkthrough sections. Concise description and purpose. TOC for easy navigation. GIFs for installation demo. Multiple informative visuals.
  • ma-shamshiri/Human-Activity-Recognitionstars30 - 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-Gamestars28 - 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-Detectorstars14 - Complete project file description. Project logo. Animated project banner. Concise project description. Clear execution instruction.
  • create-go-app/clistars1.4k - 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.
  • gofiber/fiberstars20.6k - 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.
  • Sep 4th, 2020

    Examples

  • MananTank/radioactive-statestars290 - 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 9th, 2020

    Examples

  • kopach/karma-sabarivka-reporterstars36 - Project logo. Useful badges, clear readme with screenshots for quick demo. Concise ToC.
  • Jul 8th, 2020

    Examples

  • Stack-in-a-box/triumphmayflowerclub.comstars2 - 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 set-up instructions. Includes many common elements found in other beautiful READMEs.
  • Feb 28th, 2020

    Examples

  • sulu/sulustars828 - Project logo, useful badges, clear instructions on where to find more information and report bugs, GIF screenshots, nice use of emoticons.
  • Feb 2nd, 2020

    Examples

  • React Parallax Tiltstars481 - GIF demo. Multiple badges. Feature list. Great live demo with code examples. Easy to follow instructions for local development set up.
  • Aug 16th, 2019

    Creating GIFs

  • ScreenToGifstars17.7k - FREE - Open source, customizable UI and easily editable GIFs, easy to get started.
  • Aug 13th, 2019

    Examples

  • ai/size-limitstars5.2k - Project logo, clear description, screenshot, step-by-step installing instructions.
  • aimeos/aimeos-typo3stars186 - 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/strongholdstars936 - 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-markdownifystars795 - Project logo. Minimalist description of what it is. GIF demo of the project. Key features. How to install guide. Credits.
  • anfederico/Clairvoyantstars2.3k - Multiple badges. Clean logo. Simple install instructions. Clear overview of the project accompanied by a schematic. GIF demo. Extensive code examples.
  • Armync/Arminc-AutoExecstars101 - Rich Markdown functions, modern layout, clear description and compliant with the recommended community standards.
  • athityakumar/colorlsstars4.1k - Multiple badges. Clean screenshots. Simple install instructions. TOC for easy navigation. Good contributor guidelines.
  • ccostan/Home-AssistantConfigstars3.9k - Project Banner. Badges. Easy navigation.
  • choojs/choostars6.7k - 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-framestars5.1k - 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-generatorstars6.8k - TOC for easy navigation. Concise project description. Installation and usage sections. Output example. Great feature overview. List of alternatives. FAQ.
  • gitpoint/git-pointstars4.6k - Clear description. Project Logo. App Store logos. TOC. Clean screenshots. List of features. Detailed installation process. Landing Page.
  • Hexworks/Zirconstars673 - 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/WebAppstars78 - 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/joestars2.8k - Project logo. Clear description of what the project does. GIF demo. Easy install and usage sections.
  • Martinsos/edlibstars384 - 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.editorstars14.8k - Project logo. Clear overview of project features with a demo GIF. Badges. TOC for easy navigation. Colorful icons in front of titles.
  • node-chatstars710 - Project screenshot. Informative badges. Clear description. Easy installation/use instructions. Live demo.
  • NSRare/NSGIFstars907 - Project logo. GIF Demo. Usage artwork. Usage code samples.
  • php-censor/php-censorstars649 - Multiple badges, project logo, screenshots, step-by-step installing and upgrading instructions, TOC for easy navigation.
  • React on lambdastars220 - Project logo, comics to present the main idea, badges, examples with code snippets, demo projects, api documentations, editor configurations.
  • rstacruz/hicatstars395 - GIF demo. Easy installation and setup sections with screenshots. Build badges. Great examples of use cases.
  • ryanoasis/nerd-fontsstars36.3k - Clean project logo. Brief description at top. Sankey diagram, quick links, badges, OS specific icons, TOC, detailed release changelog.
  • sebyddd/SDVersionstars1.3k - Project logo. Build badges. Documentation structuring for multiple programming languages. Usage examples.
  • shama/gazestars1.2k - Project logo. Concise description. Feature list. Usage section. FAQ. Great API documentation. Release history.
  • sindresorhus/pageresstars9.4k - 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-appstars6.7k - Clean animated screenshot. Customized call to action badge. Usage showcase.
  • sr6033/ltermstars46 - Clean logo using characters. Brief updates on development. Detailed contribution guidelines. Contribution suggestions.
  • supunlakmal/thismypcstars154 - Project logo. Useful badges. Web site URL. Screenshot. GIF step-by-step instructions for installation. Project folder structure.
  • teles/array-mixerstars33 - Clean project logo, badges. Table of contents. Contributing section. Many illustrated examples.
  • thelounge/theloungestars4.8k - Project logo. Useful badges and links (website, docs, demo). Screenshot. Feature list. Step-by-step instructions for installation, development, and testing. Link to the contributing guide. Good mobile summary.
  • vhesener/Closuresstars1.7k - Project logo, cognitive funnel, animated examples. Color coordinated. Clean documentation.
  • Tools

  • Feedmereadmesstars1.1k - README editing and project analysis/feedback.
  • Hall-of-famestars922 - Helps show recognition to repo contributors on README. Features new/trending/top contributors. Updates every hour.
  • README best practicesstars761 - A place to copy-paste your README.md from
  • readme-md-generatorstars9.6k - A CLI that generates beautiful README.md files
  • Standard Readmestars4.8k - A standard README style specification. Has a generator to help create spec-compliant READMEs, too.
  • Zalando's README Template - Simple template to help you cover all the basics.
  • Creating GIFs

  • Peekstars9k - FREE - Simple and easy to use for Linux users.
  • ttystudiostars3.2k - FREE - For commandline tools, a terminal-to-gif recorder minus the headaches.
  • Get Feedback

  • feedmereadmesstars1.1k - Free README editing+feedback to make your open-source projects grow. See the README maturity model to help you keep going.
  • Aug 10th, 2019

    Jan 8th, 2018

    Tools

  • Make a README - A guide to writing READMEs. Includes an editable template with live Markdown rendering.
  • Nov 17th, 2017

    Get Feedback

  • maintainer.io - Free README standardization and feedback, if you click on 'Book an audit'.
  • This repository. Submit a PR with your README!
  • Jul 6th, 2017

    Creating GIFs

  • Giphy Capture - FREE - Easy to upload to giphy.com, slightly annoying UX.
  • Dec 7th, 2016

    Last Checked At: 2022-06-24T19:20:10.805Z
    Previous
    melvin0008/awesome-projects-boilerplates
    Next
    NARKOZ/guides

    About

    Track your favorite github awesome repo, not just star it. trackawesomelist.com provides website, newsletter, RSS for tracking the popular awesome list by daily and weekly.
    Contact us: [email protected]
    Track Awesome List - Track your favorite Github awesome repos, not just star them | Product Hunt

    Subscribe

    Subscribe to our weekly newsletter to receive the awesome updates! We never send spam and you can unsubscribe instantly with one click. Here's past issues.

    Links

    Follow us on TwitterSubscribe us on TelegramSubmit awesome list repoNewsletterDonateSitemap