@spectrumsense/spectrum-chat-dev/docs/QUICK_PUBLISH.md

Embeddable AI Widget - Add trusted, evidence-based answers directly to your website. Simple installation, enterprise-grade security.

# Quick Publish Reference

## 🚀 Publish Development Version

```bash
# Option 1: If you need to bump version first
npm run version:bump
npm run publish:develop

# Option 2: If version already correct
npm run publish:develop
```

**Published to**: `@spectrumsense/spectrum-chat-dev` with tag `dev`

**Use in HTML**:
```html
<!-- Latest dev version -->
<script src="https://unpkg.com/@spectrumsense/spectrum-chat-dev@latest/dist/spectrum-chat.js"></script>

<!-- Specific version -->
<script src="https://unpkg.com/@spectrumsense/spectrum-chat-dev@0.1.4-dev.0/dist/spectrum-chat.js"></script>
```

---

## 🎯 Publish Production Version

```bash
# Bump version
npm version patch  # or minor/major

# Publish
npm run publish:prod

# Push tags
git push --tags
```

**Published to**: `@spectrumsense/spectrum-chat` with tag `latest`

**Use in HTML**:
```html
<!-- Latest production version -->
<script src="https://unpkg.com/@spectrumsense/spectrum-chat@latest/dist/spectrum-chat.js"></script>

<!-- Specific version -->
<script src="https://unpkg.com/@spectrumsense/spectrum-chat@0.1.4/dist/spectrum-chat.js"></script>
```

---

## ⚠️ Common Mistakes

❌ **Don't do this:**
```bash
npm publish                    # Wrong! Won't set package name
npm run build && npm publish   # Wrong! Won't set package name
```

✅ **Do this:**
```bash
npm run publish:develop        # Correct! Handles everything
npm run publish:prod           # Correct! Handles everything
```

---

## 🔍 Verify Your Publish

After publishing, check:

1. **npm package page**: 
   - Dev: https://www.npmjs.com/package/@spectrumsense/spectrum-chat-dev
   - Prod: https://www.npmjs.com/package/@spectrumsense/spectrum-chat

2. **unpkg CDN** (may take 1-2 minutes):
   - Dev: https://unpkg.com/@spectrumsense/spectrum-chat-dev@latest/
   - Prod: https://unpkg.com/@spectrumsense/spectrum-chat@latest/

3. **File contents**:
   - Should start with: `(function (root, factory) {`
   - Should be ~55KB
   - Should NOT have strange characters at the beginning

---

## 📝 Version Format

- **Dev**: `0.1.4-dev.0`, `0.1.4-dev.1`, etc.
- **Prod**: `0.1.4`, `0.2.0`, `1.0.0`, etc.

---

See **PUBLISHING_WORKFLOW.md** for detailed guide.