🤖📝👷 docs, ci: add README and GitHub Actions workflows

Author: colachg

.github/workflows/ci.yml

@@ -0,0 +1,14 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: macos-26
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Build
+        run: swift build

.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: macos-26
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Generate changelog
+        uses: orhun/git-cliff-action@v4
+        id: changelog
+        with:
+          args: --latest --strip header
+
+      - name: Inject version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          plutil -replace CFBundleShortVersionString -string "$VERSION" Resources/Info.plist
+          plutil -replace CFBundleVersion -string "$VERSION" Resources/Info.plist
+
+      - name: Build release binary
+        run: swift build -c release
+
+      - name: Assemble .app bundle
+        run: |
+          APP="CloudDrop.app"
+          mkdir -p "$APP/Contents/MacOS"
+          mkdir -p "$APP/Contents/Resources"
+          cp .build/release/CloudDrop "$APP/Contents/MacOS/CloudDrop"
+          cp Resources/Info.plist "$APP/Contents/"
+          codesign --force --sign - --entitlements Resources/CloudDrop.entitlements "$APP"
+
+      - name: Create zip
+        run: ditto -c -k --keepParent CloudDrop.app CloudDrop.app.zip
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ github.ref_name }}
+          body: ${{ steps.changelog.outputs.content }}
+          files: CloudDrop.app.zip

README.md

@@ -0,0 +1,58 @@
+# CloudDrop
+
+A lightweight macOS menu bar app for uploading files to [Cloudflare R2](https://developers.cloudflare.com/r2/) storage.
+
+## Features
+
+- Lives in the menu bar — no Dock icon, always accessible
+- Upload files via file picker
+- Browse and manage files in your R2 buckets
+- Copy public URLs to clipboard with one click
+- Delete objects directly from the app
+- Auto-resolves Account ID from API token
+- Custom domain support
+- Credentials stored locally with restricted file permissions
+
+## Requirements
+
+- macOS 15+
+- Swift 6.2+
+- [just](https://github.com/casey/just) (optional, for build commands)
+
+## Build & Run
+
+```sh
+# Development build + run
+just dev
+
+# Release build + bundle into .app
+just bundle
+
+# Bundle and open
+just run
+
+# Install to /Applications
+just install
+```
+
+Or build manually:
+
+```sh
+swift build -c release
+```
+
+## Setup
+
+1. Launch CloudDrop — it appears in the menu bar
+2. Open Settings and enter your Cloudflare R2 credentials:
+   - **Access Key ID**
+   - **Secret Access Key**
+   - **API Token**
+3. Click **Verify & Save** — the app auto-resolves your Account ID and lists available buckets
+4. Select a bucket and custom domain, then start uploading
+
+Credentials can be found in the Cloudflare dashboard under **R2 > Overview > Manage R2 API Tokens**.
+
+## License
+
+MIT