Home / PRE-PUBLISH-CHECKLIST

Pre-Publish Checklist

Current Change: Bundle UI Components in Core

What's Changed

  • ✅ All 130 UI components copied to @larcjs/core/components/
  • ✅ Autoloader updated to check ./components/ first
  • ✅ Sync script created (scripts/sync-components.js)
  • ✅ Build process updated to auto-sync
  • ✅ Publish hooks added (prepublishOnly)

Version Bump

  • @larcjs/core: 2.0.0 → 2.1.0 (minor)
- Feature: Bundled components for zero-config setup - Non-breaking: Existing code continues to work

Pre-Publish Steps

#### 1. Verify Build 

npm run build:all
  • [ ] Build completes successfully
  • [ ] No errors in sync process
  • [ ] Components copied (130 files)
#### 2. Run Tests 
npm run test:core
npm run test:ui
  • [ ] Core tests pass (153 tests)
  • [ ] UI tests pass (if any)
#### 3. Test Locally 
cd packages/core
python3 -m http.server 8000
# Open http://localhost:8000/test-local.html
  • [ ] Components load from ./components/
  • [ ] pan-card renders correctly
  • [ ] Autoloader works
#### 4. Review Changes 
git status
git diff packages/core/package.json
git diff packages/core/pan.mjs
  • [ ] Only intended files modified
  • [ ] No accidental changes
#### 5. Version & Publish 
# Apply version bumps
npm run changeset:version

# Review version changes
git diff

# Commit version changes
git add .
git commit -m "chore: version packages"

# Publish to npm (will auto-sync components)
npm run changeset:publish

# Push tags
git push --follow-tags

What Gets Published

@larcjs/core@3.0.1:
  • pan.mjs (autoloader)
  • pan-bus.mjs (messaging)
  • pan-client.mjs (client API)
  • pan-storage.mjs (storage)
  • components/ (130 UI components)
Result: 
<!-- This now works with zero config! -->
<script type="module" src="https://cdn.jsdelivr.net/npm/@larcjs/core@3.0.1/pan.mjs"></script>
<pan-card>Hello!</pan-card>

Rollback Plan

If something goes wrong: 

# Unpublish within 72 hours
npm unpublish @larcjs/core@3.0.1

# Or publish a patch
npm version patch
npm publish

Post-Publish Verification

# Test from CDN
curl -I https://cdn.jsdelivr.net/npm/@larcjs/core@3.0.1/pan.mjs
curl -I https://cdn.jsdelivr.net/npm/@larcjs/core@3.0.1/components/pan-card.mjs

# Test in browser
open https://cdn.jsdelivr.net/npm/@larcjs/core@3.0.1/
  • [ ] CDN serves files correctly
  • [ ] Components accessible
  • [ ] No 404 errors

Documentation Updates Needed

  • [ ] Update README with one-liner example
  • [ ] Update quickstart guide
  • [ ] Announce change (changelog, blog, etc.)

Ready to Publish?

All checkboxes above should be ✅ before running:

npm run changeset:version && npm run changeset:publish