Changelog / Release Notes

Major updates and feature releases for Green Goods.

The format follows Keep a Changelog and Semantic Versioning.

Canonical changelog

The complete, auto-generated changelog lives on GitHub Releases. This page is a curated, gardener-facing summary of notable releases that links out — not a full mirror. See the release process.

---

2026

v1.2.1 - July 2026

Reliability hotfixes for the installed app

• Recovery screen — if the app can't finish starting, you now get a readable screen in your language with a Reload button, instead of a blank page.
• Passkey sign-in — enabled by default in production, rather than depending on exact configuration being present.
• Installing and updating — an app update no longer disturbs the tabs you already have open, and the app recovers on its own after a new version ships instead of showing an "Unexpected Application Error".

Full notes: GitHub Releases.

v1.2.0 - July 2026

Our most polished release yet — reliability and polish across the app, website, and operator dashboard

• Client PWA — hardened sign-in and account recovery (recover from a dismissed or expired wallet prompt); accessible wallet and cookie jar flows (see your balance, send tokens, and claim from cookie jars); a refreshed Help section in Profile; smoother installs and updates for a more mature, robust app.
• Editorial website — a new /vaults route to crowdfund the work happening in a Garden's Vault; more robust Donate and Endow flows for Gardens, with clearer ways to manage the support you give.
• Operator dashboard — a major UI polish pass across the operator cockpit (design, look, and feel); smoother navigation and operator flows for managing Gardens; polished content throughout.

Full notes: GitHub Releases.

v1.1.0 - June 2026

Vault crowdfunding and PWA reliability

• Octant yield-vault crowdfunding on /vaults (wallet endow, positions, withdraw).
• Brave / Android PWA install and update reliability improvements.
• Time-boxed IPFS uploads so stalled work-media uploads fail retryably.

Full notes: GitHub Releases.

v1.0.0 - February 18, 2026

Role-first docs and v1 capability alignment release

This release updates documentation IA and workflows to reflect current Green Goods capabilities:

• Role-first navigation (Gardener, Operator, Evaluator) plus a dedicated Developers hub.
• New activation-state model across docs:
  • Live
  • Implemented (activation pending indexing)
  • Implemented (activation pending deployment)
  • Planned
• Operator coverage for hypercert, vault, cookie-jar, strategy, and signal-pool surfaces with explicit activation gating.
• Evaluator query packs for indexer + EAS with chain-aware variable patterns.
• Developer reference consolidation under /builders, including deployment/indexer status and MCP alignment notes.
• Legacy route redirects added for prior welcome, role, developer, prd, and specs paths.

---

v0.4.0 - January 2026 🎉

First Official Release

This is the first official release of Green Goods — an offline-first platform for documenting regenerative work and proving impact on-chain.

Release Stats:

• 765 files changed
• ~42,000 lines added, ~33,000 lines removed
• 8 packages unified at version 0.4.0

---

✨ Highlights

Offline-First Architecture

• ✅ Complete offline support with IndexedDB-backed job queue
• ✅ Draft management system with local persistence
• ✅ Optimistic UI updates for work submissions and approvals
• ✅ Service worker with intelligent caching strategies
• ✅ Automatic sync when connectivity is restored

Passkey Authentication (WebAuthn)

• ✅ Pimlico passkey server integration replacing Privy
• ✅ Android and iOS WebAuthn compatibility improvements
• ✅ Unified Auth state machine (XState) consolidating all auth flows
• ✅ Wallet fallback via Reown AppKit for advanced users

Comprehensive E2E Testing

• ✅ 9 new Playwright test suites with 83% pass rate
• ✅ Client: auth, navigation, smoke, offline-sync, work-submission, work-approval
• ✅ Admin: auth, smoke
• ✅ Performance benchmarks and regression tests

---

📦 Package Changes

@green-goods/client (PWA)

Added:

• useDrafts hook — local draft persistence with IndexedDB
• OfflineIndicator component — real-time connectivity status
• DraftDialog / DraftCard — draft management UI
• View transitions API integration for smooth navigation
• Loading timeout and retry mechanism for resilient connectivity
• Debug mode functionality (?debug=true)

Changed:

