Firebase Hosting delivers your docmd static site over a global CDN with SSL included. It works well for teams already using the Firebase ecosystem, and integrates cleanly into CI/CD pipelines via the Firebase CLI or GitHub Actions.

Prerequisites

Install the Firebase CLI:

npm install -g firebase-tools
firebase login

Setup

1. Build your site:

   docmd build
   

2. Initialise Firebase Hosting in your project root:

   firebase init hosting
   

   When prompted:

   • Select your Firebase project (or create a new one).
   • Set the public directory to site.
   • Configure as a single-page app: No (docmd generates individual index.html files per page — no catch-all rewrite needed).
   • Do not overwrite site/index.html.

3. Deploy:

   firebase deploy --only hosting
   

CI/CD with GitHub Actions

To deploy automatically on every push, create .github/workflows/firebase.yml:

name: Deploy to Firebase Hosting

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - run: npm install
      - run: npx @docmd/core build
      - uses: FirebaseExtended/action-hosting-deploy@v0
        with:
          repoToken: ${{ secrets.GITHUB_TOKEN }}
          firebaseServiceAccount: ${{ secrets.FIREBASE_SERVICE_ACCOUNT }}
          channelId: live

Set FIREBASE_SERVICE_ACCOUNT in your repository’s Settings → Secrets using a Firebase service account JSON key.

Custom Domain

Add a custom domain in the Firebase Console under Hosting → Add custom domain. Firebase provisions SSL automatically.

Set the url field in docmd.config.json to match your domain so that canonical tags and sitemaps generate correct absolute URLs.