Skip to content

Commit 100bf5e

Browse files
committed
docs: basics
1 parent 81701bb commit 100bf5e

File tree

1 file changed

+16
-117
lines changed

1 file changed

+16
-117
lines changed

README.md

+16-117
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,31 @@
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>
41
<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>
711
</p>
12+
<br/>
813

914
> Synchronize your data and Firebase Cloud Store database in real-time
1015
1116
- Works with Vue 2 and Vue 3
1217
- Supports Composition API
13-
- Supports Vuex
18+
- Supports Vuex & Pinia
19+
- Built for Firebase 9 for optimal tree shaking
1420
- Automatically listen for changes in nested references
1521

16-
Note: This version currently supports Firebase 7. Support for Firebase 8 is on the way.
17-
1822
[**Documentation**](https://vuefire.vuejs.org)
1923

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
3325

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+
```
3729

3830
## Related
3931

@@ -44,96 +36,3 @@ documentation](https://vuefire.vuejs.org/vuefire/#why)
4436
## License
4537

4638
[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

Comments
 (0)