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

xml
1<item>
2  <title>Version 1.18.0</title>
3  <sparkle:version>1</sparkle:version>
4  <sparkle:shortVersionString>1.18.0</sparkle:shortVersionString>
5  <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
6  <pubDate>Thu, 30 Jan 2026 12:00:00 +0700</pubDate>
7  <enclosure
8    url="https://github.com/khanhicetea/Caffee/releases/download/v1.18.0/Caffee-v1.18.0.dmg"
9    sparkle:edSignature="SIGNATURE_HERE"
10    length="12345678"
11    type="application/octet-stream"
12  />
13  <description><![CDATA[
14    <h2>What's New</h2>
15    <ul>
16      <li>Release notes here</li>
17    </ul>
18  ]]></description>
19</item>

Example index.html updates

Download button (around line 64):

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

Release notes section (after line 240):

html
1<div>
2    <h5>v1.18.0</h5>
3    <ul>
4        <li>Checksum sha256 (Caffee-v1.18.0.dmg) :
5            <code>CHECKSUM_HERE</code>
6        </li>
7        <li>Release notes here</li>
8    </ul>
9    <hr />
10</div>

Example download.html updates

Meta refresh tag (line 9):

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

Direct download link (line 24):

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