Skip to content

CLI tool that optimizes & deploys your Firebase Functions so they run faster and have shorter cold starts.

License

Notifications You must be signed in to change notification settings

devbookhq/fireshaker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fireshaker

Fireshaker is a CLI tool that automatically optimizes & deploys your Firebase Functions.

Usually, the more Firebase Functions you have in one project the more dependencies you add. Even the Functions that are not using these dependencies have them installed in their node_modules. This slows both cold and warm starts of your functions.

Almost always more than half of the modules can be removed. Thus the functions can start proportionally faster.

Supported languages

  • TypeScript

How does Fireshaker work?

When you deploy Firebase Functions the whole functions folder gets uploaded and all the dependencies in the package.json are installed even when they are not used in the function that you have deployed.

We solve that by isolating Firebase Functions that are statically exported from the index.ts then prunning their source code and dependencies. The whole process looks like this:

  1. Build the project using the npm build script from functions package.json
  2. Extract the exported Firebase Functions triggers
  3. For every Firebase Function that will be deployed we create a temporary copy of the functions folder and do all the following steps:
  4. Delete all exports except for the exported Firebase Function that will be deployed
  5. Delete all unreachable source files
  6. Delete all unused dependencies and devDependencies
  7. Build the project again
  8. Delete the Typescript source files
  9. Deploy the Firebase Function to the current project

Are Google Cloud Functions supported?

Fireshaker currently supports only Firebase Functions. General Google Cloud Functions aren't supported right now but it's on the roadmap.

Installation

This will install Fireshaker as a CLI. Requires at least Node.js 10.

npm i -g fireshaker

Usage

Navigate to the root of your project (where is your firebase.json file) and deploy your functions the same way as you would with the Firebase CLI. Fireshaker respects your Firebase configuration.

Your Firebase functions need to be statically exported from your root index.ts file.

Deploy only specific functions

fireshaker deploy func1 func2 func3

Deploy all functions

fireshaker deploy

About

CLI tool that optimizes & deploys your Firebase Functions so they run faster and have shorter cold starts.

Topics

Resources

License

Stars

Watchers

Forks