# Distribution Checklist

Use this checklist when preparing to distribute LangToLang to your team.

---

## ✅ Pre-Build Checklist

- [ ] Version number updated in `Settings.swift` → `AppVersion`
- [ ] Changelog updated in `AboutView.swift`
- [ ] All features tested and working
- [ ] No debug code or test alerts left in
- [ ] Icons are properly added to Assets
- [ ] Bundle ID is correct in project settings

---

## 🏗️ Build Process

### 1. Clean Build
- [ ] Product → Clean Build Folder (⌘⇧K)
- [ ] Delete Derived Data (optional but recommended)

### 2. Set Destination
- [ ] Product → Destination → **Any Mac (Apple Silicon, Intel)**

### 3. Archive
- [ ] Product → Archive
- [ ] Wait for archiving to complete
- [ ] Organizer window opens

### 4. Export
- [ ] Select your archive
- [ ] Click **Distribute App**
- [ ] Choose **Copy App**
- [ ] Click **Next**
- [ ] Choose export location (e.g., Desktop)
- [ ] Click **Export**

---

## 📦 Package for Distribution

### 1. Compress
- [ ] Find exported **LangToLang.app**
- [ ] Right-click → **Compress "LangToLang"**
- [ ] Creates **LangToLang.zip**

### 2. Test the Package
- [ ] Move ZIP to different location
- [ ] Unzip
- [ ] Try opening the app
- [ ] Grant permissions
- [ ] Test conversion
- [ ] Verify all features work

---

## 📝 Prepare Documentation

### 1. Installation Instructions
Create a simple text file or email with:

```
LangToLang v1.5.0 - Installation

REQUIREMENTS:
• macOS 13.0 (Ventura) or later

INSTALL:
1. Unzip LangToLang.zip
2. Drag LangToLang.app to Applications folder
3. Open Applications → Right-click LangToLang → Open
4. Click "Open" in security dialog (first time only)
5. Grant Accessibility permission when prompted
6. Done! Icon appears in menu bar

USAGE:
• Type text in any app
• Press Ctrl+Shift+Space to convert
• Works in TextEdit, Slack, Figma, etc.

PREFERENCES:
• Click menu bar icon → Preferences
• Customize keyboards, hotkey, settings

SUPPORT:
• Use in-app feedback form for questions
• Menu bar → Send Feedback
```

### 2. Known Issues (if any)
- [ ] List any known bugs or limitations
- [ ] Provide workarounds

---

## 📤 Distribution Methods

### For Small Team (Email/Slack)

- [ ] Attach LangToLang.zip
- [ ] Include installation instructions
- [ ] Mention it's Early Adopter version (free forever)
- [ ] Ask for feedback

### For GitHub (Optional)

- [ ] Create GitHub repository
- [ ] Push code
- [ ] Create Release (v1.5.0)
- [ ] Attach LangToLang.zip
- [ ] Add release notes
- [ ] Share release URL

### For Larger Distribution

- [ ] Consider code signing (requires Apple Developer account)
- [ ] Create DMG installer (more professional)
- [ ] Set up auto-update (Sparkle)

---

## ✉️ Sample Email to Team

```
Subject: LangToLang v1.5.0 - Keyboard Layout Converter for Mac

Hi team,

I'm excited to share LangToLang - a productivity tool I built to solve the "wrong keyboard layout" problem!

🎯 WHAT IT DOES:
Ever typed in Hebrew while your keyboard was on English (or vice versa)? 
LangToLang fixes it with one hotkey: Ctrl+Shift+Space

✨ FEATURES:
• Works in any app (Slack, Figma, Mail, etc.)
• Auto-switches keyboard after conversion
• Tracks statistics
• 100% local - no internet required

📥 INSTALLATION:
1. Download attached LangToLang.zip
2. Unzip and move to Applications
3. Open it (right-click → Open first time)
4. Grant Accessibility permission
5. Done!

🆓 EARLY ADOPTER PERKS:
You're getting v1.5 before public release! As Early Adopters, you'll have 
free access forever, even when we add premium features later.

💬 FEEDBACK:
Please try it out and let me know what you think! Use the in-app feedback 
form or reply to this email.

Attachment: LangToLang.zip (X MB)

Thanks!
[Your Name]
```

---

## 🧪 Post-Distribution Testing

After sending to first users:

- [ ] Confirm they can download
- [ ] Confirm they can install
- [ ] Confirm they can grant permissions
- [ ] Confirm conversions work
- [ ] Check for any error reports
- [ ] Gather feedback
- [ ] Note any issues for next version

---

## 📊 Tracking

Keep track of:

- [ ] Who has the app
- [ ] What version they're on
- [ ] Any bugs reported
- [ ] Feature requests
- [ ] Usage feedback

---

## 🔄 For Future Updates

When releasing v1.6, v2.0, etc.:

1. [ ] Update version number
2. [ ] Update changelog
3. [ ] Follow build process above
4. [ ] Create release notes: "What's new in vX.X"
5. [ ] Notify users about update
6. [ ] If using Sparkle: Users auto-update ✨

---

## 🎉 Launch Announcement (Optional)

If you want to make it "official":

```
🎉 LangToLang v1.5.0 is Here!

After months of development and testing, I'm thrilled to release 
LangToLang - a productivity tool for multilingual Mac users.

Never retype text in the wrong keyboard layout again!

Download: [link]
Learn more: [link]

Built with ❤️ for our amazing multilingual team.

#productivity #macos #tools
```

---

## ✅ Final Checklist

Before sending:

- [ ] App works on YOUR Mac
- [ ] App works on at least ONE other Mac (if possible)
- [ ] Installation instructions are clear
- [ ] Accessibility permission steps are explained
- [ ] Support contact info provided
- [ ] You're ready to handle feedback/questions

---

**You're ready to ship!** 🚀

Good luck with the launch!
