panzhangwang/getAwesomeness

---

panzhangwang/getAwesomeness.json

{
  "createdAt": "2014-12-16T00:28:53Z",
  "defaultBranch": "master",
  "description": " Use this method to retrieve all amazing awesomeness from Github",
  "fullName": "panzhangwang/getAwesomeness",
  "homepage": "https://getawesomeness.herokuapp.com/",
  "language": "JavaScript",
  "name": "getAwesomeness",
  "pushedAt": "2021-05-31T00:31:25Z",
  "stargazersCount": 1099,
  "topics": [],
  "updatedAt": "2025-10-22T16:26:19Z",
  "url": "https://github.com/panzhangwang/getAwesomeness"
}

getAwesomeness()

getAwesomeness() is an explorer designed for curated awesome list hosted on Github. Website: https://getawesomeness.herokuapp.com/.

Key Features

• Single repository of amazing lists
• Better organization and navigation
• Content auto-synced with github
• i18n support

Rational

As a developer, we need check out these resources pretty often, and we want to save our time and have a better bookmarking experience. With that in mind, getAwesomeness() shares a better organization and navigation method. It works by croping the table of contents out from the markdown file, normally, README.md, and regenerating TOC and then affixing it on the side bar. So, if you found the hacking breaks, please raise an issue or send us a PR, your contribution is always welcome.

Install

$ git clone git://github.com/panzhangwang/getAwesomeness.git
$ cd getAwesomeness
$ npm install
$ npm start

Then visit http://localhost:3000/

Steps to add a new list

• Open db.json, add a new definition under defs.

  {
      "key": "java",
      "name": "Java",
      "repo": "/akullpp/awesome-java",
      "file": "README.md"
    }

file atrribute is optional, by default it is README.md.

• Register the key of the list under groups.

  {
      "title": "JVM",
      "items": [
        "java",
        "scala"
      ]
    }

License

MIT