Skip to main content

Admin Panel Deployment

Firebase Hosting Setup​

The admin panel is deployed to Firebase Hosting under the acesense-prod project.

Initial Setup​

# Login to Firebase
firebase login

# Initialize hosting (already done)
firebase init hosting

Configuration​

firebase.json:

{
  "hosting": {
    "site": "acesense-admin",
    "public": "dist",
    "ignore": ["firebase.json", "**/.*", "**/node_modules/**"],
    "rewrites": [
      { "source": "**", "destination": "/index.html" }
    ],
    "headers": [
      {
        "source": "**",
        "headers": [
          { "key": "X-Robots-Tag", "value": "noindex, nofollow, noarchive" },
          { "key": "X-Frame-Options", "value": "DENY" },
          { "key": "X-Content-Type-Options", "value": "nosniff" },
          { "key": "Referrer-Policy", "value": "strict-origin-when-cross-origin" }
        ]
      }
    ]
  }
}

The admin panel is a private internal tool, so the headers block sets noindex + clickjacking/MIME protections. Deploy targets the named site acesense-admin.

.firebaserc:

{
  "projects": {
    "default": "acesense-prod"
  }
}

Deployment Steps​

1. Build Production Bundle​

cd acesense-admin
pnpm build

This type-checks (tsc -b) and creates an optimized build in the dist/ folder.

2. Deploy to Firebase​

firebase deploy --only hosting

3. Verify Deployment​

Visit: https://acesense-prod.web.app (or custom domain if configured)

Deployment Checklist​

  • Run pnpm build successfully
  • No TypeScript errors
  • Test locally with pnpm preview
  • Firestore rules deployed
  • Admin emails whitelisted
  • Deploy with firebase deploy --only hosting
  • Verify live site works
  • Test Google Sign-In

Custom Domain (Optional)​

To use a custom domain like admin.acesense.io:

  1. Go to Firebase Console → Hosting
  2. Click "Add custom domain"
  3. Follow DNS verification steps
  4. Wait for SSL certificate provisioning

CI/CD​

GitHub Actions is retired for this org (2026-08-24) — CI runs locally. Run the family sweep before every push and treat a red sweep as a red pipeline:

cd acesenseprod   # the family root
./ci-local.sh                  # every repo, every default gate
./ci-local.sh acesense-admin  # just this repo

Deploys are equally local and manual: pnpm build then firebase deploy --only hosting --project acesense-prod from the repo (or the repo's own deploy.sh where one exists). There is no deploy automation to misconfigure, and no runner holding production credentials.

Troubleshooting​

Build Fails​

  • Check for TypeScript errors: pnpm build (runs tsc -b); lint separately with pnpm lint
  • Ensure all dependencies installed: rm -rf node_modules && pnpm install

403 Forbidden​

  • User not in admin whitelist
  • Firestore rules not deployed
  • Check browser console for auth errors

Blank Page​

  • Check browser console for errors
  • Ensure Firebase config is correct
  • Verify dist/ folder exists