Deploy

Skill ea-toolkit/architecture-catalog/.claude/skills/deploy

Git-native architecture catalog — Markdown registry, schema-driven UI, AI-ready

Install

npx -y skills add ea-toolkit/architecture-catalog --skill deploy

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Build and deploy static sites (catalog-ui, docs-site) to Firebase Hosting. Supports dry-run preview, selective target deployment, and automatic build detection.

SKILL.md

2.9 KB, as published. Nobody here has run it

Deploy to Firebase Hosting

Build and deploy the catalog UI and/or docs site to Firebase Hosting.

Arguments

$ARGUMENTS may contain:
- --dry-run — Build only, skip deploy. Show what would be deployed.
- --target catalog — Deploy only the catalog UI
- --target docs — Deploy only the docs site
- --target all — Deploy both (default)
- No arguments = build and deploy all targets

Workflow

1. Parse Arguments

Extract flags from $ARGUMENTS:

Check for --dry-run flag
Check for --target <value> (default: all)

2. Validate Prerequisites

Run these checks before proceeding:

# Check Firebase CLI is installed
which firebase || echo "ERROR: Firebase CLI not installed. Run: npm install -g firebase-tools"

# Check Firebase auth
firebase projects:list --limit 1 2>&1 || echo "ERROR: Not authenticated. Run: firebase login"

# Check firebase.json exists
test -f firebase.json || echo "ERROR: firebase.json not found in project root"

If any check fails, report the error and stop.

3. Build

Based on --target:

Catalog UI (target = catalog or all):

cd catalog-ui && npm ci && npm run build

Report build output size: du -sh catalog-ui/dist

Docs Site (target = docs or all):

cd docs-site && npm ci && npm run build

Report build output size: du -sh docs-site/dist

4. Deploy (skip if --dry-run)

firebase deploy --only hosting

If targeting a specific site:

firebase deploy --only hosting:catalog
# or
firebase deploy --only hosting:docs

5. Report

On dry-run:

**Dry Run Complete**

| Target | Build | Size |
|--------|-------|------|
| Catalog UI | OK | X MB |
| Docs Site | OK | X MB |

Ready to deploy. Run `/deploy` (without --dry-run) to push to Firebase.

On deploy:

**Deployed Successfully**

| Target | URL |
|--------|-----|
| Catalog UI | https://architecture-catalog.web.app |
| Docs Site | https://docs-architecture-catalog.web.app |

Firebase project: ea-toolkit-demo-ac513

Error Handling

If build fails, show the error output and stop. Do not deploy a broken build.
If deploy fails, show the Firebase error. Common fix: firebase login to re-authenticate.
If node_modules/ is missing, npm ci handles it automatically.

Notes

The CI/CD pipeline (.github/workflows/deploy.yml) auto-deploys on push to main. This skill is for manual/preview deployments.
Firebase project ID: ea-toolkit-demo-ac513 (from .firebaserc)
Hosting targets: catalog → architecture-catalog, docs → docs-architecture-catalog