Invoicey Drive
Issued invoices as files in Finder on your Mac.
Invoicey Drive is a macOS companion. The website remains where you create, issue, and cancel invoices. The Mac app is a librarian: it lists issued PDFs in Finder and can keep an optional mirror folder in sync.
macOS 14+
Invoicey Drive targets macOS 14 Sonoma and newer. It is distributed as a
notarized .dmg, not through the Mac App Store.
What you get
The default layout is {year}/{kind}_{number}. You can flatten it to {year}_{name} or {name}
under Settings → Invoicey Drive.
Drafts never appear. Cancelled invoices leave the tree. Native issued invoices appear even without a
stored pdf_url (Drive renders or persists on download). Imports without a stored PDF are omitted.
| Finder label | Invoice status |
|---|---|
| Green | Paid |
| Orange | Unpaid or not yet due |
| Red | Overdue |
Status is not in the filename. Labels are local Finder metadata — they often do not survive a copy into iCloud or Proton Drive.
Install and connect
Download the Mac app
Download Invoicey Drive from Settings → Invoicey Drive (or run the sibling invoicey-mac repo
locally). Open the .dmg and drag the app to Applications.
Open it
A menu bar extra appears. Login item is on by default so Drive comes back after a reboot.
Connect this Mac
Choose Connect Invoicey. Sign in on the website if needed, then Connect this Mac. Pairing always starts in the Mac app — Settings lists devices and can revoke them, but it does not start a new connect session.
Pick a place to see the files
Invoicey Drive appears in Finder Locations after you connect a signed build.
Set a mirror folder (iCloud, Proton Drive, or a local _faktury folder) as
an extra copy, then use Sync now.
Updates
The menu bar extra checks invoicey.app once a day and when you choose Check for
Updates…. A newer build opens the same notarized .dmg as Settings. Drag it onto
Applications; pairing and your mirror folder stay. There is no silent in-place
replace yet.
Layout tokens
| Token | Meaning |
|---|---|
{year} / {month} | From the invoice issue date |
{kind} | Localized stem (faktura, invoice, …) |
{number} | Invoice number |
{client} | Client name |
{name} | {kind}_{number} |
The template must include {number} or {name}. A slash becomes a folder. {year}_{name} is one
file, no year folder.
iCloud vs Invoicey Drive
Invoicey Drive is a Finder domain owned by Invoicey. iCloud Drive (or Proton Drive) is a folder you may choose as the optional mirror. They are not the same.
Deleting a file in Finder or in the mirror only removes the local copy; the next sync restores it. Cancel an invoice on the website to remove it from the index. A file dropped into the domain is ignored — Invoicey is the source of truth.
Revoke
Settings → Invoicey Drive → Revoke, or Sign out in the menu bar. That device token stops immediately. Connect again to pair a replacement Mac.
Troubleshooting
Local development
cd invoicey-mac
INVOICEY_DRIVE_API_URL=http://localhost:3000 swift run invoicey-drive pair
swift run invoicey-drive syncThe CLI uses a loopback callback (http://127.0.0.1:<port>/oauth). Production pairing uses
Associated Domains on invoicey.app.