• WorkDashboard — new tabbed interface (Draft, Pending, Completed)
• Login view — redesigned with passkey-first flow
• TopNav — operator-specific functionality and media upload improvements
• ImagePreviewDialog — enhanced gallery with swipe gestures
• Form components — improved accessibility with proper ARIA labels
• All card components refactored for consistency

Infrastructure:

• Vite 7.3 with React Compiler (babel-plugin-react-compiler)
• Workbox PWA with optimized caching strategies
• PostHog analytics integration

@green-goods/admin (Operator Dashboard)

Added:

• RequireOperatorOrDeployer route guard with role-based access
• Work approval UI with optimistic status updates
• Dynamic feedback indicators for pending operations

Changed:

• Action configuration sections (Details, Media, Review) — enhanced forms
• MembersModal — improved invite management
• StepIndicator — better visual feedback
• Package renamed from admin to @green-goods/admin

Removed:

• Legacy integration tests (replaced with E2E)
• URQL mock utilities (migrated to MSW)

@green-goods/shared (Common Code)

Added:

• graphql-client.ts — new GraphQL client with timeout and retry
• draft-db.ts — IndexedDB schema for draft persistence
• compression.ts — image compression utilities
• scheduler.ts — task scheduling with priorities
• analytics-events.ts — standardized event tracking
• query-keys.ts — centralized React Query key management
• domain.ts, job-queue.ts, offline.ts, temporal.d.ts — new type definitions
• useUserWithEns hook — ENS resolution for user addresses
• useAutoJoinRootGarden — automatic garden membership

Changed:

• useWorkApproval — complete rewrite with optimistic updates
• useWorkMutation — enhanced error handling and retry logic
• wallet-submission.ts — major refactor
• time.ts — expanded time utilities
• contract-errors.ts — improved error recovery patterns
• theme.css — expanded design tokens
• i18n files — 113+ new translation keys per language

Removed:

• urql.ts — replaced with custom GraphQL client
• Legacy blockchain type definitions

@green-goods/contracts (Solidity)

Changed:

• Garden.sol — enhanced access control and membership logic
• GreenGoods.sol resolver — improved validation
• WorkApproval.sol — better status tracking
• All interfaces — stricter typing and NatSpec documentation
• Modules (Hats, Octant, Unlock) — cleaner integration patterns

Infrastructure:

• Foundry test improvements
• Deploy scripts with Envio integration
• Gas optimization in hot paths

@green-goods/indexer (Envio GraphQL)

Changed:

• Package renamed from indexer to @green-goods/indexer
• Optimized queries for common access patterns
• Improved entity relationships

@green-goods/agent (Multi-Platform Bot)

Added:

• bunfig.toml — test preload configuration
• Enhanced media service with IPFS uploads

Changed:

• Test setup improvements
• Handler context patterns

---

🧪 Testing Infrastructure

New E2E Test Suites (Playwright):

Suite	Focus
client.auth.spec.ts	Passkey + wallet auth flows
client.navigation.spec.ts	Route guards, deep linking
client.offline-sync.spec.ts	Offline queue, sync recovery
client.smoke.spec.ts	Critical path validation
client.work-submission.spec.ts	MDR workflow, drafts
client.work-approval.spec.ts	Operator approval flow
admin.auth.spec.ts	Operator authentication
admin.smoke.spec.ts	Dashboard functionality
performance.spec.ts	Load times, memory, FPS

Test Documentation:

• ARCHITECTURE.md — 730-line test architecture guide
• E2E_TEST_GUIDE.md — step-by-step test writing
• TESTING_GUIDE.md — coverage targets and patterns

---

📚 Documentation

Migration: GitBook → Docusaurus 3.9

New Sections:

• /builders/deployments/releasing — release process guide
• /docs/developer/cursor-workflows.md — AI-assisted development
• /docs/developer/n8n-automation.md — workflow automation
• /docs/developer/docs-contributing.md — contribution guide
• /docs/developer/docs-deployment.md — deployment process
• /docs/developer/architecture/diagrams.md — Mermaid architecture diagrams
• /docs/evaluators/ — evaluator guides

---

🛠 Developer Experience

Dev Containers:

• Full .devcontainer/ setup with Dockerfile
• Firewall initialization script
• Post-create automation
• VS Code workspace configuration

Scripts:

• scripts/ci-local.js — local CI simulation
• scripts/fix-multiformats.js — dependency patching
• scripts/test-e2e.js — E2E test runner with filtering

