Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/co-it/ngrx-vis
Tool visualizing actions, reducers & effects in your Angular app
https://github.com/co-it/ngrx-vis
angular graph ngrx visjs
Last synced: 3 months ago
JSON representation
Tool visualizing actions, reducers & effects in your Angular app
- Host: GitHub
- URL: https://github.com/co-it/ngrx-vis
- Owner: co-IT
- License: lgpl-3.0
- Created: 2020-03-17T19:20:24.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-18T21:22:24.000Z (over 1 year ago)
- Last Synced: 2024-11-23T05:12:48.964Z (3 months ago)
- Topics: angular, graph, ngrx, visjs
- Language: TypeScript
- Homepage:
- Size: 7.54 MB
- Stars: 51
- Watchers: 8
- Forks: 2
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# NgRx Vis
> ⚙️ This package is in a very early stage.
> 🐛You are welcome to test it and report an issue if you find any bug.
NgRx Vis visualizes the journey of each action in your project.
It displays in which file an action is **created**, where it is
**dispatched** and how it is **processed** (by an effect or a reducer).
You get a documentation being always up to date.
You will be able to identify effects that are too complex.
In future we plan to provide guidance to apply best practices that are
recommended by the NgRx core-team.
## How to use
```bash
# install ngrx-vis
npm install -D ngrx-vis
```
Create a script in your package.json executing NgRx Vis.
```json
{
"scripts": {
"ngrx-vis": "ngrx-vis -p ./tsconfig.app.json"
}
}
```
```bash
# generate report and store it in ngrx-vis/
npm run ngrx-vis
```
## Options
```bash
Options:
-V, --version output the version number
-g, --glob <**/*.actions.ts> Glob for files containing actions (default: "**/*.actions.ts")
-p, --project Specify path to tsconfig
-h, --help display help for command
Example call:
$ ngrx-vis --project ./src/tsconfig.app.json
```
## FAQ
### Which versions of NgRx are supported?
You need at least NgRx 8 installed. NgRx Vis traces actions which are created
with the `createAction` helper.
### How is the graph built?
NgRx Vis does static code analysis.
It looks for action declarations, resolves all references and identifies the
usages of the respective action.
## Limitations
### Actions created at runtime
NgRx Vis is not capable of resolving actions that are created at runtime.
Currently @ngrx/data-Actions wont show up either.
In some of those cases where actions are generated based on a convention,
it would be possible to write a Resolver that generates the needed meta data
for the graph.
### 3rd Party Libraries
If a plugin for NgRx does not use vanilla NgRx actions, NgRx Vis cannot show
them out-of-the-box.
However, it is possible to write a Resolver that parses the AST for other
Action types.
## Credits
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
