1
- <p align =" center " ><a href =" https://vuefire.vuejs.org " target =" _blank " rel =" noopener noreferrer " ><img width =" 100 " src =" https://vuefire.vuejs.org/vuefire-logo.svg " alt =" VueFire logo " ></a ></p >
2
-
3
- <h1 align =" center " >Vuefire</h1 >
4
1
<p align =" center " >
5
- <a href =" https://circleci.com/gh/vuejs/vuefire " ><img src =" https://badgen.net/circleci/github/vuejs/vuefire/v3 " alt =" Build Status " ></a >
6
- <a href =" https://codecov.io/github/vuejs/vuefire " ><img src =" https://badgen.net/codecov/c/github/vuejs/vuefire/v3 " alt =" Build Status " ></a >
2
+ <a href =" https://vuefire.vuejs.org " target =" _blank " rel =" noopener noreferrer " >
3
+ <img width="100" src="https://vuefire.vuejs.org/vuefire-logo.svg" alt="VueFire logo">
4
+ </a >
5
+ </p >
6
+ <br />
7
+ <p align =" center " >
8
+ <a href =" https://npmjs.com/package/vuefire " ><img src =" https://badgen.net/npm/v/vuefire/edge " alt =" npm package " ></a >
9
+ <a href =" https://github.com/vuejs/vuefire/actions/workflows/test.yml " ><img src =" https://github.com/vuejs/vuefire/workflows/test/badge.svg?branch=main " alt =" build status " ></a >
10
+ <a href =" https://codecov.io/github/vuejs/vuefire " ><img src =" https://badgen.net/codecov/c/github/vuejs/vuefire/main " alt =" code coverage " ></a >
7
11
</p >
12
+ <br />
8
13
9
14
> Synchronize your data and Firebase Cloud Store database in real-time
10
15
11
16
- Works with Vue 2 and Vue 3
12
17
- Supports Composition API
13
- - Supports Vuex
18
+ - Supports Vuex & Pinia
19
+ - Built for Firebase 9 for optimal tree shaking
14
20
- Automatically listen for changes in nested references
15
21
16
- Note: This version currently supports Firebase 7. Support for Firebase 8 is on the way.
17
-
18
22
[ ** Documentation** ] ( https://vuefire.vuejs.org )
19
23
20
- ## Introduction
21
-
22
- Firebase provides two solutions to handle real-time databases: Realtime Database
23
- and Cloud Store (which is also a realtime database). In order to keep all
24
- clients data in-sync with its cloud database, their [ js
25
- SDK] ( https://firebase.google.com/docs/firestore/quickstart ) provides the tools
26
- to do so. However, it quickly becomes bothersome to _ bind_ multiple documents or
27
- collections to your application, keep them synchronized as well as handling
28
- [ references] ( https://firebase.google.com/docs/firestore/manage-data/data-types )
29
- to other documents or collections, which can contain references themselves and
30
- must also be kept up to date. The goal of Vuefire is to make this as simple as a
31
- function call that returns a promise so it is also easy to setup SSR and allows
32
- you to focus on developing your application.
24
+ ## Installation
33
25
34
- To better understand why Vuefire will make it so much easier to develop Vue apps
35
- with firebase, please, check [ this link in the
36
- documentation ] ( https://vuefire.vuejs.org/vuefire/#why )
26
+ ``` bash
27
+ npm install vuefire@edge
28
+ ```
37
29
38
30
## Related
39
31
@@ -44,96 +36,3 @@ documentation](https://vuefire.vuejs.org/vuefire/#why)
44
36
## License
45
37
46
38
[ MIT] ( http://opensource.org/licenses/MIT )
47
-
48
- ## Sponsors
49
-
50
- ** Help me keep working on Open Source in a sustainable way 🚀** . Help me with as little as \$ 1 a month, [ sponsor me on Github] ( https://github.com/sponsors/posva ) .
51
-
52
- <h3 align =" center " >Silver Sponsors</h3 >
53
-
54
- <p align =" center " >
55
- <a href =" https://www.vuemastery.com " title =" Vue Mastery " target =" _blank " >
56
- <img src="https://www.vuemastery.com/images/lgo-vuemastery.svg" alt="Vue Mastery logo" height="48px">
57
- </a >
58
- </p >
59
-
60
- <p align =" center " >
61
- <a href =" https://vuetifyjs.com " target =" _blank " title =" Vuetify " >
62
- <img src="https://vuejs.org/images/vuetify.png" alt="Vuetify logo" height="48px">
63
- </a >
64
- </p >
65
-
66
- <h3 align =" center " >Bronze Sponsors</h3 >
67
-
68
- <p align =" center " >
69
- <a href =" https://www.storyblok.com " target =" _blank " title =" Storyblok " >
70
- <img src="https://a.storyblok.com/f/51376/3856x824/fea44d52a9/colored-full.png" alt="Storyblok logo" height="32px">
71
- </a >
72
- </p >
73
-
74
- ---
75
-
76
- > Some awesome description
77
-
78
- Demo (TODO link)
79
-
80
- ## Copying this project
81
-
82
- You can directly create a project from this template by using the [ Use this template button] ( https://github.com/posva/vuefire-boilerplate/generate ) if you plan on hosting it on GitHub.
83
-
84
- You can also use [ degit] ( https://github.com/Rich-Harris/degit ) :
85
-
86
- ``` sh
87
- degit posva/vue-ts-lib-boilerplate
88
- ```
89
-
90
- ### Checklist of things to do when creating a lib
91
-
92
- #### Rename the project
93
-
94
- ``` sh
95
- sed -i ' ' ' s/vuefire/vue-global-events/g' README.md package.json .github/workflows/release-tag.yml size-checks/*
96
- ```
97
-
98
- #### Circle CI
99
-
100
- - Add the project: https://circleci.com/projects/gh/posva
101
- - Check _ Build on forked pull requests_ : https://circleci.com/gh/posva/vuefire/edit#advanced-settings
102
- - Check _ Auto cancel redundant build_ (same place)
103
-
104
- ## Dependabot
105
-
106
- - Activate it: https://docs.github.com/en/github/administering-a-repository/enabling-and-disabling-version-updates
107
- - Or use dependabot.com
108
-
109
- ## Github Settings
110
-
111
- - Activate Sponsor section
112
-
113
- ## Remove this section
114
-
115
- Remove the section _ Checklist_ before releasing.
116
-
117
- ## Installation
118
-
119
- ``` sh
120
- yarn add vuefire
121
- # or
122
- npm install vuefire
123
- ```
124
-
125
- ## Usage
126
-
127
- ## API
128
-
129
- ## Related
130
-
131
- ## License
132
-
133
- [ MIT] ( http://opensource.org/licenses/MIT )
134
-
135
- <div align =" right " >
136
- <sub ><em >
137
- This project was created using the <a href =" https://github.com/posva/vue-ts-lib-boilerplate " rel =" nofollow " >Vue Library boilerplate</a > by <a href =" https://github.com/posva " rel =" nofollow " >posva</a >
138
- </em ></sub >
139
- </div >
0 commit comments