Community程式設計與開發github.com

THE3RDTRAINER/Homepage

部署並管理使用 Firebase App Hosting 的全端網頁應用程式(Next.js、Angular),支援伺服器端渲染(SSR)。適用於部署 Next.js/Angular 應用、設定 apphosting.yaml 或 firebase.json 中的 apphosting 區塊、管理機密、設定 GitHub CI/CD,或設定 Blaze 計費需求。不適用於傳統靜態網頁代管、Auth、Firestore、Crashlytics 或 Xcode。

Homepage 是什麼?

此技能讓 AI 代理能夠使用 Firebase App Hosting 部署和管理現代化的全端網頁應用程式,例如 Next.js 和 Angular。Firebase App Hosting 專為需要伺服器端渲染(SSR)或增量靜態生成(ISR)的全端框架而設計,提供自動化的「git push 即可部署」工作流程,並減少手動設定。使用此技能前,使用者必須確保 Firebase 專案已升級至 Blaze 計費方案。支援透過 CLI 命令手動部署原始碼,以及設定 GitHub 持續整合/持續部署(CI/CD)以實現自動化部署。此外,也包含關於 Firebase 本機模擬器的設定與測試指南。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/THE3RDTRAINER/Homepage/tree/HEAD/.agents/skills/firebase-app-hosting-basics

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

App Hosting 基礎

描述

此技能讓代理能夠使用 Firebase App Hosting 部署和管理現代化、全端網頁應用程式(Next.js、Angular 等)。

重要事項:若要使用 App Hosting,您的 Firebase 專案必須採用 Blaze 計費方案。請引導使用者前往 https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered 升級方案。

代管 vs App Hosting

當以下情況時,請選擇 Firebase 代管:

  • 您要部署靜態網站(HTML/CSS/JS)。
  • 您要部署簡單的單頁應用程式(SPA,例如 React、Vue,但無 SSR)。
  • 您希望透過 CLI 完全掌控建置與部署流程。

當以下情況時,請選擇 Firebase App Hosting:

  • 您使用支援的全端框架,例如 Next.js 或 Angular。
  • 您需要伺服器端渲染(SSR)或增量靜態生成(ISR)。
  • 您想要一個自動化、零設定的「git push 即可部署」工作流程。

部署至 App Hosting

從原始碼部署

這是大多數使用者建議的流程。

  1. 在 firebase.json 中設定 apphosting 區塊。

    {
      "apphosting": {
        "backendId": "my-app-id",
        "rootDir": "/",
        "ignore": [
          "node_modules",
          ".git",
          "firebase-debug.log",
          "firebase-debug.*.log",
          "functions"
        ]
      }
    }
    
  2. 建立或編輯 apphosting.yaml,更多資訊請參閱設定。

  3. 若應用程式需要安全存取敏感金鑰,請使用 npx -y firebase-tools@latest apphosting:secrets 命令設定並授予機密存取權。

  4. 準備部署時,執行 npx -y firebase-tools@latest deploy。

透過 GitHub 自動化部署(CI/CD)

或者,設定一個連接到 GitHub 儲存庫的後端,以實現「git push」自動化部署。此方法僅建議進階使用者使用,且並非使用 App Hosting 的必要條件。有關如何透過 CLI 命令進行設定的更多資訊,請參閱CLI 命令。

模擬

如需更多關於使用 Firebase 本機模擬器套件在本機測試應用程式的資訊,請參閱模擬。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能