goberomsu/claude-plugins/quartz-deployer

Deploy

Overview

Automate Quartz static site deployment with integrated Eagle image pre-processing.

This skill uses bundled scripts to:

1. Prepare deployment staging with transformed Eagle images
2. Sync prepared content to Quartz
3. Build and deploy to GitHub Pages

Important: Original notes in 40. Digital Garden/ preserve Eagle file:/// paths. Only staging copies are transformed for deployment.

Prerequisites

Before using this skill, configure your environment:

1. Create `.env` file in vault root:

``bash cp .claude/skills/deploy/.env.example .env ``

1. Edit `.env` and set required variables:

• EAGLE_LIBRARY_PATH: Path to your Eagle library (e.g., /Users/username/Documents/Ataraxia.library)
• QUARTZ_REPO_PATH: Path to your Quartz repository
• DEPLOY_SITE_URL: Your site URL (e.g., https://yourdomain.com)

1. Verify the script can find your configuration:

``bash .claude/skills/deploy/scripts/deploy.sh ``

If missing variables, the script will show clear error messages.

See Configuration for all available options.

Workflow

Run Deployment Script

Execute the bundled deployment script:

.claude/skills/deploy/scripts/deploy.sh

The script automates:

1. Prepare Staging: Creates .deploy-staging/ with Eagle images transformed to /_attachments/ references
2. Content Sync: Syncs transformed content from staging to Quartz content/
3. Build: Runs npx quartz build to generate static site
4. Commit Analysis: Analyzes changes with git diff --stat
5. Auto-commit: Generates appropriate commit message and pushes to v4 branch

The script will output:

• Progress indicators for each step
• Eagle image processing results
• Final commit message
• Deployment confirmation

Source Preservation:

• Original notes in 40. Digital Garden/ keep Eagle file:/// paths
• Staging directory .deploy-staging/ is automatically cleaned up after deployment
• Eagle app continues to work with original notes

On Success: Report to user:

• Commit hash and message
• "배포 완료!" confirmation
• Site URL: ${DEPLOY_SITE_URL}

On Failure (if rollback needed):

cd "${QUARTZ_REPO_PATH}" && git revert HEAD --no-edit && git push "${DEPLOY_GIT_REMOTE}" "${DEPLOY_GIT_BRANCH}"

Configuration

All configuration is managed through environment variables in .env at vault root.

Required Variables

Optional Variables

Setup

1. Copy the example configuration:

``bash cp .claude/skills/deploy/.env.example .env ``

1. Edit .env in vault root and configure:

• EAGLE_LIBRARY_PATH: Absolute path to your Eagle library (e.g., /Users/username/Documents/Ataraxia.library)
• QUARTZ_REPO_PATH: Absolute path to your Quartz repository
• DEPLOY_SITE_URL: Your deployed site URL

1. Optional: Customise git branch/remote if your setup differs

1. Verify configuration:

``bash source .env && echo "Quartz: $QUARTZ_REPO_PATH" && echo "Site: $DEPLOY_SITE_URL" ``

Bundled Resources

Scripts

`scripts/deploy.sh`

• Main deployment orchestration script
• Calls prepare-staging.sh to create staging area
• Coordinates sync, build, and git operations
• Generates appropriate commit messages based on changes
• Provides clear progress indicators and next steps

`scripts/prepare-staging.sh`

• Creates deployment staging area at 40. Digital Garden/.deploy-staging/
• Copies content from Digital Garden to staging
• Orchestrates Eagle image processing via process-eagle-images.mjs
• Validates Eagle library path from environment

`scripts/process-eagle-images.mjs`

• Scans staging for Eagle file:/// image references
• Copies images from Eagle library to staging _attachments/
• Transforms markdown to use relative /_attachments/ paths
• Generates descriptive filenames from alt text or Eagle ID

Trigger Conditions

This skill activates when the user:

• Says "배포", "배포해줘", "deploy", "publish"
• Invokes "/deploy"
• Requests to "push to production" or "update the site"