google-firebase.mdx

title	description	type	i18nReady
Deploy your Astro Site to Google’s Firebase Hosting	How to deploy your Astro site to the web using Google’s Firebase Hosting.	deploy	true

import { Steps } from '@astrojs/starlight/components'; import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';

Firebase Hosting is a service provided by Google’s Firebase app development platform, which can be used to deploy an Astro site.

See our separate guide for adding Firebase backend services such as databases, authentication, and storage.

Project Configuration

Your Astro project can be deployed to Firebase as a static site, or as a server-side rendered site (SSR).

Static Site

Your Astro project is a static site by default. You don’t need any extra configuration to deploy a static Astro site to Firebase.

Adapter for SSR

To enable SSR in your Astro project and deploy on Firebase add the Node.js adapter.

:::note Deploying an SSR Astro site to Firebase requires the Blaze plan or higher. :::

How to deploy

1. Install the [Firebase CLI](https://github.com/firebase/firebase-tools). This is a command-line tool that allows you to interact with Firebase from the terminal.

<PackageManagerTabs>
  <Fragment slot="npm">
  ```shell
  npm install firebase-tools
  ```
  </Fragment>
  <Fragment slot="pnpm">
  ```shell
  pnpm add firebase-tools
  ```
  </Fragment>
  <Fragment slot="yarn">
  ```shell
  yarn add firebase-tools
  ```
  </Fragment>
</PackageManagerTabs>

2. Authenticate the Firebase CLI with your Google account. This will open a browser window where you can log in to your Google account.

   ```shell npx firebase login ``` ```shell pnpm exec firebase login ``` ```shell yarn firebase login ```

3. Enable experimental web frameworks support. This is an experimental feature that allows the Firebase CLI to detect and configure your deployment settings for Astro.

   ```shell npx firebase experiments:enable webframeworks ``` ```shell pnpm exec firebase experiments:enable webframeworks ``` ```shell yarn firebase experiments:enable webframeworks ```

4. Initialize Firebase Hosting in your project. This will create a firebase.json and .firebaserc file in your project root.

   ```shell npx firebase init hosting ``` ```shell pnpm exec firebase init hosting ``` ```shell yarn firebase init hosting ```

5. Deploy your site to Firebase Hosting. This will build your Astro site and deploy it to Firebase.

   ```shell npx firebase deploy --only hosting ``` ```shell pnpm exec firebase deploy --only hosting ``` ```shell yarn firebase deploy --only hosting ```