Flamelink JavaScript SDK
Easily integrate with your Flamelink CMS.
THIS PACKAGE IS IN BETA - Please report any issues!
This SDK is intended to be used in a browser or on a NodeJS server environment.
If you are unfamiliar with Flamelink, please visit our flamelink.io website for more info on features, pricing and more.
Prerequisites
It goes without saying that you will need to have a Flamelink project for this SDK to be of any use to you.
Apart from the Flamelink project, the only real hard dependency is either the Firebase JavaScript SDK or Firebase Admin SDK, depending on whether you use Flamelink from the browser or server. Take a look at the installation instructions on their README, but in short, just make sure you add firebase
or firebase-admin
as a dependency to your project.
Once you have firebase
installed, you can install flamelink
using any of the following options (we recommend installing with npm
or yarn
):
Installation
Install with npm
npm install --save flamelink
or with yarn
yarn add flamelink
or with a <script>
tag hosted from any of these CDN's
jsDelivr
Add the following script tag to the <body>
of your index.html file:
<script src="//cdn.jsdelivr.net/npm/flamelink/dist/flamelink.js"></script>
This will always load the latest version of this SDK for you. If you want to load a specific version, you can specify the version number as well (1.0.0 in the example):
<script src="//cdn.jsdelivr.net/npm/flamelink@1.0.0/dist/flamelink.js"></script>
See the jsDelivr website for more options
unpkg
Add the following script tag to the <body>
of your index.html file:
<script src="//unpkg.com/flamelink/dist/flamelink.js"></script>
This will always load the latest version of this SDK for you. If you want to load a specific version, you can specify the version number as well (1.0.0 in the example):
<script src="//unpkg.com/flamelink@1.0.0/dist/flamelink.js"></script>
See the unpkg website for more options
Usage
Importing/Adding the dependencies
First ensure that you load the flamelink
package to your file. When using the <script>
tag version, you will need to load both firebase
and flamelink
which will then be globally available on the browser's window
object.
Depending on your app setup, you can import the package using require()
statements:
var flamelink = require('flamelink');
or using ES2015/ES6 imports:
import flamelink from 'flamelink';
Creating your Flamelink app instance
You can either create your flamelink
app instance by passing in all the required config options that you would normally use to instantiate a firebase application:
const app = flamelink({
apiKey: '<your-api-key>',
authDomain: '<your-auth-domain>',
databaseURL: '<your-database-url>',
projectId: '<your-project-id>',
storageBucket: '<your-storage-bucket-code>',
messagingSenderId: '<your-messenger-id>',
});
?> Tip: Go to your Firebase console to find these config settings.
Or you can pass in an existing firebaseApp
instance along with all the other flamelink
config options (if using this option you need to remember to import firebase
yourself):
import * as firebase from 'firebase';
import flamelink from 'flamelink';
const firebaseConfig = {
apiKey: '<your-api-key>',
authDomain: '<your-auth-domain>',
databaseURL: '<your-database-url>',
projectId: '<your-project-id>',
storageBucket: '<your-storage-bucket-code>',
messagingSenderId: '<your-messenger-id>'
};
const firebaseApp = firebase.initializeApp(firebaseConfig);
const app = flamelink({ firebaseApp });
When using the firebase-admin
SDK on server-side, you need to specify a isAdminApp
property along with your firebaseApp
instance, like this:
const admin = require('firebase-admin');
const flamelink = require('flamelink');
const serviceAccount = require('path/to/serviceAccountKey.json');
const firebaseConfig = {
credential: admin.credential.cert(serviceAccount),
databaseURL: '<your-database-url>',
storageBucket: '<your-storage-bucket-code>',
};
const firebaseApp = admin.initializeApp(config);
const app = flamelink({ firebaseApp, isAdminApp: true });
You can use any of the different ways to create the admin firebaseApp instance, as long as you remember to set the isAdminApp: true
option.
Using your flamelink app
Once you have an instance of the flamelink
app, you can start using it to interact with your data stored in your firebase database. Suppose you want to retrieve all your products created under the "Content" section in flamelink
.
Using standard Promises:
app.content.get('products')
.then(products => console.log('All of your products:', products))
.catch(error =>
Using async-await:
const products = await app.content.get('products');
console.log('All of your products:', products);
Read our docs for more specifics!
🔥🔥🔥 Flame on!! 🔥🔥🔥