Simple Firebase Auth

Simple Firebase authentication packages for React frontend and Cloud Functions backend.

Packages

@nearform/simple-firebase-auth-frontend

React hooks and components for Firebase authentication with Google Sign-In.

$ npm install @nearform/simple-firebase-auth-frontend

or

<script type="importmap">
  {
    "imports": {
      // ...
      "@nearform/simple-firebase-auth-frontend": "https://esm.sh/@nearform/simple-firebase-auth-frontend"
    }
  }
</script>

Frontend Documentation →

@nearform/simple-firebase-auth-backend

Fastify adapter for Firebase Cloud Functions with authentication middleware.

$ npm install @nearform/simple-firebase-auth-backend

Backend Documentation →

Quick Start

Prerequisites

You must initialize Firebase yourself. We don't call initializeApp() or admin.initializeApp().

Local Development

$ npm install
$ npm run format

Both packages support Firebase emulators:

$ firebase emulators:start

Connect frontend to emulator:

import { connectAuthEmulator } from "firebase/auth";

if (window.location.hostname === "localhost") {
  connectAuthEmulator(auth, "http://127.0.0.1:9099", { disableWarnings: true });
}

Backend works automatically with emulator when using admin.initializeApp() locally.

License

MIT