Releases: polkadot-developers/polkadot-cookbook
Release v0.7.0
Release v0.7.0
Highlights
This release focuses on improving the developer experience with better progress feedback, PAPI integration fixes, and enhanced submit workflow.
New Features
Draft Pull Requests
- The
dot submitcommand now creates draft PRs instead of regular PRs - Users are prompted to review and edit the PR description before marking it ready for review
- Clear next steps are displayed after submission
Verbose Progress Output
- Project creation now shows step-by-step progress:
- Creating project directory
- Initializing git repository
- Copying template files
- Installing dependencies
- All pathways now include a "Change to project directory" step in Next Steps
Improved PAPI Integration
- Auto-generate PAPI types before running tests
- Use
papi addfor reliable metadata fetching - Fixed transactions template to use proper PAPI descriptors
Bug Fixes
- Fixed .gitignore copying: Templates now correctly include .gitignore files in new projects
- Fixed submit command: Handle symlinks and skip node_modules during project copy
- Fixed repository references: Updated all references from paritytech to polkadot-developers
- Fixed PAPI configuration: Let
papi addcreate its own config instead of pre-creating it - Fixed node connectivity: Added retry logic for node readiness checks
Improvements
- Simplified parachain dev node startup to align with upstream template
- Removed redundant zombienet-xcm.toml configuration
- Updated getting-started documentation for auto-generated types
- Better error handling for npm install during project creation
Breaking Changes
None
Contributors
Thanks to all contributors who made this release possible!
Release v0.6.0
Release v0.6.0
Released: 2025-11-19
Changes Since v0.5.0
Version Bump: MAJOR
Changes
- fix: move XCM example to cross-chain-transactions folder (#59) (7a682c7)
- fix: move xcm-example to correct location matching documentation (#58) (e05f931)
- refactor: standardize example naming and remove pathway column from README (#57) (33ae20d)
- test: fix pathway integration and parallel test issues (#55) (924ab73)
Compatibility
This release was tested with:
- Rust: 1.91.1
- Node.js: v20.19.5
Testing
All recipes have passed CI tests.
Full manifest: manifest.yml
Status: Alpha (v0.x.x)
v0.5.0 - CLI Refactoring and CI Optimizations
What's Changed
This release includes major improvements to the CLI tool and CI workflow:
CLI Improvements
- Simplified CLI command structure for better usability
- Enhanced dependency checking with automatic installation prompts
- Improved error handling and user feedback
CI Optimizations
- Performance: Reduced pathway integration test times from 15-20 minutes to 2-3 minutes (cached)
- Smart execution: Path-based conditional execution - tests only run when relevant files change
- Caching: Runtime WASM artifact caching to avoid repeated 15+ minute builds
Testing
- Comprehensive pathway integration tests for all recipe templates:
- Basic interaction template
- Solidity template
- XCM template
- Testing infrastructure template
- Parachain/pallet template
Documentation
- Updated README with improved CLI-first workflow
- Modernized contributor documentation
- Improved recipe template documentation
Tooling Versions
- Rust: 1.91.1
- Node: v20.19.5
Full Changelog: v0.4.0...v0.5.0
Release v0.4.0
Release v0.4.0
Released: 2025-11-12
Changes Since v0.3.0
Version Bump: MAJOR
Changes
- refactor: major CLI simplification and dependency checking (#51) (c5d9a76)
- refactor: comprehensive CLI improvements and repository modernization (#50) (80ced14)
- refactor: streamline documentation and improve CLI-first workflow (#49) (50bde4e)
Compatibility
This release was tested with:
- Rust: 1.91.1
- Node.js: v20.19.5
Testing
All recipes have passed CI tests.
Full manifest: manifest.yml
Status: Alpha (v0.x.x)
Release v0.3.0
Release v0.3.0
Released: 2025-11-05
Changes Since v0.2.0
Version Bump: MAJOR
Changes
Compatibility
This release was tested with:
- Rust: 1.91.0
- Node.js: v20.19.5
Testing
All recipes have passed CI tests.
Full manifest: manifest.yml
Status: Alpha (v0.x.x)
Release v0.2.0
Release v0.2.0
Released: 2025-11-01
Changes Since v0.1.0
Version Bump: MINOR
Changes
- fix: update weekly release workflow to detect squash-merged PRs (#45) (581cf2f)
- refactor: restructure CLI command hierarchy and remove slug parameter (#44) (9d023b6)
- Rename macOS binaries for clarity (#43) (059bd12)
Compatibility
This release was tested with:
- Rust: 1.91.0
- Node.js: v20.19.5
Testing
All recipes have passed CI tests.
Full manifest: manifest.yml
Status: Alpha (v0.x.x)
Release v0.1.0
Release v0.1.0
Released: 2025-10-31
Changes Since v0.0.0
Version Bump: MINOR
Merged Pull Requests
- Merge pull request #22 from polkadot-developers/feat/cli-improvements-and-pre-commit-hooks (2a0275b)
- Merge pull request #21 from polkadot-developers/feat/rename-tutorials-to-recipes-with-frontmatter (2b3e541)
- chore: merge master and resolve conflicts (57852f3)
- Merge pull request #20 from polkadot-developers/feat/version-management (0074c8a)
- Merge remote-tracking branch 'origin/master' into feat/version-management (93dfd19)
- Merge pull request #19 from polkadot-developers/feat/cli-interactive-prompts (c2bc439)
- Merge branch 'pr-19' into feat/version-management (b98870f)
- Merge pull request #16 from polkadot-developers/refactor/cli-to-sdk-architecture (e99edf0)
- Merge pull request #9 from polkadot-developers/bruno/refactor (6ce8b74)
- Merge pull request #7 from todortodorovic/master (b586f1e)
- Merge pull request #4 from nhussein11/master (271f067)
- Merge pull request #1 from nhussein11/test-branch (c442abc)
- Merge branch 'master' of https://github.com/nhussein11/polkadot-cookbook (321c02c)
- Merge branch 'master' of https://github.com/nhussein11/polkadot-cookbook (f017edf)
- Merge branch 'master' of https://github.com/polkadot-developers/polkadot-docs-tests (e22977d)
- Merge branch 'master' of https://github.com/polkadot-developers/polkadot-docs-tests (ee00b19)
- Merge pull request #1 from polkadot-developers/dev (64aa43b)
- Update README (1a74f47)
Compatibility
This release was tested with:
- Rust: 1.91.0
- Node.js: v20.19.5
Testing
All recipes have passed CI tests.
Full manifest: manifest.yml
Status: Alpha (v0.x.x)