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.

Test runbook cleanup step clarified: a fully successful run must end with all test orders/products/listings/accounts removed; a failed run should be troubleshot and fixed first (keeping the test data as evidence) and only cleaned up after the issue is resolved.

Fundraiser purchase attribution cookie (5 days, first-touch): visiting a fundraiser page now saves that fundraiser, so a direct "Buy now" purchase of a wholesale product they've added credits them — even without a ?from= link. Otherwise direct sales still route through the Generous.nz Community Campaign.

Test runbook updated with a community campaign section (Step 4B): how to create and pay a direct "Buy now" order, verify the order/settlement attach to the Fund with the right commission, check referred-sale attribution and the fundraiser opt-out, and confirm the Fund is never platform-fee invoiced. Limitations now note the Fund's own live Stripe account and the Flow 3c legal sign-off as go-live steps.

Help centre updated for the latest changes: a new "Generous.nz Community Campaign" topic (direct purchases, commission to the fund, fundraiser opt-out), plus refreshed topics for multi-photo upload (Ctrl/Cmd + drag & drop, 600px resize), direct "Buy now" on wholesale products, direct-sale commission invoicing, and the referral programme (first-touch 5-day link, landing pages).

Legal documents updated for the Generous.nz Community Campaign and direct catalogue sales: Wholesaler Agreement (3.1), Fundraiser Agreement (3.1), Terms of Service (3.1), Privacy Policy (3.1), Refund Policy (3.1) and Dispute Resolution Policy (3.1). They cover direct purchases where the wholesaler remains seller of record and the commission goes to the community campaign, the fundraiser opt-out (items only shown to fundraisers who haven't opted out), and refund/dispute treatment for direct sales. The accountant/lawyer sign-off pack also gained a "Flow 3c — Direct sales" section asking for confirmation of the GST/income-tax treatment of the fund's commission income.

Direct-buy orders (community campaign listings) no longer fail when the product's image is stored as a relative /api/uploads/... path — image URLs are now made absolute before being sent to Stripe.

Generous.nz Community Campaign (Phase 1). A hidden, platform-owned campaign now powers direct purchases: wholesale product pages have a public "Buy now" button, and sales made without a fundraiser route through the fund, so the wholesaler's commission % supports the betterment of the platform while the buyer still pays the wholesaler directly (the platform never touches sale money). Visitors arriving from a fundraiser's link are still credited to that fundraiser when they've added the item. The fund is exempt from platform fees, its listings auto-sync with the wholesale catalogue, and it is hidden from explore/sitemap.
"Sell & make up to $X" on product pages is now shown only to signed-in fundraisers.
Fundraisers can opt out of community campaign items from Account settings (excludeCommunityFund), hiding them until they choose to show them.
The sign-up page shows an auto-rotating slider of sellable products with the per-sale earning figure.

The highlighted per-item figure on wholesale product pages now shows the fundraiser's share (commission % × minimum price, e.g. 25% × $30 = $7.50) labelled "Sell & make up to $X", instead of the wholesaler's take.