{"id":16118007,"url":"https://github.com/wessberg/sandhog","last_synced_at":"2025-03-17T18:30:41.350Z","repository":{"id":57169430,"uuid":"139251211","full_name":"wessberg/sandhog","owner":"wessberg","description":"A virtual Open Source project maintainer","archived":false,"fork":false,"pushed_at":"2024-10-31T00:11:42.000Z","size":2164,"stargazers_count":15,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-11T16:42:44.828Z","etag":null,"topics":["backers","codegen","codeofconduct","contributing","maintainers","opensource","project","readme","scaffold"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wessberg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"wessberg"}},"created_at":"2018-06-30T13:21:10.000Z","updated_at":"2024-10-31T00:11:45.000Z","dependencies_parsed_at":"2024-06-19T09:54:03.154Z","dependency_job_id":"37843fef-d870-49f5-81d1-c8279096126d","html_url":"https://github.com/wessberg/sandhog","commit_stats":{"total_commits":179,"total_committers":1,"mean_commits":179.0,"dds":0.0,"last_synced_commit":"4993b76021cf2f936b717110a677cadeb8cffa39"},"previous_names":["wessberg/scaffold"],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wessberg%2Fsandhog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wessberg%2Fsandhog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wessberg%2Fsandhog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wessberg%2Fsandhog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wessberg","download_url":"https://codeload.github.com/wessberg/sandhog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243878439,"owners_count":20362432,"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":["backers","codegen","codeofconduct","contributing","maintainers","opensource","project","readme","scaffold"],"created_at":"2024-10-09T20:48:20.148Z","updated_at":"2025-03-17T18:30:40.990Z","avatar_url":"https://github.com/wessberg.png","language":"TypeScript","funding_links":["https://patreon.com/wessberg","https://www.patreon.com/bePatron?u=11315442"],"categories":[],"sub_categories":[],"readme":"\u003c!-- SHADOW_SECTION_LOGO_START --\u003e\n\n\u003cdiv\u003e\u003cimg alt=\"Logo\" src=\"https://raw.githubusercontent.com/wessberg/sandhog/master/documentation/asset/logo.png\" height=\"200\"   /\u003e\u003c/div\u003e\n\n\u003c!-- SHADOW_SECTION_LOGO_END --\u003e\n\n\u003c!-- SHADOW_SECTION_DESCRIPTION_SHORT_START --\u003e\n\n\u003e A virtual Open Source project maintainer\n\n\u003c!-- SHADOW_SECTION_DESCRIPTION_SHORT_END --\u003e\n\n\u003c!-- SHADOW_SECTION_BADGES_START --\u003e\n\n\u003ca href=\"https://npmcharts.com/compare/sandhog?minimal=true\"\u003e\u003cimg alt=\"Downloads per month\" src=\"https://img.shields.io/npm/dm/sandhog.svg\"    /\u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/sandhog\"\u003e\u003cimg alt=\"NPM version\" src=\"https://badge.fury.io/js/sandhog.svg\"    /\u003e\u003c/a\u003e\n\u003cimg alt=\"Dependencies\" src=\"https://img.shields.io/librariesio/github/wessberg%2Fsandhog.svg\"    /\u003e\n\u003ca href=\"https://github.com/wessberg/sandhog/graphs/contributors\"\u003e\u003cimg alt=\"Contributors\" src=\"https://img.shields.io/github/contributors/wessberg%2Fsandhog.svg\"    /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/prettier/prettier\"\u003e\u003cimg alt=\"code style: prettier\" src=\"https://img.shields.io/badge/code_style-prettier-ff69b4.svg\"    /\u003e\u003c/a\u003e\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-yellow.svg\"    /\u003e\u003c/a\u003e\n\u003ca href=\"https://www.patreon.com/bePatron?u=11315442\"\u003e\u003cimg alt=\"Support on Patreon\" src=\"https://img.shields.io/badge/patreon-donate-green.svg\"    /\u003e\u003c/a\u003e\n\n\u003c!-- SHADOW_SECTION_BADGES_END --\u003e\n\n\u003c!-- SHADOW_SECTION_DESCRIPTION_LONG_START --\u003e\n\n## Description\n\n\u003c!-- SHADOW_SECTION_DESCRIPTION_LONG_END --\u003e\n\nSandhog is a tool that makes it easy for you to have a welcoming, professional-looking Github repository.\nIt helps you generate and continuously maintain your `README.md`, `LICENSE.md`, `CONTRIBUTING.md`, `FUNDING.yml`, and `CODE_OF_CONDUCT.md` files by looking at the files inside your repository.\nThis README is generated by Sandhog.\n\n\u003c!-- SHADOW_SECTION_FEATURES_START --\u003e\n\n### Features\n\n\u003c!-- SHADOW_SECTION_FEATURES_END --\u003e\n\nSandhog works out of the box without any configuration. Some highlights include:\n\n- Generation of relevant badges for your README\n- Generating of maintainer tables, including avatars, social links, and contact details\n- Generation of Patreon and Open Collective backer/sponsor images that doesn't require any maintenance\n- Generation of `LICENSE.md` files for a large variety of popular licenses.\n- Generation of `CODE_OF_CONDUCT.md` files\n- Generation of `CONTRIBUTING.md` files.\n- Generation of `FUNDING.yml` files\n\n\u003c!-- SHADOW_SECTION_FEATURE_IMAGE_START --\u003e\n\n\u003cdiv\u003e\u003cimg alt=\"Feature image\" src=\"https://raw.githubusercontent.com/wessberg/sandhog/master/documentation/asset/feature.svg\" height=\"300\"   /\u003e\u003c/div\u003e\u003cbr\u003e\n\n\u003c!-- SHADOW_SECTION_FEATURE_IMAGE_END --\u003e\n\n\u003c!-- SHADOW_SECTION_BACKERS_START --\u003e\n\n## Backers\n\n### Patreon\n\n\u003ca href=\"https://www.patreon.com/bePatron?u=11315442\"\u003e\u003cimg alt=\"Patrons on Patreon\" src=\"https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dwessberg%26type%3Dpatrons\"  width=\"200\"  /\u003e\u003c/a\u003e\n\n\u003c!-- SHADOW_SECTION_BACKERS_END --\u003e\n\n\u003c!-- SHADOW_SECTION_TOC_START --\u003e\n\n## Table of Contents\n\n- [Description](#description)\n  - [Features](#features)\n- [Backers](#backers)\n  - [Patreon](#patreon)\n- [Table of Contents](#table-of-contents)\n- [Install](#install)\n  - [npm](#npm)\n  - [Yarn](#yarn)\n  - [pnpm](#pnpm)\n  - [Run once with npx](#run-once-with-npx)\n- [Engine](#engine)\n- [Usage](#usage)\n  - [Configuration](#configuration)\n    - [Configuration options](#configuration-options)\n    - [Additional metadata for `package.json` fields](#additional-metadata-for-packagejson-fields)\n  - [CLI](#cli)\n    - [The `readme`-command](#the-readme-command)\n    - [The `license`-command](#the-license-command)\n    - [The `funding`-command](#the-funding-command)\n    - [The `contributing`-command](#the-contributing-command)\n    - [The `coc`-command (Code Of Conduct)](#the-coc-command-code-of-conduct)\n    - [The `all`-command](#the-all-command)\n  - [Readme structure](#readme-structure)\n  - [Readme sections](#readme-sections)\n    - [`toc` (Table of Contents)](#toc-table-of-contents)\n  - [`logo`](#logo)\n  - [`badges`](#badges)\n  - [`description_short`](#description_short)\n  - [`description_long`](#description_long)\n  - [`features`](#features)\n  - [`feature_image`](#feature_image)\n  - [`install`](#install)\n  - [`usage`](#usage)\n  - [`contributing`](#contributing)\n  - [`maintainers`](#maintainers)\n  - [`faq`](#faq)\n  - [`backers`](#backers)\n  - [`license`](#license)\n- [Contributing](#contributing)\n  - [FAQ](#faq)\n    - [Do you support custom templates?](#do-you-support-custom-templates)\n    - [How do you determine the Code Style of the project?](#how-do-you-determine-the-code-style-of-the-project)\n- [License](#license)\n\n\u003c!-- SHADOW_SECTION_TOC_END --\u003e\n\n\u003c!-- SHADOW_SECTION_INSTALL_START --\u003e\n\n## Install\n\n### npm\n\n```\n$ npm install sandhog --save-dev\n```\n\n### Yarn\n\n```\n$ yarn add sandhog --dev\n```\n\n### pnpm\n\n```\n$ pnpm add sandhog --save-dev\n```\n\n### Run once with npx\n\n```\n$ npx sandhog\n```\n\n\u003c!-- SHADOW_SECTION_INSTALL_END --\u003e\n\n## Engine\n\nSandhog requires Node.js v14.19.0 or newer to work correctly.\n\n\u003c!-- SHADOW_SECTION_USAGE_START --\u003e\n\n## Usage\n\n\u003c!-- SHADOW_SECTION_USAGE_END --\u003e\n\n### Configuration\n\nSandhog is highly configurable. You can provide a configuration in a variety of ways:\n\n- As a `sandhog` property inside your `package.json` file.\n- As a `sandhog.config.js` file within your repository root\n- As a `sandhog.config.cjs` file within your repository root\n- As a `sandhog.config.mjs` file within your repository root\n- As a `sandhog.config.json` file within your repository root\n- As a `sandhog.config.json5` file within your repository root\n- As a `sandhog.config.yaml` file within your repository root\n- As a `sandhog.config.yml` file within your repository root\n- As a `.sandhogrc` (JSON-formatted) file within your repository root\n\n#### Configuration options\n\n```typescript\ninterface SandhogOptions {\n  // If true, the install directions inside generated READMEs will suggest installing this package as a development dependency.\n  isDevelopmentPackage: boolean;\n  // If provided, a logo image will be placed in the top of generated or updated README files\n  logo: {\n    // An URL to the logo.\n    url: string;\n    // The height of the logo in pixels\n    height: number;\n  };\n\n  // If provided, a feature image will be placed within generated or updated README files\n  featureImage: {\n    // An URL to the feature image.\n    url: string;\n    // The height of the feature image in pixels\n    height: number;\n  };\n  // If Patreon, Open Collective, and/or other donation options is given, badges and backer/sponsor shields will be generated and added to generated or updated README files.\n  donate: {\n    patreon: {\n      userId: string;\n    };\n    openCollective: {\n      project: string;\n    };\n    other: {\n      fundingUrl: string;\n      donors: [\n        {\n          name: string;\n          url: string;\n          imageUrl: string;\n          twitter: string;\n        }\n      ];\n    };\n  };\n  readme: {\n    badges: {\n      // The given iterable of SectionKinds will never be added to generated or updated READMEs\n      // Can be any of the following: 'toc', 'logo', 'badges', 'description_short', 'description_long', 'features', 'feature_image', 'usage', 'install', 'contributing', 'maintainers', 'faq', 'backers', and 'license'\n      exclude: Iterable\u003c\n        | \"toc\"\n        | \"logo\"\n        | \"badges\"\n        | \"description_short\"\n        | \"description_long\"\n        | \"features\"\n        | \"feature_image\"\n        | \"usage\"\n        | \"install\"\n        | \"contributing\"\n        | \"maintainers\"\n        | \"faq\"\n        | \"backers\"\n        | \"license\"\n      \u003e;\n    };\n    sections: {\n      // The given iterable of BadgeKinds will never be added to generated or updated READMEs.\n      // Can be any of the following: 'downloads', 'dependencies', 'npm', 'contributors', 'license', 'patreon', 'open_collective_donate', 'open_collective_backers', 'open_collective_sponsors', and 'code_style'\n      exclude: Iterable\u003c\n        | \"downloads\"\n        | \"dependencies\"\n        | \"npm\"\n        | \"contributors\"\n        | \"license\"\n        | \"patreon\"\n        | \"open_collective_donate\"\n        | \"open_collective_backers\"\n        | \"open_collective_sponsors\"\n        | \"code_style\"\n      \u003e;\n    };\n  };\n  // By default, Sandhog will try to locate a Prettier config within the project. You can also just provide it or override the Prettier options here\n  prettier: PrettierOptions;\n}\n```\n\n#### Additional metadata for `package.json` fields\n\nBeyond the Sandhog configuration, Sandhog will look for metadata inside your `package.json` and use it to further enhance the files that can be\nproduced by Sandhog. For example, the `author` and/or `contributors` properties of your `package.json` can include additional keys such as the individual contributors\n`imageUrl`, `twitter` handle, and `github` username.\n\nFor example:\n\n```json5\n// Inside package.json\n{\n  contributors: [\n    {\n      name: \"John Done\",\n      email: \"john@doe.com\",\n      url: \"https://john.doe\",\n\n      // The following three fields are enhancements\n      imageUrl: \"https://john.doe/avatar.png\",\n      role: \"Lead Developer\",\n      twitter: \"JohnDoe\",\n      github: \"johndoe\"\n    }\n  ]\n}\n```\n\nAs seen in the code example above, contributors can be extended with the following optional properties:\n\n| Property   | Description                                                                                |\n| ---------- | ------------------------------------------------------------------------------------------ |\n| `imageUrl` | An avatar that should be displayed above the rest of the information about the contributor |\n| `role`     | The role of the contributor within the project.                                            |\n| `twitter`  | The Twitter handle for the contributor                                                     |\n| `github`   | The Github username for the contributor                                                    |\n\n### CLI\n\n```\n$ sandhog --help\n\nUsage: sandhog [options] [command]\n\nOptions:\n  -h, --help              output usage information\n\nCommands:\n  coc [options]           Generates a CODE_OF_CONDUCT.md file\n  funding [options]       Generates a FUNDING.yml file\n  contributing [options]  Generates a CONTRIBUTING.md file\n  license [options]       Generates a LICENSE.md file\n  readme [options]        Generates a README.md file\n  all [options]           Generates all of the files Sandhog supports in one command\n```\n\n#### The `readme`-command\n\n```\n$ sandhog readme --help\n  Usage: readme [options]\n\n  Generates a README.md file\n\n  Options:\n    -c, --config [arg]       An (optional) path to the sandhog config to use\n    -d, --debug [arg]        Whether to print debug information\n    -v, --verbose [arg]      Whether to print verbose information\n    -s, --silent [arg]       Whether to not print anything\n    -y, --yes [arg]          Whether or not to auto-select 'yes' for all prompts\n    --section.exclude [arg]  The comma-separated sections to exclude from the generated README.md\n    --badge.exclude [arg]    The comma-separated badges to exclude from the generated README.md\n    -h, --help               output usage information\n```\n\nThe `readme` command will generate or update a `README.md` file. This README is generated via this command.\nThe sections of the README will vary depending on your configuration as well as the state of your repository.\n\nIf a `README.md` file already exists within the repository, you will be prompted for permission to overwrite it if it has changed,\nunless the `--yes` option is given (see above).\n\n#### The `license`-command\n\n```\n$ sandhog license --help\n  Usage: license [options]\n\n  Generates a LICENSE.md file\n\n  Options:\n    -c, --config [arg]   An (optional) path to the sandhog config to use\n    -d, --debug [arg]    Whether to print debug information\n    -v, --verbose [arg]  Whether to print verbose information\n    -s, --silent [arg]   Whether to not print anything\n    -y, --yes [arg]      Whether or not to auto-select 'yes' for all prompts\n    -l, --license [arg]  Override the license to use generate\n    -h, --help           output usage information\n```\n\nThe `license` command will generate or update a `LICENSE.md` file. See [this file](./LICENSE.md) for an example output.\nIt will attempt to find the license for the project within the `package.json` file or by parsing the existing\n`LICENSE.md` file (if it exists) to try to determine a license.\n\nYou can override the discovery algorithm by explicitly providing a license via the `--license` flag (see above).\n\nIf a `LICENSE.md` file already exists within the repository, you will be prompted for permission to overwrite it\nif it has changed, unless the `--yes` option is given (see above).\n\n#### The `funding`-command\n\n```\n$ sandhog funding --help\n  Usage: funding [options]\n\n  Generates a FUNDING.yml file\n\n  Options:\n    -c, --config [arg]   An (optional) path to the sandhog config to use\n    -d, --debug [arg]    Whether to print debug information\n    -v, --verbose [arg]  Whether to print verbose information\n    -s, --silent [arg]   Whether to not print anything\n    -y, --yes [arg]      Whether or not to auto-select 'yes' for all prompts\n    -h, --help           output usage information\n```\n\nThe `funding` command will generate or update a `FUNDING.yml` file inside the `.github` subdirectory.\nThe file will follow the form as described in the [Github Sponsor guide](https://help.github.com/en/articles/displaying-a-sponsor-button-in-your-repository).\n\nIt will take the Patreon and Open Collective information if given in the [Sandhog config](#configuration), as well as parse the `package.json` for the author and/or contributors and add them to the Github Sponsors section if\na `github` username can be found. [See this section](#additional-metadata-for-packagejson-fields) for more details on the metadata that can be provided for authors and contributors.\n\nIf a `FUNDING.yml` file already exists within the `.github` subdirectory in the repository, you will be prompted for permission to overwrite it\nif it has changed, unless the `--yes` option is given (see above).\n\n#### The `contributing`-command\n\n```\n$ sandhog contributing --help\n  Usage: contributing [options]\n\n  Generates a CONTRIBUTING.md file\n\n  Options:\n    -c, --config [arg]   An (optional) path to the sandhog config to use\n    -d, --debug [arg]    Whether to print debug information\n    -v, --verbose [arg]  Whether to print verbose information\n    -s, --silent [arg]   Whether to not print anything\n    -y, --yes [arg]      Whether or not to auto-select 'yes' for all prompts\n    -h, --help           output usage information\n```\n\nThe `contributing` command will generate or update a `CONTRIBUTING.md` file in a friendly language. See [this file](./CONTRIBUTING.md) for an example output.\nIt will parse the package.json for the author and/or contributors and use them within the generated file if possible.\n\nIf a `CONTRIBUTING.md` file already exists within the repository, you will be prompted for permission to overwrite it\nif it has changed, unless the `--yes` option is given (see above).\n\n#### The `coc`-command (Code Of Conduct)\n\n```\n$ sandhog coc --help\nUsage: coc [options]\n\nGenerates a CODE_OF_CONDUCT.md file\n\nOptions:\n  -c, --config [arg]   An (optional) path to the sandhog config to use\n  -d, --debug [arg]    Whether to print debug information\n  -v, --verbose [arg]  Whether to print verbose information\n  -s, --silent [arg]   Whether to not print anything\n  -y, --yes [arg]      Whether or not to auto-select 'yes' for all prompts\n  -h, --help           output usage information\n```\n\nThe `coc` command will generate or update a Code Of Conduct file based on the [Contributor Covenant v1.4.1](https://www.contributor-covenant.org/).\nAll project maintainers listed in the `package.json` (either through the `author` or `contributors` fields) file located in the repository root will be\nmarked as Code Of Conduct enforcers. If a `CODE_OF_CONDUCT.md` file already exists within the repository, you will be prompted for permission to overwrite it\nif it has changed, unless the `--yes` option is given (see above).\n\n#### The `all`-command\n\n```\n$ sandhog all --help\nUsage: all [options]\n\nGenerates all of the files sandhog supports in one command\n\nOptions:\n  -c, --config [arg]   An (optional) path to the sandhog config to use\n  -d, --debug [arg]    Whether to print debug information\n  -v, --verbose [arg]  Whether to print verbose information\n  -s, --silent [arg]   Whether to not print anything\n  -y, --yes [arg]      Whether or not to auto-select 'yes' for all prompts\n  -h, --help           output usage information\n```\n\nThe `all` command will generate or update each of the files that Sandhog can generate in a single command.\n\nThis is useful if you usually call each and every Sandhog command individually, for example between releases.\n\nThe behavior of the individual options is described in the other sections above.\n\n### Readme structure\n\nThe README is the heart of your Open source repository. The same goes for Sandhog.\nWhen you run the `readme` command, a README will be generated (or your existing README will be upgraded) to a structure that includes section markers that looks something like this:\n\n```markdown\n\u003c!-- SHADOW_SECTION_FAQ_START --\u003e\n\n## FAQ\n\n\u003c!-- SHADOW_SECTION_FAQ_END --\u003e\n```\n\nThe area inside the START- and END comments is _dynamic_ and will be overridden for each time the `readme` command is run. This makes your README _living_, in the sense that\nSandhog can inject, remove, or even alter existing sections based on changes in your repository such as when you get new maintainers, you change your code style, your logo is updated, or something else.\n\nThe static parts of your README is anything not surrounded by those START- and END comments. These are the parts where you can write freely. Don't worry - those parts won't be overridden by Sandhog.\n\n### Readme sections\n\nThere are numerous possible README sections. You can exclude those you don't want, either via [a CLI option to the `readme` command](#the-readme-command), or via [a Sandhog config](#configuration).\nSome of those sections may only be relevant if your project is in a state that allow them.\n\n#### `toc` (Table of Contents)\n\nThe _Table of Contents_ section is auto-generated and will look at the contents of your README and generate a fully-fledged Table of Contents with relative links to the various sections of your README.\nThis gives the readers of your README an easy way of getting an overview as well as navigating your README.\n\n### `logo`\n\nThe _logo_ section is auto-generated and will appear at the very top of your README and give your readers immediate visual feedback. This section won't appear if you don't provide a logo in the [as a config option](#configuration).\n\n### `badges`\n\nThe _badges_ section is auto-generated and will appear immediately below the logo (if it has any) in your README and will vary depending on the state of your project as well as your [configuration](#configuration).\n\nThe following badges are possible:\n\n| Badge                      | Description                                                                       |\n| -------------------------- | --------------------------------------------------------------------------------- |\n| `downloads`                | The amount of times your package has been downloaded within the past month        |\n| `dependencies`             | The status of your project dependencies (e.g. whether or not they are up-to-date) |\n| `npm`                      | The published NPM version of your project                                         |\n| `contributors`             | The amount of contributors your project has                                       |\n| `license`                  | The discovered license of your project (if it has any)                            |\n| `code_style`               | Shows the discovered code style(s) of your project                                |\n| `patreon`                  | Encourages donations to you via Patreon                                           |\n| `open_collective_donate`   | Encourages donations to your project via Open Collective                          |\n| `open_collective_backers`  | Shows the amount of Open Collective backers                                       |\n| `open_collective_sponsors` | Shows the amount of Open Collective sponsors                                      |\n\n### `description_short`\n\nThe _description_short_ section is auto-generated and will show the `description` property of your `package.json` as a citation. It should be short and catchy for maximum effect.\n\n### `description_long`\n\nThe _description_long_ section is where you can explain what your project is all about. This section is completely free for you to write.\n\n### `features`\n\nThe _features_ section is where you can list some highlights of your project. This section is completely free for you to write.\n\n### `feature_image`\n\nThe _feature_image_ section is auto-generated and will only be visible if you provide a feature image [as a config option](#configuration).\nThis should preferably be a static image or even better, an animation showing your project in action.\n\n### `install`\n\nThe _install_ section is auto-generated and provides instructions on how to install your library via NPM and Yarn.\n\n### `usage`\n\nThe _usage_ section is where you can provide instructions on how to actually use your project/library/tool/framework/app. This section is completely free for you to write.\n\n### `contributing`\n\nThe _contributing_ section is auto-generated and will only appear if your project has a `CONTRIBUTING.md` file (which can be generated [via the `contributing` command](#the-contributing-command)).\nThis section will simply reference the `CONTRIBUTING.md` file so that readers know that your project is contribution-friendly.\n\n### `maintainers`\n\nThe _maintainers_ section is auto-generated and lists all of the project maintainers found in the `package.json` file (via the `author` and/or `contributors` fields) in a nice table format.\nSee [this section](#additional-metadata-for-packagejson-fields) for the full reference of the possible metadata that can be shown in this section.\n\n### `faq`\n\nThe _faq_ section is where you can address common (or anticipated) questions that have arisen or may arise in the future. This section is completely free for you to write.\n\n### `backers`\n\nThe _backers_ section is auto-generated and includes image grids of your sponsors/backers on Patreon and Open Collective. Because these grids are pure images, they require no manual maintenance\nand will immediately reflect any changes to your existing pool of backers and sponsors.\n\n### `license`\n\nThe _license_ section is auto-generated and will only appear if a license could be found within your repository. It lists the license, copyright year, and copyright holder of your project.\n\n\u003c!-- SHADOW_SECTION_CONTRIBUTING_START --\u003e\n\n## Contributing\n\nDo you want to contribute? Awesome! Please follow [these recommendations](./CONTRIBUTING.md).\n\n\u003c!-- SHADOW_SECTION_CONTRIBUTING_END --\u003e\n\n\u003c!-- SHADOW_SECTION_MAINTAINERS_START --\u003e\n\n\u003c!-- SHADOW_SECTION_MAINTAINERS_END --\u003e\n\n\u003c!-- SHADOW_SECTION_FAQ_START --\u003e\n\n### FAQ\n\n\u003c!-- SHADOW_SECTION_FAQ_END --\u003e\n\n#### Do you support custom templates?\n\nNo, Sandhog is quite opinionated about the files that are being generated and updated.\nHowever, you _can_ exclude sections and badges from the README as described [in this section](#configuration-options)\n\n#### How do you determine the Code Style of the project?\n\nBy looking for several things, including:\n\n- Your project dependencies and general fields in `package.json`\n- The configs that are being extended in your `eslint.json`/`.eslintrc` (if any such file exists) or any of its ancestors.\n- Whether or not your project has a Prettier config.\n\n\u003c!-- SHADOW_SECTION_LICENSE_START --\u003e\n\n## License\n\nMIT ©\n\n\u003c!-- SHADOW_SECTION_LICENSE_END --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwessberg%2Fsandhog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwessberg%2Fsandhog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwessberg%2Fsandhog/lists"}