FoundryApp / foundry-cli

Foundry makes the development of Firebase Functions fast by giving you an out-of-the-box working cloud environment for your development with an access to your production data. It's a CLI tool that gives you a continuous REPL-like feedback about your Firebase Functions.

Foundry - The fastest way to build Firebase CloudFunctions

• Website: https://foundryapp.co
• Docs: https://docs.foundryapp.co
• Community Slack: Join Foundry Community Slack
• Youtube channel: Foundry Youtube Channel

Foundry lets you build your Firebase Cloud Functions notably faster, with less configuration, and with easy access to your production data. Foundry consists of an open-sourced command-line tool called Foundry CLI and a pre-configured cloud environment for your development.

Watch the 5-minute video explaining Foundry

The key features of Foundry are:

• Develop with a copy of your production data: Specify what data you want to copy from your production Firestore, production RealtimeDB and production users. We copy the data and fill the emulated Firestore, emulated RealtimeDB, and Firebase Auth. No need to maintain any custom scripts. You access this data as you would normally in your Firebase functions code - with the official Admin SDK.

• Real-time feedback: You don't have to manually trigger your functions to run them, Foundry triggers them for you every time you make a change in your code and sends you back the output usually within 1-2 seconds. You just define your Cloud Functions and how you want to trigger them in the configuration file. It's like Read-Eval-Print-Loop for your Cloud Functions.

• Develop in the environment identical to the production environment: Your Firebase Cloud Functions will run in a cloud environment that is identical to the environment where your functions are deployed. This way, you won't have unexpected production bugs. You don't have to create a separate Firebase project as your staging environment. Foundry is your staging environment.

• Zero environment configuration: There isn't any configuration. Just run $ foundry init and then $ foundry go and you're ready.

• Easily test integration of your Cloud Functions: Foundry gives you an access the emulated Firestore database, emulated Realtime DB, and emulated users. You can specify with what data they should be filled with and what parts of production Firestore, productiom RealtimeDB and users data should be copied to the cloud development environment. Together with the specification of how your Cloud Functions should be triggered every time you save your code, Foundry can load and trigger your Cloud Functions in the same way as they would be triggered on the Firebase platform.

Getting Started & Documentation

Documentation is available on the Foundry website

Quick start

Installation via curl:

$ curl https://get.foundryapp.co -sSfL | sh

Installation view Brew on macOS:

$ brew tap foundryapp/foundry-cli
$ brew install foundry

Run Foundry:

$ cd <directory where is a package.json for your Firebase Functions>
$ foundry init
$ foundry go

License

Mozilla Public License v2.0