Skip to content

jorisnoo/Harvie

Repository files navigation

Harvie

Harvie

A macOS app that generates Swiss QR Bills for Harvest invoices.

Download


Screenshot

Features

  • Connect to your Harvest account to fetch invoices
  • Generate Swiss QR Bills compliant with the Swiss Payment Standards
  • Automatic SCOR reference generation (Creditor Reference ISO 11649)
  • Export invoices with QR payment slip as PDF
  • Secure credential storage in macOS Keychain
  • Native macOS app built with SwiftUI

Requirements

  • macOS 14.0 (Sonoma) or later
  • Harvest account with API access

Installation

Download

Download the latest release from the Releases page.

Build from Source

git clone https://github.com/jorisnoo/Harvie.git
cd Harvie
open Harvie.xcodeproj

Build and run with Xcode 15+.

Setup

  1. Open Harvie
  2. Go to Settings
  3. Enter your Harvest credentials:
  4. Configure your creditor details (name, address, IBAN)
  5. Start generating QR Bills!

Usage

  1. Select an invoice from the list
  2. Review the QR Bill preview
  3. Click Export PDF to save the invoice with the QR payment slip

Swiss QR Bill Compliance

This app generates QR Bills according to the Swiss Payment Standards:

  • QR-IBAN or standard IBAN support
  • SCOR (Creditor Reference) format
  • Structured address format
  • CHF and EUR currencies

Development

Release Workflow

Releases are automated via GitHub Actions:

# 1. Make changes with conventional commits
git commit -m "feat: new feature"

# 2. Run Shipmark to bump version and create tag
shipmark release

# 3. Push to trigger the release workflow
git push --follow-tags

GitHub Actions will automatically:

  • Build and code sign the app
  • Create a notarised DMG
  • Publish a GitHub Release with changelog

License

MIT – see LICENSE for details.

Acknowledgments

  • Harvest for their API
  • Swiss Payment Standards for QR Bill specifications

Disclaimer

"Harvest" is a trademark of Iridesco, Inc. This project is not affiliated with or endorsed by Harvest.

This project was developed with the assistance of Claude, an AI assistant by Anthropic.

About

A macOS app that generates Swiss QR Bills for Harvest invoices.

Resources

Stars

Watchers

Forks

Contributors