Friendly Pix Web is a sample app demonstrating how to build a JavaScript/Web app with the Firebase Platform.
Friendly Pix is a place where you can share photos, follow friends, comment on photos...
To see it in action, have a look at friendly-pix.com
The Friendly Pix frontend is built using JavaScript, Firebase and jQuery.
Friendly Pix is written in ES2017 using Modules so for wide browser support the code is packed and transpiled to ES5 using Webpack.
The Auth flow is using Firebase-UI.
Javascript Runtime dependencies as well as Build and deploy dependecies are managed using npm.
Server-side micro-services are built on Cloud Functions for Firebase.
- Create a Firebase project using the Firebase Console.
- Visit the Storage section and enable storage by clicking the Getting Started button.
- Enable Google as a Sign in provider in Firebase Console > Authentication > Sign in Method tab.
- In a console run
firebase use --add
and, when prompted, select the Firebase Project you have just created. This will make sure the Firebase CLI is configured to use your particular project. - [Optional] To enable the automatic inapropriate image blurring, Enable the Cloud Vision API on your project and enable Billing.
- [Optional] To enable IP-based geolocation filters, Enable the Geolocation API and the Geocoding API on your project.
- In a console run
npm install
to install all Build/Deploy tools dependencies. - [Optional] To enable email notifications for flagged content, set your Mailgun API credentials using:
firebase functions:config:set mailgun.domain=friendly-pix.com mailgun.key=key-XXXXXXXXXXXXXXXX
On new projects, the Realtime Database and Cloud Storage come with default Security rules that prevent all read and writes. You'll need to deploy the security rules and Cloud Functions once first. For this run:
firebase deploy --only database,storage`
Please note that all Google Cloud Functions cannot yet be ran locally. You have to deploy them once first if you want these features active (such as image and text moderation). For this run:
firebase deploy --only functions
Before deploying this will automatically install all runtime dependencies, transpile the Javascript code to ES5 and install Cloud Functions dependencies. For this run:
firebase deploy
Please don't use --only hosting
Then this deploys a new version of your code that will be served from https://<PROJECT_ID>.firebaseapp.com
Please note that all Google Cloud Functions cannot yet be ran locally. You have to deploy them once first if you want these features active (such as image and text moderation).
Before you start, make sure you're using the latest versions of Java or JDK and Node.js.
To install the Firebase Emulators, use the Firebase CLI and follow the steps below.
Start the emulator using the following command. The emulator runs during all your tests. This will make sure you have all needed tools and dependecies reday before any build.
firebase emulators:start
Now that you've installed the emulator, set up tests and generate reports to validate your rules' behavior before them to production.
You can start a local development server by running:
npm run serve
This will start firebase serve
and make sure your Javascript files are transpiled automatically to ES5.
Then open http://localhost:5000
To make a user an admin - allowing him to delete any posts - manually add an entry to /admins/$index/email: [email protected]
. For instance /admins/1/email: [email protected]
.
The Android and iOS versions of FriendlyPix need the Cloud Functions, the Realtime Database rules and the Cloud Storage rules to be deployed to work properly. To deploy these run:
firebase deploy --only functions,database,storage
We'd love that you contribute to the project. Before doing so please read our Contributor guide.
© Google, 2011. Licensed under an Apache-2 license.