Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shopify/web-configs
Common configurations for building web apps at Shopify
https://github.com/shopify/web-configs
babel configs eslint prettier react react-native shopify stylelint typescript web
Last synced: about 5 hours ago
JSON representation
Common configurations for building web apps at Shopify
- Host: GitHub
- URL: https://github.com/shopify/web-configs
- Owner: Shopify
- License: mit
- Created: 2017-08-01T21:52:18.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-03-04T10:13:59.000Z (7 months ago)
- Last Synced: 2024-04-14T22:22:00.558Z (5 months ago)
- Topics: babel, configs, eslint, prettier, react, react-native, shopify, stylelint, typescript, web
- Language: JavaScript
- Homepage:
- Size: 5.33 MB
- Stars: 457
- Watchers: 404
- Forks: 55
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[comment]: # 'NOTE: This file is generated and should not be modify directly. Update `templates/ROOT_README.hbs.md` instead'
# Web Configs
[](LICENSE.md)
This repository contains common configurations for building web apps at Shopify.
## Usage
This repo is managed as a monorepo that is composed of many npm packages, where each package has its own `README` and documentation describing usage.
### Package Index
| Name | NPM | Size |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [babel-preset](packages/babel-preset) | [](https://badge.fury.io/js/%40shopify%2Fbabel-preset) | [](https://img.shields.io/bundlephobia/minzip/@shopify/babel-preset.svg) |
| [browserslist-config](packages/browserslist-config) | [](https://badge.fury.io/js/%40shopify%2Fbrowserslist-config) | [](https://img.shields.io/bundlephobia/minzip/@shopify/browserslist-config.svg) |
| [eslint-plugin](packages/eslint-plugin) | [](https://badge.fury.io/js/%40shopify%2Feslint-plugin) | [](https://img.shields.io/bundlephobia/minzip/@shopify/eslint-plugin.svg) |
| [images](packages/images) | [](https://badge.fury.io/js/%40shopify%2Fimages) | [](https://img.shields.io/bundlephobia/minzip/@shopify/images.svg) |
| [postcss-plugin](packages/postcss-plugin) | [](https://badge.fury.io/js/%40shopify%2Fpostcss-plugin) | [](https://img.shields.io/bundlephobia/minzip/@shopify/postcss-plugin.svg) |
| [prettier-config](packages/prettier-config) | [](https://badge.fury.io/js/%40shopify%2Fprettier-config) | [](https://img.shields.io/bundlephobia/minzip/@shopify/prettier-config.svg) |
| [stylelint-plugin](packages/stylelint-plugin) | [](https://badge.fury.io/js/%40shopify%2Fstylelint-plugin) | [](https://img.shields.io/bundlephobia/minzip/@shopify/stylelint-plugin.svg) |
| [typescript-configs](packages/typescript-configs) | [](https://badge.fury.io/js/%40shopify%2Ftypescript-configs) | [](https://img.shields.io/bundlephobia/minzip/@shopify/typescript-configs.svg) |
## Contribution
This repository has a CLA-Bot running which will ask contributors to sign a Contributor License Agreement (CLA).
Shopify has also adopted a Code of Conduct that we expect contributors to adhere to. Please read the [full text](./CODE_OF_CONDUCT.md) so that you can understand what actions will and will not be tolerated.
### Ways to contribute
There are many ways to contribute, some of which are:
- Filing [bug reports](https://github.com/Shopify/web-configs/issues/new?template=BUG_REPORT.md)
- Requesting new features or packages via [an issue](https://github.com/Shopify/web-configs/issues/new/choose)
- Improving the existing codebase by picking up an issue, improving tests, or furthering documentation
### Development
#### Getting Started
```bash
# Shopify Employee
dev clone web-configs
dev up
# External Contributor - To start working on the codebase, first fork the repo, then clone it
git clone [email protected]:{your-username}/web-configs.git # replace {your-username} with your GitHub handle
yarn # install project dependencies
```
##### What is `dev`?
`dev` is a tool to standardize a small set of common tasks across all projects at Shopify. If you're wondering how to execute the dev commands as an external contributor, you can see where they are defined in this project's `dev.yml` file.
#### Testing your changes in a local project
To try out your changes in another locally cloned project, you can use `yarn tophat `. Using this command rather than `yarn link` will set up a watcher let you make changes without needing to rerun any commands.
Example: To test my changes to `@shopify/react-form-state` in my local project named `my-project`, I would run `yarn tophat react-form-state ../path/to/my-project`.
More usage instructions on the `tophat` command can be [found here](https://github.com/Shopify/tophat-web).
#### Documentation
If your change affects the public API of any packages within this repository (i.e. adding or changing arguments to a function, adding a new function, changing the return value, etc), please ensure the documentation is updated, and a changelog is added to reflect this. Documentation is in the `README.md` files of each package. If further documentation is needed please communicate via a GitHub issue.
#### Testing
The packages in this repository are used in mission-critical production scenarios. As such, we do not merge any untested code.
To run the full test suite, simply run `dev test` or `yarn test`.
### Releasing
The release process currently involves some manual steps to complete. Once your PR has been merged, our team will orchestrate when to cut a new release.
**Note** Version numbers in `package.json` files should never be altered manually. This will be done via scripts as part of the release process.
## License
MIT © [Shopify](https://shopify.com/), see [LICENSE.md](LICENSE.md) for details.