Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/webhintio/hint
💡 A hinting engine for the web
https://github.com/webhintio/hint
a11y best-practices hacktoberfest hint hints interoperability lint performance pwa pwas security security-scanner webhint
Last synced: 11 days ago
JSON representation
💡 A hinting engine for the web
- Host: GitHub
- URL: https://github.com/webhintio/hint
- Owner: webhintio
- License: apache-2.0
- Created: 2017-02-16T18:15:31.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-01T04:01:18.000Z (about 1 month ago)
- Last Synced: 2024-10-19T14:38:45.871Z (20 days ago)
- Topics: a11y, best-practices, hacktoberfest, hint, hints, interoperability, lint, performance, pwa, pwas, security, security-scanner, webhint
- Language: TypeScript
- Homepage: https://webhint.io/
- Size: 75 MB
- Stars: 3,622
- Watchers: 74
- Forks: 676
- Open Issues: 455
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-repositories - webhintio/hint - 💡 A hinting engine for the web (TypeScript)
- awesome-starred - webhintio/hint - 💡 A hinting engine for the web (security)
- awesome-list - hint
README
# webhint
[](https://dev.azure.com/webhint/webhint/_build/latest?definitionId=3&branchName=main)
[](https://gitter.im/webhintio/Lobby)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fwebhintio%2Fhint?ref=badge_shield)
## Quick start user guide
webhint is a customizable linting tool that helps you improve your site's
accessibility, speed, cross-browser compatibility, and more by checking your
code for best practices and common errors.
It can be run from the command line (CLI), via a [browser extension][], and as
a [VS Code extension][].
To use it from the CLI you will need to install [`Node.js`][node]
(v14.x or later) on your machine, and you can use [`npx`][npx] to test it.
### Testing with `npx`
Run the following command:
```bash
npx hint https://example.com
```
This will analyze `https://example.com` using the default configuration.
### Installing `webhint` locally
Install webhint as a `devDependency` of your project:
```bash
npm install hint --save-dev
```
And then add a script task to your `package.json`:
```json
{
...
"scripts": {
"webhint": "hint"
}
}
```
And run it via:
```bash
npm run webhint -- http://localhost:8080
```
Or if you are using `yarn` you can skip the step to create a task and
run directly:
```bash
yarn hint http://localhost:8080
```
To know more about webhint, how to configure it, etc. see the online
[user guide][user guide], or the [local version][local user guide]
for the most recent content.
## Contributing to webhint
This project follows a monorepo pattern. That means that the code
for all the webhint flavors (CLI, browser and VS Code extension,
hints, formatters, etc.) are in here and are published as separate
npm packages.
To build the project from the source you will need to install
a recent version of node and [yarn][]. Once you've done this run
the following from the root of your cloned version:
```bash
yarn
yarn build
```
This can take a bit so please be patient.
To learn more about the internals of `webhint`, the structure of the
project, how to create new hints, parsers, formatters, etc, take
a look at the online [contributor guide][contributor guide] (or the
[local version][local contributor guide]).
### Contributing to the browser and VS Code extensions
To learn about how to build one of the extensions please check
the `CONTRIBUTING.md` files for each of these packages:
* [`packages/extension-browser/CONTRIBUTING.md`][contrib browser]
for the browser extension.
* [`packages/extension-vscode/CONTRIBUTING.md`][contrib vscode]
for the VS Code extension.
## Code of Conduct
All projects in the `webhintio` organization follow this [CoC][coc]
which adheres to the [OpenJS Foundation Code of Conduct][ojs coc].
## Other important links
* [Charter][]
* [Governance][]
## License
The code is available under the [Apache 2.0 license][license].
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fwebhintio%2Fhint?ref=badge_large)
[browser extension]: https://webhint.io/docs/user-guide/extensions/extension-browser/
[charter]: ./packages/hint/docs/about/PROJECT_CHARTER.md
[coc]: https://github.com/webhintio/.github/blob/main/CODE_OF_CONDUCT
[contrib browser]: ./packages/extension-browser/CONTRIBUTING.md
[contrib vscode]: ./packages/extension-vscode/CONTRIBUTING.md
[contributor guide]: https://webhint.io/docs/contributor-guide/
[Governance]: ./packages/hint/docs/about/GOVERNANCE.md
[license]: LICENSE.txt
[local contributor guide]: ./packages/hint/docs/contributor-guide/index.md
[local user guide]: ./packages/hint/docs/user-guide/index.md
[node]: https://nodejs.org/en/download/current/
[npx]: https://github.com/zkat/npx
[ojs coc]: https://code-of-conduct.openjsf.org/
[user guide]: https://webhint.io/docs/user-guide/
[VS Code extension]: https://webhint.io/docs/user-guide/extensions/vscode-webhint/
[yarn]: http://yarnpkg.com/