@hef2024/llmasaservice-ui 0.16.8 → 0.16.9

package/DEPLOYMENT.md

@@ -0,0 +1,193 @@
+# 📦 Deployment Guide
+
+## Current Status
+- ✅ Build successful (version 0.16.8)
+- ✅ Tests passing (17 tests passed)
+- ✅ Ready to publish
+
+---
+
+## Step 1: Login to npm
+
+**Important:** You need to be logged in as the owner of the `@hef2024` scope.
+
+```bash
+npm login
+```
+
+You'll be prompted for:
+- Username (must be the owner of @hef2024 scope)
+- Password
+- Email
+- OTP (if 2FA is enabled)
+
+Verify you're logged in:
+```bash
+npm whoami
+```
+
+**Note:** If this is the first time publishing this package, make sure you have access to the `@hef2024` scope on npm. If you don't own this scope, you'll need to either:
+1. Create the scope on npm (if available)
+2. Change the package name in `package.json` to a scope you own
+3. Publish without a scope (remove `@hef2024/` prefix)
+
+---
+
+## Step 2: Publish the Package
+
+```bash
+# Make sure you're in the llmasaservice-ui-1 directory
+cd /Users/indomitablehef/llmasaservice-ui-1
+
+# Build the package (already done, but good to verify)
+npm run build
+
+# Run tests (already done, but good to verify)
+npm test
+
+# Publish to npm
+npm publish --access public
+```
+
+**Note:** The package name is `@hef2024/llmasaservice-ui` and it's scoped, so `--access public` is required.
+
+**If you get a 404 error:**
+- This might be the first publish of this package
+- Make sure you're logged in as the owner of the `@hef2024` scope
+- If the scope doesn't exist or you don't have access, you'll need to either create it on npm or change the package name
+
+---
+
+## Step 3: Unlink in FocusedFit
+
+Navigate to your FocusedFit project directory and run:
+
+```bash
+# Unlink the local development version
+npm unlink @hef2024/llmasaservice-ui
+
+# Or if it was linked as 'llmasaservice-ui':
+npm unlink llmasaservice-ui
+
+# Restore to published version
+npm install
+```
+
+**Alternative:** If the unlink doesn't work, you can manually remove the link:
+
+```bash
+# Check if it's linked
+npm ls @hef2024/llmasaservice-ui
+
+# Remove node_modules and package-lock.json
+rm -rf node_modules package-lock.json
+
+# Reinstall
+npm install
+```
+
+---
+
+## Step 4: Install Published Version in FocusedFit
+
+In your FocusedFit project:
+
+```bash
+# Install the published version
+npm install @hef2024/llmasaservice-ui@latest
+
+# Or install a specific version
+npm install @hef2024/llmasaservice-ui@0.16.8
+```
+
+---
+
+## Step 5: Verify Installation
+
+In your FocusedFit project:
+
+```bash
+# Check installed version
+npm ls @hef2024/llmasaservice-ui
+
+# Should show something like:
+# @hef2024/llmasaservice-ui@0.16.8
+```
+
+---
+
+## Troubleshooting
+
+### If unlink fails:
+```bash
+# Remove the symlink manually
+rm -rf node_modules/@hef2024/llmasaservice-ui
+rm -rf node_modules/llmasaservice-ui
+
+# Clear npm cache
+npm cache clean --force
+
+# Reinstall
+npm install
+```
+
+### If you see "local" or "file:" in npm ls:
+The package is still linked. Make sure you:
+1. Ran `npm unlink` in FocusedFit
+2. Removed `node_modules` and `package-lock.json`
+3. Ran `npm install` again
+
+### To verify the link is removed:
+```bash
+# In FocusedFit directory
+cat node_modules/@hef2024/llmasaservice-ui/package.json
+# Should NOT show a "link" field or point to a local path
+```
+
+---
+
+## Quick Reference
+
+### In llmasaservice-ui-1 (this package):
+```bash
+npm run build    # Build the package
+npm test         # Run tests
+npm publish --access public  # Publish to npm
+```
+
+### In FocusedFit (consuming app):
+```bash
+npm unlink @hef2024/llmasaservice-ui  # Unlink local version
+npm install                            # Restore dependencies
+npm install @hef2024/llmasaservice-ui@latest  # Install published version
+```
+
+---
+
+## Version Bumping (for future releases)
+
+When you need to publish a new version:
+
+1. Update version in `package.json`:
+   ```json
+   "version": "0.16.9"
+   ```
+
+2. Build and test:
+   ```bash
+   npm run build
+   npm test
+   ```
+
+3. Commit and tag:
+   ```bash
+   git add package.json
+   git commit -m "Bump version to 0.16.9"
+   git tag v0.16.9
+   git push origin main --tags
+   ```
+
+4. Publish:
+   ```bash
+   npm publish --access public
+   ```