77 lines
1.6 KiB
Markdown
77 lines
1.6 KiB
Markdown
# Bundle Distribution Setup (For Maintainers)
|
|
|
|
**Audience:** BMAD maintainers setting up bundle auto-publishing
|
|
|
|
---
|
|
|
|
## One-Time Setup
|
|
|
|
Run these 3 commands to enable auto-publishing:
|
|
|
|
```bash
|
|
# 1. Create bmad-bundles repo
|
|
gh repo create bmad-code-org/bmad-bundles --public --description "BMAD Web Bundles"
|
|
|
|
# 2. Enable GitHub Pages
|
|
gh repo edit bmad-code-org/bmad-bundles --enable-pages --pages-branch main
|
|
|
|
# 3. Create deploy key
|
|
ssh-keygen -t ed25519 -C "github-actions" -f deploy-key -N ""
|
|
gh repo deploy-key add deploy-key.pub --repo bmad-code-org/bmad-bundles --title "CI" --allow-write
|
|
gh secret set BUNDLES_DEPLOY_KEY --repo bmad-code-org/BMAD-METHOD < deploy-key
|
|
rm deploy-key*
|
|
```
|
|
|
|
**Done.** Bundles auto-publish on every main merge.
|
|
|
|
---
|
|
|
|
## How It Works
|
|
|
|
**On main merge:**
|
|
|
|
- `.github/workflows/bundle-latest.yml` runs
|
|
- Publishes to: `https://bmad-code-org.github.io/bmad-bundles/`
|
|
|
|
**On release:**
|
|
|
|
- `npm run release:patch` runs `.github/workflows/manual-release.yaml`
|
|
- Attaches bundles to: `https://github.com/bmad-code-org/BMAD-METHOD/releases/latest`
|
|
|
|
---
|
|
|
|
## Testing
|
|
|
|
```bash
|
|
# Test latest channel
|
|
git push origin main
|
|
# Wait 2 min, then: curl https://bmad-code-org.github.io/bmad-bundles/
|
|
|
|
# Test stable channel
|
|
npm run release:patch
|
|
# Check: gh release view
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
**"Permission denied (publickey)"**
|
|
|
|
```bash
|
|
gh secret list --repo bmad-code-org/BMAD-METHOD | grep BUNDLES
|
|
```
|
|
|
|
**GitHub Pages not updating**
|
|
|
|
```bash
|
|
gh repo edit bmad-code-org/bmad-bundles --enable-pages
|
|
```
|
|
|
|
---
|
|
|
|
## Distribution URLs
|
|
|
|
**Stable:** `https://github.com/bmad-code-org/BMAD-METHOD/releases/latest`
|
|
**Latest:** `https://bmad-code-org.github.io/bmad-bundles/`
|