CI/CD:

• .github/workflows/client.yml / .github/workflows/admin.yml — package CI with focused Playwright projects
• .github/workflows/docs.yml — trusted Docusaurus deployment
• Inline Bun setup per lane

Tooling:

• CLAUDE.md — AI assistant context
• AGENTS.md — agent orchestration guide
• .claude/registry/ — canonical skill and routing registries for AI-assisted development

---

🔧 Dependencies Updated

Package	Version
React	19.2.3
TypeScript	5.9.3
Vite	7.3.0
Vitest	4.0.16
Playwright	1.54.2
Tailwind CSS	4.1.11
viem	2.43.4
wagmi	2.19.5

New Dependencies:

• IPFS upload client — storage integration
• browser-image-compression — client-side image optimization
• posthog-js / posthog-node — analytics
• xstate / @xstate/react — state machines
• embla-carousel-react — image galleries

Removed:

• pnpm-lock.yaml — consolidated to bun.lock
• Privy dependencies — replaced with Pimlico
• @urql/core — replaced with custom client

---

📋 Migration Notes

For Developers:

1. Run bun install to update dependencies
2. Regenerate .env from .env.schema and add any new IPFS upload keys
3. Update any URQL imports to use graphql-client
4. Test passkey flows on Android devices

For Operators:

• No breaking changes to attestation schemas
• Work approval UI has new optimistic behavior
• Dashboard requires Reown AppKit wallet connection

---

🔗 Links

• Documentation: https://docs.greengoods.app
• GitHub Release: v0.4.0
• Testnet: Sepolia (chain ID: 11155111)
• Mainnets: Arbitrum One, Celo

---

2024

Q1 2024 - Initial Launch 🚀

Core Platform:

• ✅ Client PWA with offline support
• ✅ Admin dashboard for operators
• ✅ Passkey authentication (WebAuthn + Pimlico)
• ✅ MDR workflow (Media → Details → Review)
• ✅ EAS attestations for work and approvals
• ✅ Envio GraphQL indexer
• ✅ Smart contracts (Garden, Action, Resolvers)

Deployments:

• Sepolia testnet

Q2 2024 - Multi-Chain Expansion 🌍

Networks Added:

• ✅ Arbitrum One (mainnet)
• ✅ Celo (mainnet)

Features:

• ✅ Karma GAP integration (automatic impact reporting)
• ✅ Dual authentication (passkey + wallet)
• ✅ Enhanced analytics dashboards
• ✅ Multi-language support (en, es, pt)
• ✅ Real-time GraphQL subscriptions
• ✅ Export capabilities (CSV/JSON)

Improvements:

• Performance optimizations
• Mobile UX refinements
• Operator workflow enhancements

Q3 2024 - Analytics & Tooling 📊

Delivered:

• ✅ Advanced search and filtering
• ✅ Enhanced impact reports
• ✅ Garden templates

Q4 2024 - Impact Markets 💰

Delivered:

• ✅ Hypercert minting and marketplace integration
• ✅ Batch garden minting operations
• ✅ Octant yield vaults with harvest and donation flows
• ✅ Cookie Jar petty cash module
• ✅ Gardens V2 conviction voting and signal pools
• ✅ YieldSplitter (CookieJar / Fractions / Juicebox split)
• ✅ HypercertExchange marketplace adapter

---

Breaking Changes

None Yet

Green Goods maintains backward compatibility for all attestations and data structures.

Future schema changes will use version fields for graceful migration.

---

Security Updates

No CVEs Reported

Green Goods has had no security vulnerabilities reported to date.

Report security issues: security@greengoods.app (or via Telegram privately)

---

Deprecations

Privy → Pimlico Migration (Completed in v0.4.0) ✅

Old: Privy smart accounts
New: Pimlico smart accounts with Kernel

Status: Migration completed. All users seamlessly transitioned.

---

Upcoming Features

Track our roadmap:

• 📋 GitHub Projects
• 📝 GitHub Discussions
• 📣 Twitter

---

Release Notes Archive

Detailed release notes: GitHub Releases

Technical changelog: CHANGELOG.md

---

Subscribe to Updates

• 📣 Twitter
• 💬 Telegram
• 📝 Blog