LaraPost Docs GitHub

Maintainer Workflow

Release Playbook

Use this checklist for every stable release to keep tags, docs, and package metadata aligned.

1. Prepare

Run tests and confirm green CI baseline.
Update README, docs portal, and changelog entries.
Check `composer.json` metadata and support URLs.

composer test
composer validate --strict --no-check-lock

2. Create Release Commit

git add .
git commit -m "chore(release): prepare vX.Y.Z"

3. Tag and Push

git tag vX.Y.Z
git push origin HEAD
git push origin vX.Y.Z

4. Publish Release Notes

Create GitHub Release from the tag.
Copy key changes from `CHANGELOG.md`.
Add upgrade notes for user-facing changes.

5. Packagist Sync

If webhook is configured, Packagist updates automatically.
Otherwise trigger manual update in Packagist package dashboard.

6. Post-Release Validation

composer show prateekbhujel/larapost --all

Install in a clean Laravel app and run `php artisan larapost:install`.
Run one smoke publish flow for a real connected account.