Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://artsy.github.io/reaction
Artsy's publishing components
https://artsy.github.io/reaction
Last synced: 9 days ago
JSON representation
Artsy's publishing components
- Host: GitHub
- URL: https://artsy.github.io/reaction
- Owner: artsy
- License: mit
- Created: 2017-02-07T21:00:51.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-12-18T16:42:51.000Z (18 days ago)
- Last Synced: 2024-12-22T18:01:12.066Z (14 days ago)
- Language: TypeScript
- Homepage:
- Size: 45.2 MB
- Stars: 356
- Watchers: 40
- Forks: 74
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-styleguides - __Artsy Force__
README
### ⚠️ All non-publishing code in this repo is deprecated and moved to artsy/force. Use this repo only for Article components!
```
::::::::: :::::::::: ::: :::::::: ::::::::::: ::::::::::: :::::::: :::: :::
:+: :+: :+: :+: :+: :+: :+: :+: :+: :+: :+: :+:+: :+:
+:+ +:+ +:+ +:+ +:+ +:+ +:+ +:+ +:+ +:+ :+:+:+ +:+
+#++:++#: +#++:++# +#++:++#++: +#+ +#+ +#+ +#+ +:+ +#+ +:+ +#+
+#+ +#+ +#+ +#+ +#+ +#+ +#+ +#+ +#+ +#+ +#+ +#+#+#
#+# #+# #+# #+# #+# #+# #+# #+# #+# #+# #+# #+# #+#+#
### ### ########## ### ### ######## ### ########### ######## ### ####
```
## Meta
- **State:** production
- **CI:** [](https://circleci.com/gh/artsy/reaction)
- **NPM:** [](https://www.npmjs.com/package/@artsy/reaction)
- **Coverage:** [](https://codecov.io/gh/artsy/reaction)
## Installation
$ git clone https://github.com/artsy/reaction.git
$ cd reaction
$ npm install -g yarn
$ yarn install
$ brew install watchman (If you don't already have Homebrew, go here for installation instructions: https://brew.sh/)
$ cp .env.oss .env
## Instructions
- Run the tests:
$ yarn test
- Run the tests continuously (or use `vscode-jest`):
$ yarn test -- --watch
- In vscode, run the `TypeScript: Run type-checker` task and open the `PROBLEMS` view to see continuous type-checker
results.
- When using new changes in metaphysics’ schema, be sure to update the local schema copy:
$ yarn sync-schema
* There are some suggested VSCode extensions in `.vscode/extensions.json` and additional docs at [docs/vscode.md](docs/vscode.md).
## Developing in Force
_Before you start, you should ensure Force is on the right branch and up-to-date._
Use yarn to kick off the force development process.
```
yarn integrate force
```
This command will build and compile reaction, publish it locally so it can be used
in other places, link it into force for you, and then start reaction and force in watch mode.
This _assumes_ force is a sibling directory of reaction. If it's not you can use the following
setup instead.
```
PROJECT_PATH=path/to/force yarn integrate
```
If you need to attach force to a debugger, use the `ENABLE_DEBUGGER` command as follows
```
ENABLE_DEBUGGER=true yarn integrate force
```
## Manual Linking and Unlinking with Force
To _link_ your local reaction with your local force, run:
$ yarn link && yarn watch
(wait until you see a message that X files have been successfully compiled before moving on)
$ cd ../force && yarn link @artsy/reaction && yarn start
To _unlink_ your local reaction from your local force, run (in **Force**):
$ yarn unlink @artsy/reaction
$ yarn add @artsy/reaction
$ yarn start
## Deployments
Reaction uses [auto-release](https://github.com/intuit/auto-release#readme) to automatically release on every PR. Every PR should have a label that matches one of the following
- Version: Trivial
- Version: Patch
- Version: Minor
- Version: Major
Peril will automatically add "Version: Patch", if you don't set one on creating your PR. No release will happen on a `Trivial` update.
If you're making a change but you don't want to immediate trigger a release (i.e. when 2 PRs need to go out together), specify the correct
version and add the `Skip Release` label. That'll ensure when the next release happens the version is still bumped appropriately.
### Publishing a Canary to NPM
Canaries are [automatically published](https://github.com/artsy/reaction/pull/3168) to NPM when creating a PR based off of a repo branch (i.e. not a fork). If you need to publish a canary of a fork you'll have to do a few manual steps:
1. Update `package.json`, set version to a canary version, e.g. `2.0.0-canary-`, `3.1.5-canary-`, ...
1. Run `npm publish --tag canary` to publish the package under the canary tag
1. Run `yarn add @artsy/reaction@canary` to install canary package
1. Running `npm dist-tag ls` can be helpful to see what tagged packages are available
## License
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fartsy%2Freaction?ref=badge_large)
## About Artsy
This project is the work of engineers at [Artsy][footer_website], the world's
leading and largest online art marketplace and platform for discovering art.
One of our core [Engineering Principles][footer_principles] is being [Open
Source by Default][footer_open] which means we strive to share as many details
of our work as possible.
You can learn more about this work from [our blog][footer_blog] and by following
[@ArtsyOpenSource][footer_twitter] or explore our public data by checking out
[our API][footer_api]. If you're interested in a career at Artsy, read through
our [job postings][footer_jobs]!
[footer_website]: https://www.artsy.net/
[footer_principles]: https://github.com/artsy/README/blob/main/culture/engineering-principles.md
[footer_open]: https://github.com/artsy/README/blob/main/culture/engineering-principles.md#open-source-by-default
[footer_blog]: https://artsy.github.io/
[footer_twitter]: https://twitter.com/ArtsyOpenSource
[footer_api]: https://developers.artsy.net/
[footer_jobs]: https://www.artsy.net/jobs