All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Released entries are left as they were written. Where a statement was true at the time and is not now — 2.2.0 describing Alfajores as the testnet, for instance — it stays, because a changelog records what shipped rather than what is currently true. The move to Celo Sepolia is its own entry under 2.4.13.
- Miniapp environment detection in the Farcaster template.
- Breaking for scripts: a flag now skips only its own prompt. Previously any
flag suppressed every prompt, so
create app -t basic --skip-installran to completion in CI; it now stops at the description question. Add-yto any invocation with no terminal attached. This restores the documented behaviour (#411).
- Bumped
nextto 15.3.6 in the chat template for GHSA-9qr9-h5gf-34mp. - Wallet status display no longer shows a hardcoded address; authentication status message corrected.
- Variable initialisation and SDK property access errors in the Farcaster template.
- Removed duplicate keys and fixed formatting across the
.env.examplefiles (#372).
- MiniPay: token reference table, a USDT transfer example, and JSDoc on
UserBalancecovering addresses and decimals.
- Alfajores replaced by Celo Sepolia throughout — templates, docs and network config.
- Contract verification moved to the Etherscan V2 API in place of Celoscan.
- thirdweb bumped to a version that includes
celoSepoliaTestnet.
- Plopfile and template paths now resolve on Windows.
- Connect-button generation.
- README rewritten around the full template set and the command options.
Covers 2.4.7 through 2.4.10, which were published without tags.
- Codebase migrated to ESM modules, with dependencies updated to match.
- ESLint config converted to ESM, then to
.json.
Covers 2.4.5 and 2.4.6. There is no v2.4.5 tag, and the 2.4.5 bump (a2e812b) is an ancestor of v2.4.6.
- Downgraded
plopandnode-plopto resolve version conflicts.
- Downgraded
chalk,inquirerandorato resolve ESM compatibility issues.
.envadded to the AI chat template's gitignore.
- AI chat template: Celo integration details and project structure.
- AI chat template, with document management and real-time streaming.
- Jest and ts-jest configured for unit testing.
- Foundry support as a contract framework.
- MiniPay template, with custom wallet integration and balance display.
- Contracts moved to
apps/, and the Git initialisation flow improved.
- MiniPay template documentation, and template references updated.
- Template generation conflict for
connect-button. moduleResolutionset tobundlerin the base template's tsconfig.
- Mintlify configuration updated; Farcaster template tag added.
- Resolved file conflict issue during project generation by removing the base
connect-button.tsx.hbsand ensuring wallet-specific templates are used.
- Updated docs config with SEO metadata and replaced favicon with new Celo logo.
- Added wallet connection and miniapp installation UI to the Farcaster template.
- Fixed runtime error "Cannot find module 'tsx/cjs'" when running published package
- Removed unnecessary tsx/cjs requirement from plop-generator
- CLI now works correctly when installed via npm/npx
- Fixed GitHub Actions pnpm lockfile issues by removing --frozen-lockfile flag
- Improved CI/CD pipeline reliability for npm deployment
- Version bump for deployment testing
- Fixed ESLint configuration for proper TypeScript support
- Resolved TypeScript linting errors and removed 'any' types
- Added proper type definitions for Plop.js data interfaces
- Updated test script to pass with no tests during development
- Complete GitHub Actions workflow for npm deployment
- CI/CD pipeline with automated testing and publishing
- Comprehensive deployment documentation
- Release automation script
- MIT License file
- Complete CLI tool for generating customizable Celo blockchain starter kits
- Support for multiple wallet providers (RainbowKit, Thirdweb)
- Hardhat smart contract development framework integration
- Modern UI with shadcn/ui components
- Monorepo structure with Turborepo
- Interactive prompts for project configuration
- Template-based project generation with Plop.js
- Support for Next.js 14+ with App Router
- TypeScript support throughout
- PNPM package manager integration
- Wallet Integration: Support for MetaMask, Trust Wallet, Valora, and in-app wallets
- Smart Contracts: Hardhat integration with Celo network configuration
- Modern UI: shadcn/ui components with responsive design
- Monorepo: Turborepo-based monorepo structure
- Developer Experience: Interactive CLI with progress indicators
- Template System: Modular template composition
- Network Support: Pre-configured for Celo mainnet and Alfajores testnet
- Node.js 18+ support
- TypeScript strict mode
- ESLint configuration
- Jest testing framework
- Commander.js for CLI framework
- Inquirer.js for interactive prompts
- Plop.js for template generation
- Tagged as
v2.2.0,v2.3.0, etc. - Published to npm with
latesttag - Full GitHub releases with changelog
- Tagged as
v2.2.0-beta.1,v2.2.0-alpha.1, etc. - Published to npm with
beta,alpha, orrctags - GitHub pre-releases for testing
# Latest stable version
npm install -g @celo/celo-composer
# Beta version
npm install -g @celo/celo-composer@beta
# Specific version
npm install -g @celo/celo-composer@2.2.0