mcpField
F
firebase-app-hosting-basics

firebase-app-hosting-basics

Official
github.com/firebaseCloud & DevOps491170.9k installsUpdated 1d ago
Repository

About firebase-app-hosting-basics

firebase-app-hosting-basics is a skill for agents deploying and managing full-stack web apps with Firebase App Hosting. It covers source-based and GitHub-triggered deployment, local emulator testing, and when to choose App Hosting over Firebase Hosting.

Key features

  1. 01Configure App Hosting backends
  2. 02Deploy full-stack apps from source
  3. 03Set up GitHub-based automatic deployments
  4. 04Test with the Local Emulator Suite

Use cases

  1. 01Deploy a Next.js or Angular app
  2. 02Configure hosting for an app using SSR or ISR
  3. 03Set up push-triggered deployments for a repository

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/firebase/agent-skills --skill firebase-app-hosting-basics

After installing, type/firebase-app-hosting-basicsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
cli_commands.md
configuration.md
emulation.md

Details

From the project README

App Hosting Basics

Description

This skill enables the agent to deploy and manage modern, full-stack web applications (Next.js, Angular, etc.) using Firebase App Hosting.

Important: In order to use App Hosting, your Firebase project must be on the Blaze pricing plan. Direct the user to https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered to upgrade their plan.

Hosting vs App Hosting

Choose Firebase Hosting if:

  • You are deploying a static site (HTML/CSS/JS).
  • You are deploying a simple SPA (React, Vue, etc. without SSR).
  • You want full control over the build and deploy process via CLI.

Choose Firebase App Hosting if:

  • You are using a supported full-stack framework like Next.js or Angular.
  • You need Server-Side Rendering (SSR) or ISR.
  • You want an automated "git push to deploy" workflow with zero configuration.

Deploying to App Hosting

Deploy from Source

This is the recommended flow for most users.

  1. Configure firebase.json with an apphosting block.

    {
  "apphosting": {
    "backendId": "my-app-id",
    "rootDir": "/",
    "ignore": [
      "node_modules",
      ".git",
      ".next",
      ".vercel",
      "firebase-debug.log",
      "firebase-debug.*.log",
      "functions"
    ]
  }
}

  2. Create or edit apphosting.yaml- see Configuration for more information on how to do so.

  3. Create the backend if it does not exist (apphosting:backends:list; switch --primary-region, e.g. us-east4, if a region hits its 10-backend quota):

    npx -y firebase-tools@latest apphosting:backends:create --backend my-app-id --primary-region us-central1 --root-dir /

  4. If the app needs safe access to sensitive keys, set and grant access after creating the backend:

    printf '%s' '<value>' | npx -y firebase-tools@latest apphosting:secrets:set <secret-name> --data-file - --force
npx -y firebase-tools@latest apphosting:secrets:grantaccess <secret-name> --backend my-app-id

  5. Run npx -y firebase-tools@latest deploy when you are ready to deploy.

Automated deployment via GitHub (CI/CD)

Alternatively, set up a backend connected to a GitHub repository for automated deployments "git push" deployments. This is only recommended for more advanced users, and is not required to use App Hosting. See CLI Commands for more information on how to set this up using CLI commands.

Emulation

See Emulation for more information on how to test your app locally using the Firebase Local Emulator Suite.

Comments

Markdown supported