release-app

Instructions

When the user invokes this skill with an app path:

1. •

   Extract version from filename

   • •The app filename format is Caffee-v{VERSION}.app (e.g., Caffee-v1.18.0.app)
   • •Extract the version string including the 'v' prefix (e.g., v1.18.0)
   • •Also extract just the number part for display (e.g., 1.18.0)
2. •

   Verify the app exists

   • •Check if the provided app path exists
   • •If not, report error and stop
3. •

   Rename app to Caffee.app

   • •Copy/rename the app to Caffee.app in the same directory
   • •This ensures consistent naming when users install the app
   • •Example: cp -R ~/Documents/Caffee-v1.18.0 ~/Documents/Caffee.app
4. •

   Create DMG

   • •Run: create-dmg Caffee.app . (use the renamed Caffee.app) (use which for get path)
   • •This creates a DMG in the current directory
   • •Rename the output to Caffee-{VERSION}.dmg (e.g., Caffee-v1.18.0.dmg)
   • •Clean up: remove the temporary Caffee.app copy
5. •

   Sign the DMG

   • •Run: sign_update Caffee-{VERSION}.dmg (use which for get path)
   • •Capture the output which contains:
     • •sparkle:edSignature="..."
     • •length="..."
   • •Parse and extract the signature and file size
6. •

   Get file size and checksum

   • •Get file size: stat -f%z Caffee-{VERSION}.dmg
   • •Get SHA256 checksum: shasum -a 256 Caffee-{VERSION}.dmg
7. •

   Update web/appcast.xml

   • •Add a new <item> element at the top of the channel (before existing items)
   • •Use current date in RFC 2822 format for pubDate
   • •The download URL format: https://github.com/khanhicetea/Caffee/releases/download/{VERSION}/Caffee-{VERSION}.dmg
   • •Include the signature and length from sign_update output
   • •If release notes provided, use them; otherwise generate from git log since previous version
   • •the sparkle:version should be integer, e.g., 11901 (1.19.1 => 110000 + 19100 + 1)
8. •

   Update web/index.html

   • •Update the download button version text and link
   • •Add new release notes entry in the Release Notes section with checksum
   • •Release notes (changelogs) translate into Vietnamese
9. •

   Update web/download.html

   • •Update the meta refresh URL to point to the new DMG release
   • •Update the direct download link in the body
   • •URL format: https://github.com/khanhicetea/Caffee/releases/download/{VERSION}/Caffee-{VERSION}.dmg
10. •

    Summary

• •Show summary of what was done
• •Show the DMG path for upload to GitHub
• •Remind user to:
  • •Upload DMG to GitHub releases at the tag {VERSION}
  • •Deploy updated web files

Example appcast.xml item format

<item>
  <title>Version 1.18.0</title>
  <sparkle:version>1</sparkle:version>
  <sparkle:shortVersionString>1.18.0</sparkle:shortVersionString>
  <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
  <pubDate>Thu, 30 Jan 2026 12:00:00 +0700</pubDate>
  <enclosure
    url="https://github.com/khanhicetea/Caffee/releases/download/v1.18.0/Caffee-v1.18.0.dmg"
    sparkle:edSignature="SIGNATURE_HERE"
    length="12345678"
    type="application/octet-stream"
  />
  <description><![CDATA[
    <h2>What's New</h2>
    <ul>
      <li>Release notes here</li>
    </ul>
  ]]></description>
</item>

Example index.html updates

Download button (around line 64):

<button class="secondary" onclick="location.href='/download.html?v=1.18.0'">
    Tải app tại đây (v1.18.0)
</button>

Release notes section (after line 240):

<div>
    <h5>v1.18.0</h5>
    <ul>
        <li>Checksum sha256 (Caffee-v1.18.0.dmg) :
            <code>CHECKSUM_HERE</code>
        </li>
        <li>Release notes here</li>
    </ul>
    <hr />
</div>

Example download.html updates

Meta refresh tag (line 9):

<meta
    http-equiv="refresh"
    content="2; URL=https://github.com/khanhicetea/Caffee/releases/download/v1.18.0/Caffee-v1.18.0.dmg"
/>

Direct download link (line 24):

<a
    href="https://github.com/khanhicetea/Caffee/releases/download/v1.18.0/Caffee-v1.18.0.dmg"
    >bấm vào đây để tải ngay</a
>