Changelog

All notable changes to Generous.nz are recorded here, grouped by version. Every deployed build has a version number, a git tag, and an entry below.

Versioning scheme

Versions follow MAJOR.MINOR.PATCH:

0.x — pre-launch. Minor bumps mark a completed build phase or major feature set; patches are bug fixes on the current build.
1.0.0 — first public launch.
1.x+ — post-launch: minor = new features, patch = fixes, major = breaking changes or significant re-architecture.

Each version is tagged in git (v0.2.0) and the current version is kept in package.json. See docs/version-control.md for how to cut a release.

Order, delivery and pickup management — operations tooling.

Delivery/pickup scheduling: each order to fulfil can be given a delivery/pickup date plus tracking carrier and number. The chosen date, pickup/delivery type, offline-sale marker and tracking all show on the order.
Packing list: a printable packing view of every open order — item, quantity, options, buyer, delivery/pickup details and scheduled date, with tick-boxes, a per-item units/revenue summary, and a Print button.
Manual orders: record phone or in-person sales directly — pick the product and fundraiser, sale price, quantity, buyer details, delivery or pickup date and a note. The order is created as paid (no Stripe), the settlement is recorded so commission and platform-fee invoicing still flow, and it appears in the fundraiser's sales and the packing list.
CSV export now includes delivery/pickup date, pickup vs delivery, tracking carrier/number, and online vs offline payment, alongside all the existing fields — ready for the accountant.
New order columns (migration 0035_order_operations).

Donor-pays-fee option for fundraisers.

New Donor-pays-fee toggle on the fundraiser create and edit pages: the 5% platform fee plus card processing is added to the supporter's donation at checkout, so the organiser receives 100% of every gift and nothing is deducted from the amount raised.
When enabled, the fundraiser page shows a "Fees covered by donors" badge, and the donate form explains that fees are added on top so the full donation reaches the cause (supporters no longer see the optional "cover the fee" checkbox). Donations are charged with the fee added on automatically, including on supporter (P2P) pages.
When the option is off, the existing donor-choice "cover the fee" checkbox remains unchanged.

Full fulfilment CSV export for wholesalers.

Orders to fulfil → Download CSV: exports every order with all details — order id, date, status, product, quantity, unit/item totals, the buyer's option selections (e.g. location), buyer name and email, full delivery address with metro/rural zone and shipping charge, voucher code where applicable, platform fee/GST/wholesaler net/commission, fundraiser and its URL, settlement status, hold date, fulfilment date and failure reason. Includes a BOM so it opens cleanly in Excel/Numbers, and covers up to 5,000 orders.

One-click "Add to my store" for wholesale items.

Adding a wholesale item to a fundraiser store is now a single click: it's automatically added to your newest approved fundraiser at the minimum price (one unit). A compact fundraiser picker appears only when you have more than one eligible fundraiser, and the button shows the price and stock at a glance. After adding, it confirms with "Added to [fundraiser] ✓" and links to your listings.

XXXXX-style wholesale catalogue: clickable cards, full product pages, and product options/variations.

Full product pages (/wholesale/p/[id]): photo gallery, title, brand & business, rating, full description, options/variations, delivery and voucher details, and an "Add to my store" box — laid out like a XXXXX deal page.
Clickable cards: wholesale catalogue cards link to the product page (whole image/title/info area clickable). Explore cards link to the fundraiser or the full deal.
"More items" section on product pages: arriving from a fundraiser shows that fundraiser's other items at the bottom; a general visit shows similar deals in the same category.
Options / variations (XXXXX-style): a wholesaler can define options on a catalogue item — e.g. "Location" with Auckland, Wellington, Christchurch — marked required or optional. Buyers choose their option at checkout, and the selection appears on the wholesaler's order for fulfilment. Stored in existing metadata (no schema migration needed).

Fundraiser pages now show a "View full deal →" link on wholesale items.
Order confirmations and the wholesale orders page include the buyer's option selections.

Stores can run multiple brands from one account.

Brands on the wholesale dashboard: an approved store can now create multiple brands (organisations) from their account, or attach organisations they already manage. All brands share the same payout account — no new Stripe setup per brand.
Brand tagging: catalogue products can be assigned to a brand when added or edited. Branded products show their brand badge in the catalogue management page and the brand name on the public wholesale catalogue ("Brand · Fulfilled by business").
New WholesalerOrganisation join table and WholesaleProduct.organisationId (migration 0034_wholesale_brands). A brand can belong to only one store.

Wholesaler applications now also reject organisations that are already a brand on another store.

Image upload buttons added to the remaining link-only forms.

Blog posts: the cover image field now has an Upload button (best at 1200×675, 16:9).
Organisation settings: both the logo and cover image fields now have Upload buttons (logo ~400×400 square; cover ~1600×700 wide banner).
All uploads run through the existing pipeline: auto-rotated, resized (max 1600px long edge), compressed (quality 80), and sent to Bunny Storage automatically when configured (otherwise stored on the server).

Help hints when adding products, including clear image-size guidance.

Image hints on every product form:
- Product listings and wholesale catalogue items: square photos look best (e.g. 800×800), uploaded images are auto-resized so any size works, files up to 5 MB, and the first image is the main photo.
- Fundraiser covers: aim for a wide 1600×700 (16:7) banner; uploads are auto-resized.
Small guidance hints on titles, prices and descriptions so sellers know what to enter.
The wholesale catalogue form now has an Upload photo button (it only accepted pasted URLs before), matching the other forms.