npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@spencerwhyte/firebase-tools

v8.0.3

Published

Command-Line Interface for Firebase

Downloads

7

Readme

Firebase CLI Actions Status Node Version NPM version

The Firebase Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Firebase project from the command line.

  • Deploy code and assets to your Firebase projects
  • Run a local web server for your Firebase Hosting site
  • Interact with data in your Firebase database
  • Import/Export users into/from Firebase Auth

To get started with the Firebase CLI, read the full list of commands below or check out the documentation.

Installation

Node Package

You can install the Firebase CLI using npm (the Node Package Manager). Note that you will need to install Node.js and npm. Installing Node.js should install npm as well.

To download and install the Firebase CLI run the following command:

npm install -g firebase-tools

This will provide you with the globally accessible firebase command.

Standalone Binary

The standalone binary distribution of the Firebase CLI allows you to download a firebase executable without any dependencies.

To download and install the CLI run the following command:

curl -sL firebase.tools | bash

Commands

The command firebase --help lists the available commands and firebase <command> --help shows more details for an individual command.

If a command is project-specific, you must either be inside a project directory with an active project alias or specify the Firebase project id with the -P <project_id> flag.

Below is a brief list of the available commands and their function:

Configuration Commands

Command | Description ------- | ----------- login | Authenticate to your Firebase account. Requires access to a web browser. logout | Sign out of the Firebase CLI. login:ci | Generate an authentication token for use in non-interactive environments. use | Set active Firebase project, manage project aliases. open | Quickly open a browser to relevant project resources. init | Setup a new Firebase project in the current directory. This command will create a firebase.json configuration file in your current directory. help | Display help information about the CLI or specific commands.

Append --no-localhost to login (i.e., firebase login --no-localhost) to copy and paste code instead of starting a local server for authentication. A use case might be if you SSH into an instance somewhere and you need to authenticate to Firebase on that machine.

Project Management Commands

Command | Description ------- | ----------- apps:create | Create a new Firebase app in a project. apps:list | List the registered apps of a Firebase project. apps:sdkconfig | Print the configuration of a Firebase app. projects:addfirebase | Add Firebase resources to a Google Cloud Platform project. projects:create | Create a new Firebase project. projects:list | Print a list of all of your Firebase projects.

Deployment and Local Emulation

These commands let you deploy and interact with your Firebase services.

Command | Description ------- | ----------- emulators:exec | Start the local Firebase emulators, run a test script, then shut down the emulators. emulators:start | Start the local Firebase emulators. deploy | Deploys your Firebase project. Relies on firebase.json configuration and your local project folder. serve | Start a local server with your Firebase Hosting configuration and HTTPS-triggered Cloud Functions. Relies on firebase.json. setup:emulators:database | Downloads the database emulator. setup:emulators:firestore | Downloads the firestore emulator.

App Distribution Commands

Command | Description ------- | ----------- appdistribution:distribute | Upload a distribution.

Auth Commands

Command | Description ------- | ----------- auth:import | Batch importing accounts into Firebase from data file. auth:export | Batch exporting accounts from Firebase into data file.

Detailed doc is here.

Realtime Database Commands

Command | Description ------- | ----------- database:get | Fetch data from the current project's database and display it as JSON. Supports querying on indexed data. database:set | Replace all data at a specified location in the current project's database. Takes input from file, STDIN, or command-line argument. database:push | Push new data to a list at a specified location in the current project's database. Takes input from file, STDIN, or command-line argument. database:remove | Delete all data at a specified location in the current project's database. database:update | Perform a partial update at a specified location in the current project's database. Takes input from file, STDIN, or command-line argument. database:profile | Profile database usage and generate a report. database:instances:create | Create a realtime database instance. database:instances:list | List realtime database instances. database:settings:get | Read the realtime database setting at path database:settings:set | Set the realtime database setting at path.

Extensions Commands

Command | Description ------- | ----------- ext | Display information on how to use ext commands and extensions installed to your project. ext:configure | Configure an existing extension instance. ext:info | Display information about an extension by name ([email protected] for a specific version) ext:install | Install an extension. ext:list | List all the extensions that are installed in your Firebase project. ext:uninstall | Uninstall an extension that is installed in your Firebase project by Instance ID. ext:update | Update an existing extension instance to the latest version.

Cloud Firestore Commands

Command | Description ------- | ----------- firestore:delete | Delete documents or collections from the current project's database. Supports recursive deletion of subcollections. firestore:indexes | List all deployed indexes from the current project.

Cloud Functions Commands

Command | Description ------- | ----------- functions:log | Read logs from deployed Cloud Functions. functions:config:set | Store runtime configuration values for the current project's Cloud Functions. functions:config:get | Retrieve existing configuration values for the current project's Cloud Functions. functions:config:unset | Remove values from the current project's runtime configuration. functions:config:clone | Copy runtime configuration from one project environment to another. functions:delete | Delete one or more Cloud Functions by name or group name. functions:shell | Locally emulate functions and start Node.js shell where these local functions can be invoked with test data.

Hosting Commands

Command | Description ------- | ----------- hosting:disable | Stop serving Firebase Hosting traffic for the active project. A "Site Not Found" message will be displayed at your project's Hosting URL after running this command.

Using with CI Systems

The Firebase CLI requires a browser to complete authentication, but is fully compatible with CI and other headless environments.

  1. On a machine with a browser, install the Firebase CLI.
  2. Run firebase login:ci to log in and print out a new refresh token (the current CLI session will not be affected).
  3. Store the output token in a secure but accessible way in your CI system.

There are two ways to use this token when running Firebase commands:

  1. Store the token as the environment variable FIREBASE_TOKEN and it will automatically be utilized.
  2. Run all commands with the --token <token> flag in your CI system.

The order of precedence for token loading is flag, environment variable, active project.

On any machine with the Firebase CLI, running firebase logout --token <token> will immediately revoke access for the specified token.

Using as a Module

The Firebase CLI can also be used programmatically as a standard Node module. Each command is exposed as a function that takes an options object and returns a Promise. For example:

var client = require('firebase-tools');
client.list().then(function(data) {
  console.log(data);
}).catch(function(err) {
  // handle error
});

client.deploy({
  project: 'myfirebase',
  token: process.env.FIREBASE_TOKEN,
  force: true,
  cwd: '/path/to/project/folder'
}).then(function() {
  console.log('Rules have been deployed!')
}).catch(function(err) {
  // handle error
});

Note: when used in a limited environment like Cloud Functions, not all firebase-tools commands will work programatically because they require access to a local filesystem.