Skip to main content

Changelog / Release Notes

Major updates and feature releases for Green Goods.

The format follows Keep a Changelog and Semantic Versioning.

2026​

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 (Drafts, Pending, Completed, Uploading)
  • 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 Storacha/IPFS

Changed:

  • Test setup improvements
  • Handler context patterns

🧪 Testing Infrastructure​

New E2E Test Suites (Playwright):

SuiteFocus
client.auth.spec.tsPasskey + wallet auth flows
client.navigation.spec.tsRoute guards, deep linking
client.offline-sync.spec.tsOffline queue, sync recovery
client.smoke.spec.tsCritical path validation
client.work-submission.spec.tsMDR workflow, drafts
client.work-approval.spec.tsOperator approval flow
admin.auth.spec.tsOperator authentication
admin.smoke.spec.tsDashboard functionality
performance.spec.tsLoad 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:

  • /docs/developer/releasing.md — 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/storacha-upload.js — IPFS deployment helper
  • scripts/test-e2e.js — E2E test runner with filtering

CI/CD:

  • .github/workflows/e2e-tests.yml — comprehensive E2E pipeline
  • .github/workflows/deploy-docs.yml — Docusaurus deployment
  • .github/workflows/deploy-ipfs.yml — Storacha integration
  • Shared Bun setup action

Tooling:

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

🔧 Dependencies Updated​

PackageVersion
React19.2.3
TypeScript5.9.3
Vite7.3.0
Vitest4.0.16
Playwright1.54.2
Tailwind CSS4.1.11
viem2.43.4
wagmi2.19.5

New Dependencies:

  • @storacha/client — IPFS storage
  • 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. Copy new .env.example entries (Storacha 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​

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:

Release Notes Archive​

Detailed release notes: GitHub Releases

Technical changelog: CHANGELOG.md

Subscribe to Updates​