Skip to content
TakoAPI
Back to skills

firebase-auth-setup

by guifav

Web & Frontend Development
443Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Configures Firebase Authentication — providers, security rules, custom claims, and React auth hooks.

Description

What This Skill Does

Configures Firebase Authentication in Next.js App Router projects. Sets up auth providers (Google, Apple, email/password), React hooks, middleware, and syncs Firebase users with Supabase profiles. Handles custom claims for role-based access control.

Handles the tricky Firebase-Supabase sync that most auth guides skip, including the RLS-compatible UID mapping and upsert logic.

When to Use It

  • Adding Google and Apple sign-in to a Next.js app
  • Syncing Firebase user accounts with a Supabase database
  • Setting up admin/editor/viewer roles with custom JWT claims
  • Protecting API routes with server-side token verification
  • Bootstrapping a full auth flow from scratch in a new project

Example Workflow

INPUT

User asks: set up Google and Apple sign-in with Supabase profile sync

AGENT
  1. 1

    Checks existing files in src/lib/firebase/, src/hooks/, src/middleware.ts, and .env.example

  2. 2

    Creates Firebase client and admin SDK initializers if missing

  3. 3

    Generates useAuth hook with signInWithGoogle and signInWithApple methods

  4. 4

    Creates /api/auth/sync route that verifies the Firebase token and upserts a Supabase profile

  5. 5

    Generates login page component and lists manual Firebase Console steps

OUTPUT

Auth hooks, sync API route, and login page created; user instructed to enable providers in Firebase Console and add required env vars

Requirements

  • Firebase project with Authentication enabled
  • NEXT_PUBLIC_FIREBASE_API_KEY and related Firebase client env vars
  • Firebase Admin SDK service account credentials (FIREBASE_ADMIN_PRIVATE_KEY, FIREBASE_ADMIN_CLIENT_EMAIL, FIREBASE_ADMIN_PROJECT_ID)
  • NEXT_PUBLIC_SUPABASE_URL environment variable
  • SUPABASE_SERVICE_ROLE_KEY environment variable

Installation

clawhub install guifav/firebase-auth-setup

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links