# firework.js

> Firework.js v1.1.21 is firebase library, helps to write a simple and clean back-end firebase code.

Latest version **1.1.22** (published 2019-10-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install firework.js
pnpm add firework.js
yarn add firework.js
bun add firework.js
```

Provides the command `firework`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.22 |
| Published | 2019-10-31 |
| First published | 2019-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 131 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Hassan Ali |
| Maintainers | hassanali |
| Keywords | firework.js, fireworkjs, firework, firebase, firebase library |

## Links

- npm: https://www.npmjs.com/package/firework.js
- npm.io page: https://npm.io/package/firework.js

## Recent versions

- 1.1.22 (latest) — 2019-10-31
- 1.1.21 — 2019-09-26
- 1.1.2 — 2019-09-21
- 1.1.12 — 2019-09-20
- 1.1.11 — 2019-09-20
- 1.1.1 — 2019-09-20
- 1.1.0 — 2019-09-09
- 1.0.9 — 2019-08-16
- 1.0.85 — 2019-08-03
- 1.0.8 — 2019-08-03
- 1.0.75 — 2019-06-24
- 1.0.7 — 2019-06-24
- 1.0.60 — 2019-04-14
- 1.0.6 — 2019-04-14
- 1.0.5 — 2019-04-05
- … 7 more at https://npm.io/package/firework.js/versions

## README

# |>| Firework.js v1.1.21 |<|

Firework.js v1.1.21 is a Firebase Library, Helps To Write a Simple and Clean Back-End Firebase Code.

## Features
Firework.js Library Supports
- Firebase Realtime Database
- Firebase Authentication
- Firebase Storage
- Firebase Admin SDK
- Firebase Notifications System

## Installation
Use the package manager [npm](https://www.npmjs.com/) to install Firework.js.

```bash
npm i -g firework.js
```

You also can import firework library by including the script in your body tag

For production , you can use the latest optimized production version with: :
```html
<!-- production version, optimized for size and speed --> 
<script src="https://cdn.jsdelivr.net/npm/firework.js@1.1.22/js/firework.min.js"></script>
```
OR For Development, you can use the latest development version with:
```html
 <!-- development version, includes helpful console warnings --> 
<script src="https://cdn.jsdelivr.net/npm/firework.js@1.1.22/js/firework-dev.min.js"></script> 
```

***
## Install Firebase CLI and Init a Project Using Firework CLI
In order to use Firework Username Authentication System, Firebase Admin SDK features And Firework Notifications System which included with Firework.js library , you need to install Firebase CLI, Init a Project Using Firework CLI and Finally deploy to firebase: 

STEP(1) First you need to install **firebase tools** globally:
```bash
npm install -g firebase-tools
```
***
STEP(2) Then you need to login to firebase console:
```bash
firebase login
```
***
STEP(3) After that, Init a Project Using Firework CLI in your main project directory:
```bash
firework init <firebase-project-id>
```
***
STEP(4) Get Your serviceAccount.json File From Your Firebase Console ```Project Settings -> Service Accounts Tab -> Generate new private key ``` Then Paste it into ```./functions``` Directory, And Rename it to ```serviceAccount.json```, And Agree To Replace.
***
STEP(5) Final step, ```Deploy``` to your firebase console:
```bash
firebase deploy
```

> Make Sure To Secure Database Rules For Firework Admin And Username Auth Features, Go To Firebase Console And Check That Your Realtime Database Rules Be Like This:
```json
{
  "rules": {
    "$root": {
      ".read": true, // Change It As You Want
      ".write": true // Change It As You Want
    },
    // Never Change The Following Rules For Your Users Security
    "FIREWORK": {
       "Users": {
         ".read": false,
         ".write": false
       },
       "MasterDeveloperUID": {
         ".read": false,
         ".write": false
       },
       "NotificationTokens": {
         ".read": "auth !== null",
         ".write": "auth !== null",
         ".indexOn": "token"
       },
       "Notifications": {
         ".read": "auth !== null",
         ".write": "auth !== null"
       }
     }
  }
}
```

> Notice :  Notice : Don't edit the firework.js pre-built functions unless you are very familiar with them

> Notice :  Make Sure That [firebase-messaging-sw.js] and [manifest.json] Files Are Exist In Your Project Public Directory.

## Documentation 
You Can Find Our Documentation and Useful Articles At Our Website [Fireworkjs.tk](https://fireworkjs.tk) - Still Not Ready Yet -

## Conclusion.
* By Using Firework.js , you can write simple code to manage your firebase project.

* Built Based on ( Firebase 6.3.0 + JS ES6 ).

* Fully Supported In All Browers ( Doesn't Support IE Browser )

* Built By BroCoders Team (Hassan Ali) | All Rights Reserved 2019.


## License
[MIT](https://choosealicense.com/licenses/mit/)

---
_Source: https://npm.io/package/firework.js · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
