Skip to content

Commit 0fd0708

Browse files
committed
chore: readme improvements
1 parent 2618f52 commit 0fd0708

File tree

2 files changed

+80
-1
lines changed

2 files changed

+80
-1
lines changed

packages/vue-composable/README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,13 @@
1414

1515
100% typescript based composable components and full type support out-of-box.
1616

17+
This library aim is to be one stop shop for many real-world composable functions, with aggressive tree-shaking to keep it light on your end code ([12kb gzip](https://app.circleci.com/jobs/github/pikax/vue-composable/318/parallel-runs/0/steps/0-105)).
18+
19+
[vue-composable](https://www.npmjs.com/package/vue-composable) is composed by two package [@vue-composable/core](./packages/core) and [@vue-composable/web](./packages/web).
20+
21+
- [@vue-composable/core](./packages/core): contains helpers composables, such as Promise and Pagination.
22+
- [@vue-composable/web](./packages/web): contains [Web API](https://developer.mozilla.org/en-US/docs/Web/API) implementations
23+
1724
## Installing
1825

1926
```bash
@@ -119,6 +126,16 @@ export default {
119126

120127
## Contributing
121128

129+
You can contribute raising issues and by helping out with code.
130+
131+
Tests and Documentation are the most important things for me, because good documentation is really useful!
132+
133+
I really appreciate some tweaks or changes on how the documentation is displayed and how to make it easier to read.
134+
135+
> I really need an logo for this project, if you have a good idea for a logo, please enter in contact with me, you can find me on the `Vue discord : @pikax`
136+
137+
### New composable
138+
122139
1. Fork it!
123140
2. Create your feature branch: `git checkout -b feat/new-composable`
124141
3. Commit your changes: `git commit -am 'feat(composable): add a new composable'`

readme.md

Lines changed: 63 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,17 @@
1010

1111
100% typescript based composable components and full type support out-of-box.
1212

13+
This library aim is to be one stop shop for many real-world composable functions, with aggressive tree-shaking to keep it light on your end code ([12kb gzip](https://app.circleci.com/jobs/github/pikax/vue-composable/318/parallel-runs/0/steps/0-105)).
14+
15+
[vue-composable](https://www.npmjs.com/package/vue-composable) is composed by two package [@vue-composable/core](./packages/core) and [@vue-composable/web](./packages/web).
16+
17+
- [@vue-composable/core](./packages/core): contains helpers composables, such as Promise and Pagination.
18+
- [@vue-composable/web](./packages/web): contains [Web API](https://developer.mozilla.org/en-US/docs/Web/API) implementations
19+
20+
# Vue 3
21+
22+
> ## Support for `vue@next` on [vue3 branch](https://github.com/pikax/vue-composable/tree/vue3)
23+
1324
## Installing
1425

1526
```bash
@@ -24,13 +35,64 @@ npm install @vue/composition-api vue-composable
2435

2536
Check our [documentation](https://pikax.me/vue-composable/)
2637

38+
### Composable
39+
40+
### Event
41+
42+
- [Event](https://pikax.me/vue-composable/composable/event/event) - Attach event listener to a DOM element
43+
- [Mouse Move](https://pikax.me/vue-composable/composable/event/onMoveMove) - Attach `mousemove` listener to a DOM element
44+
- [Resize](https://pikax.me/vue-composable/composable/event/onResize) - Attach `resize` listener to a DOM element
45+
- [Scroll](https://pikax.me/vue-composable/composable/event/onScroll) - Attach `scroll` listener to a DOM element
46+
47+
### MISC
48+
49+
- [localStorage](https://pikax.me/vue-composable/composable/misc/localStorage) - Reactive access to a `localStorage`
50+
- [matchMedia](https://pikax.me/vue-composable/composable/misc/matchMedia) - Reactive `matchMedia`
51+
- [breakpoint](https://pikax.me/vue-composable/composable/misc/breakpoint) - reactive `breakpoints` based on `window.innerWidth`
52+
53+
### Pagination
54+
55+
- [Pagination](https://pikax.me/vue-composable/composable/pagination/pagination) - Generic reactive pagination controls
56+
- [Array Pagination](https://pikax.me/vue-composable/composable/pagination/arrayPagination) - Array pagination
57+
58+
### Promise
59+
60+
- [Promise](https://pikax.me/vue-composable/composable/promise/promise) - `Promise` reactive resolve and reject
61+
- [Cancellable Promise](https://pikax.me/vue-composable/composable/promise/cancellablePromise) - Allow to cancel promises
62+
- [Retry](https://pikax.me/vue-composable/composable/promise/retry) - Provides functionality to retry `promise`
63+
64+
### Web
65+
66+
- [Fetch](https://pikax.me/vue-composable/composable/web/fetch) - reactive `fetch` wrapper
67+
- [WebSocket](https://pikax.me/vue-composable/composable/web/webSocket) - reactive `WebSocket` wrapper
68+
- [IntersectionObserver](https://pikax.me/vue-composable/composable/web/intersectionObserver) - reactive `IntersectionObserver`
69+
- [NetworkInformation](https://pikax.me/vue-composable/composable/web/networkInformation) - reactive `NetworkInformation` wrapper
70+
- [Online](<[composable/web](https://pikax.me/vue-composable/composable/web)/online>) - reactive `navigator.onLine` wrapper
71+
- [PageVisibility](https://pikax.me/vue-composable/composable/web/pageVisibility) - reactive `Page Visibility API`
72+
- [Language](https://pikax.me/vue-composable/composable/web/language) - reactive `NavigatorLanguage`
73+
74+
### External
75+
76+
> New packages needed
77+
78+
- [Axios](https://pikax.me/vue-composable/composable/external/axios) - [@vue-composable/axios](https://www.npmjs.com/package/@vue-composable/axios) reactive `axios` wrapper client
79+
2780
## Information
2881

2982
This is a monorepo project, please check [packages](packages/) or check [vue-composable](packages/vue-composable)
3083

31-
3284
## Contributing
3385

86+
You can contribute raising issues and by helping out with code.
87+
88+
Tests and Documentation are the most important things for me, because good documentation is really useful!
89+
90+
I really appreciate some tweaks or changes on how the documentation is displayed and how to make it easier to read.
91+
92+
> I really need an logo for this project, if you have a good idea for a logo, please enter in contact with me, you can find me on the `Vue discord : @pikax`
93+
94+
### New composable
95+
3496
1. Fork it!
3597
2. Create your feature branch: `git checkout -b feat/new-composable`
3698
3. Commit your changes: `git commit -am 'feat(composable): add a new composable'`

0 commit comments

Comments
 (0)