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.

Branded footer on every email.

Every transactional email now ends with a Generous.nz-branded footer: the Generous.nz wordmark, the tagline "Sell. Donate. Make a difference.", links to the site, Explore, For businesses and Help, and "Made in Aotearoa New Zealand · Secure payments powered by Stripe".
The brand footer is applied automatically to both built-in emails and custom templates (and the admin template editor strips it from the editable footer so it's never duplicated).

Personal thank-you messages in automatic donation receipts.

Fundraisers can now write a personal thank-you message on the create and edit pages (with a prompt to make it personal). Every donor receives it automatically with their receipt email after a successful donation — styled as a highlighted note from the organiser.
If no message is set, the standard thank-you receipt is sent unchanged.
The donation-receipt email template now supports the {{thank_you_message}} shortcode for custom templates, and the sample preview shows how it looks.
New Fundraiser.thankYouMessage column (migration 0037_thank_you_message).

Live campaign stats with referrer/UTM tracking.

Visit tracking: every visit to a fundraiser page is recorded with the visitor, referrer and any UTM tags (utm_source/medium/campaign/content) via a privacy-friendly visitor cookie. No account needed to be tracked.
Conversion attribution: when the same visitor makes a donation or an order, their most recent visit is marked as converted — giving a real conversion rate, not a guess.
Campaign stats page (dashboard sidebar → Campaign stats): for each fundraiser, live money raised, page views (total and last 30 days), conversions and conversion rate, plus a "Which links drive support" list ranked by conversions and visits — Facebook, Instagram, WhatsApp, email or any referrer.
Tracked share links: organisers can generate and copy a share link tagged with the source (Facebook, Instagram, WhatsApp, X, Email or custom), so they can see exactly which social post is working.
New FundraiserVisit table (migration 0036_campaign_visits).

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.