{"id":14962986,"url":"https://github.com/smerth/gatsby-source-gh-readme","last_synced_at":"2025-10-25T00:31:42.392Z","repository":{"id":57244958,"uuid":"168430522","full_name":"smerth/gatsby-source-gh-readme","owner":"smerth","description":"This GatsbyJS plugin queries GitHub's GraphQL API. It fetches the README.md file contents on the master branch of each repository and creates nodes in GatsbyJS which can be queried using GraphQL. Because the mime type for the content of these nodes is set to 'text/markdown' they are further processed into MarkdownRemark nodes. ","archived":false,"fork":false,"pushed_at":"2019-07-18T20:54:46.000Z","size":223,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-30T00:35:35.269Z","etag":null,"topics":["gatsby-plugin","gatsby-source-plugin","gatsbyjs","github","javascript","node-js"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smerth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-30T23:19:28.000Z","updated_at":"2023-01-30T16:41:55.000Z","dependencies_parsed_at":"2022-09-01T04:31:03.820Z","dependency_job_id":null,"html_url":"https://github.com/smerth/gatsby-source-gh-readme","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smerth%2Fgatsby-source-gh-readme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smerth%2Fgatsby-source-gh-readme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smerth%2Fgatsby-source-gh-readme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smerth%2Fgatsby-source-gh-readme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smerth","download_url":"https://codeload.github.com/smerth/gatsby-source-gh-readme/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238053514,"owners_count":19408699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gatsby-plugin","gatsby-source-plugin","gatsbyjs","github","javascript","node-js"],"created_at":"2024-09-24T13:30:52.287Z","updated_at":"2025-10-25T00:31:42.044Z","avatar_url":"https://github.com/smerth.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Gatsby Source Gh Readme\n\n## About\n\nThis GatsbyJS plugin queries GitHub's GraphQL API. It fetches the README.md file contents on the master branch of each repository and creates nodes in GatsbyJS which can be queried using GraphQL. \n\nThe mime type for the content of these nodes is set to 'text/markdown' so that they are further processed into MarkdownRemark nodes if that functionality has been installed on your site. \n\nFor more details about how to use this plugin see the readme file in the `packages/gatsby-source-gh-readme` folder.\n\n## Project structure\n\nThe repository is configured as a yarn workspace (to manage packages across workspaces) and with lerna (to manage tagging and publishing to NPM)\n\nThe project repository contains two gatsby sites in the examples folder:\n\n- gatsby-local-plugin - a gatsby site that uses the plugin code from the local repo\n- gatsby-published-plugin - a gatsby site that uses the latest version of the plugin from NPM.\n\n\n\n## Usage\n\n\n\n1. **Just add your github keys to the site you want to use**\n\nCreate .env files to hold you secret token\n\n    touch .env.development\n\nand for production...\n\n    touch .env.production\n\nEdit these file to hold your github token\n\n    # Github GraphQL API (Public and Private)\n    GITHUB_API_TOKEN=\"YOUR-SECRET-TOKEN-GOES-HERE\"\n\n2. **Install the dependancies from the root**\n\n```bash\nyarn install\n```\n\n3. **Run one of the sites**\n\n*Run the site using the latest published version of the plugin, then go to the GraphiQL interface and query for data.*\n\n    yarn workspace gatsby-published-plugin develop\n\nOr,\n\n*Run the local gatsby site and edit the local package code to see the effect.*\n\n    yarn workspace gatsby-local-plugin develop\n\nWith that you are all set to play with the plugin and queries or contribute.\n\n## Contribute\n\nFeel free to file an issue and then a pull request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmerth%2Fgatsby-source-gh-readme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmerth%2Fgatsby-source-gh-readme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmerth%2Fgatsby-source-gh-readme/lists"}