Using Firebase with Next.js

Lee Robinson

Lee Robinson / July 19, 2019

3 min read––– views

This guide will show you how to use Firebase 9+ with Next.js and deploy it to Vercel.

Connecting to Firebase

  1. Create a project in Firebase.
  2. In the Firebase console, open Settings > Service Accounts.
  3. Click Generate New Private Key, then confirm by clicking Generate Key.
  4. Download and open the JSON file containing your service account.
  5. Create a new file .env.local and add environment variables with those values.

Create lib/firebase.js to connect to Firebase using your credentials:

import * as admin from 'firebase-admin';

if (!admin.apps.length) {
    credential: admin.credential.cert({
      projectId: process.env.NEXT_PUBLIC_FIREBASE_PROJECT_ID,
      clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
      privateKey: process.env.FIREBASE_PRIVATE_KEY.replace(/\\n/g, '\n')

const db = admin.firestore();

export { db };

Fetching Data from Firebase

We can fetch data on the server from Firebase using an API Route in Next.js. You'll need to create a new collection users and add a document leerob with a name string field if you're following this guide, but you can change that to whatever you want.

import { db } from '../../lib/firebase';

export default async function handler(req, res) {
  const user = await db.collection('users').doc('leerob').get();

  if (!user.exists) {
    return res.status(404).json({});

  return res.status(404).json({ id:, });

Let's break this down:

  1. You'll make a request to /api/users from your frontend
  2. A connection to Firestore is created using your service account
  3. The API Route queries the users collection and returns the leerob document
  4. We return the data for that document in the response

Displaying Data on the Client

First, we need to install the correct dependencies:

$ npm i swr next@latest react@rc react-dom@rc

Finally, let's make a request to our API Route on the client-side using SWR and Suspense:

import { Suspense } from 'react';
import useSWR from 'swr';

const fetcher = async (...args) => {
  const res = await fetch(...args);

  return res.json();

function Profile() {
  const { data } = useSWR('/api/user', fetcher, { suspense: true });
  return <div>Hello, {}!</div>;

export default function App() {
  return (
    <Suspense fallback={<div>Loading...</div>}>
      <Profile />

Let's break this down:

  1. When you request the root route (/) in your application, pages/index.js is rendered
  2. React suspends the rendering of the page while fetching from /api/user
  3. The fallback state (<div>Loading...</div>) is rendered while the data is being fetched
  4. After the data is fetched, the fallback state is removed and the page is re-rendered
  5. The <Profile /> component shows Hello, Lee Robinson!


Related articles:

Subscribe to the newsletter

Get emails from me about web development, tech, and early access to new articles.

- subscribers – View all issues