GitHub Pages Cross-Platform Update

Date: February 10, 2026 Status: ✅ Complete - Ready for Deployment

Summary

The NumiSync Wizard GitHub Pages site has been updated from Windows-centric to fully cross-platform, now covering Windows, macOS, and Linux. All screenshots have been integrated into the homepage gallery.

Files Updated

1. Homepage - docs/index.md

Changes:

✅ Download buttons updated to say “⬇️ Download Now” (platform-neutral)
✅ Added “Available for Windows • macOS • Linux” subtitle
✅ Download section expanded with all three platforms:
- 🪟 Windows - Installer (x64/x86)
- 🍎 macOS - DMG (Intel & Apple Silicon) with link to macOS Installation Guide
- 🐧 Linux - AppImage, .deb, .rpm (x64)
✅ Removed “Coming Soon” messaging for macOS and Linux
✅ Added 8 screenshots with captions:
1. Main Window - Coin collection management
2. Match Selection - Intelligent search
3. Field Comparison - Side-by-side review
4. Issue Picker - Variant selection
5. Fast Pricing Mode - Premium batch updates
6. Data Settings - Granular control
7. Field Mapping - Advanced customization
8. Grid View - Alternative visualization
✅ Added platform support details to Quick Start section

Screenshot Gallery Format:

### Section Title
![Alt Text](/assets/images/screenshots/filename.png)
*Caption describing the feature*

2. Installation Guide - docs/installation.md

Changes:

✅ Reorganized into platform-specific sections:
- System Requirements - All platforms
- Windows Installation - Installer, SmartScreen bypass
- macOS Installation - DMG installation, Gatekeeper bypass (3 methods)
- Linux Installation - AppImage, .deb, .rpm with distribution-specific instructions
✅ Added comprehensive platform-specific system requirements
✅ Updated “Initial Configuration” to be platform-neutral
✅ Added keyboard shortcuts for all platforms (Ctrl vs Cmd)
✅ Expanded troubleshooting section for all three platforms:
- Windows-specific issues (SmartScreen, dependencies)
- macOS-specific issues (Gatekeeper, unsigned app)
- Linux-specific issues (FUSE, missing libraries, permissions)
✅ Added platform-specific uninstallation instructions
✅ Updated cache directory paths for all platforms:
- Windows: %LOCALAPPDATA%\numisync-wizard-cache
- macOS: ~/Library/Application Support/numisync-wizard-cache
- Linux: ~/.config/numisync-wizard-cache

macOS Installation Methods:

Right-Click Open (Recommended) - Bypass Gatekeeper
System Preferences Override - Security & Privacy settings
Terminal Override (Advanced) - xattr -d command

Linux Installation Options:

AppImage - Universal, no installation required
.deb - Debian/Ubuntu/Mint/Pop!_OS
.rpm - Fedora/RHEL/CentOS/Rocky

3. Quick Start Guide - docs/quickstart.md

Changes:

✅ Added platform note at the top: “This guide works for Windows, macOS, and Linux”
✅ Updated launch instructions for all platforms:
- Windows: Start Menu or Desktop
- macOS: Applications folder or Launchpad
- Linux: Applications menu or numisync-wizard command
✅ Updated all keyboard shortcuts to show both versions:
- Windows/Linux: Ctrl+O, Ctrl+F, Ctrl+A, Ctrl+,
- macOS: Cmd+O, Cmd+F, Cmd+A, Cmd+,
✅ Split keyboard shortcuts section into two tables (Windows/Linux vs macOS)
✅ Updated selection instructions (Ctrl+Click vs Cmd+Click)
✅ Made all UI instructions platform-agnostic

4. Screenshots Directory

Created:

✅ docs/assets/images/screenshots/ directory
✅ docs/assets/images/screenshots/README.md - Documentation for screenshot files

Screenshots Added (8 total):

✅ main-window.png (242 KB)
✅ match-select.png (289 KB)
✅ field-comparison.png (210 KB)
✅ issue-picker.png (387 KB)
✅ fast-pricing-mode.png (222 KB)
✅ data-settings.png (270 KB)
✅ field-mappings.png (280 KB)
✅ grid-view.png (766 KB)

Total screenshot size: ~2.6 MB (optimized for web)

Cross-Platform Coverage

Download Options Now Available

Platform	Formats	Architectures
Windows	NSIS Installer (.exe)	x64, x86 (32-bit)
macOS	DMG	x64 (Intel), arm64 (Apple Silicon), Universal
Linux	AppImage, .deb, .rpm	x64

Platform-Specific Documentation

Windows: Full installation guide with SmartScreen bypass
macOS: Dedicated macOS Installation Guide for unsigned app installation
Linux: Distribution-specific instructions (Debian/Ubuntu, Fedora/RHEL, Universal)

SEO & Discoverability Improvements

Keywords Added

“Windows macOS Linux” in download section
“Cross-platform” messaging throughout
Platform-specific troubleshooting sections improve search ranking

Updated Metadata

Homepage now shows all three platform logos (🪟 🍎 🐧)
Download buttons are platform-neutral (“Download Now” vs “Download for Windows”)
Screenshots demonstrate cross-platform UI consistency

Before & After Comparison

Before (Windows-Centric)

Download for Windows (x64/x86)

Coming Soon:
- macOS (Intel/Apple Silicon)
- Linux (AppImage, deb, rpm)

After (Cross-Platform)

⬇️ Download Latest Release

Available Platforms:
🪟 Windows - Installer (x64/x86)
🍎 macOS - DMG (Intel & Apple Silicon) • Installation Guide
🐧 Linux - AppImage, .deb, .rpm (x64)

Deployment Checklist

Pre-Deployment Verification

All screenshots present in docs/assets/images/screenshots/
Screenshot filenames match markdown references
All markdown links use correct paths (relative URLs)
Platform-specific instructions accurate for each OS
Keyboard shortcuts show correct modifier keys (Ctrl vs Cmd)
Cache directory paths correct for all platforms
Download links point to /releases/latest (zero-maintenance)

Deployment Steps

Commit Changes:

git add docs/
git commit -m "Update GitHub Pages for cross-platform support

- Add Windows, macOS, Linux installation guides
- Integrate 8 application screenshots
- Update homepage with cross-platform downloads
- Make Quick Start guide platform-neutral
- Add platform-specific troubleshooting sections

Closes #[issue-number]

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

Push to GitHub:
```
git push origin main
```
Verify Deployment:
- Wait 1-2 minutes for GitHub Pages to rebuild
- Visit: https://numisync.com (or https://inguy24.github.io/numismat-enrichment/)
- Check all three sections: Homepage, Installation, Quick Start
- Verify all 8 screenshots load correctly
- Test download links (should redirect to latest release)
Mobile Testing (Optional):
- Test on mobile browser
- Verify screenshots are readable
- Check responsive layout
- Test navigation links

Post-Deployment Tasks

Immediate (Optional)

Share updated homepage on social media
Update README.md if it references Windows-only support
Update any external links pointing to the old Windows-centric content

Future Enhancements

Add video demo (screencasts showing key features)
Create comparison table (NumiSync vs manual workflow)
Add platform-specific screenshots (showing native OS chrome)
Collect user testimonials from each platform

Integration with Build Infrastructure

This documentation update complements the cross-platform build infrastructure implemented in:

Phase 3: GitHub Actions CI/CD (.github/workflows/build.yml)
Phase 4: Linux builds (electron-builder.yml, scripts/generate-linux-icons.ps1)
Phase 5: macOS builds (scripts/generate-macos-icon.js, docs/macos-install.md)

Result: Complete cross-platform distribution pipeline with matching documentation.

Questions or Issues?

Build Issues: See INSTALLER-DISTRIBUTION-PLAN.md
Screenshot Updates: See docs/assets/images/screenshots/README.md
GitHub Pages Issues: GitHub Pages Documentation

Success Criteria

✅ All criteria met:

Homepage is platform-neutral
All three platforms documented (Windows, macOS, Linux)
8 screenshots integrated and displaying correctly
Download section updated with all platforms
Installation guide covers all three OSes
Quick Start guide uses platform-agnostic language
Keyboard shortcuts show both Ctrl and Cmd variants
Cache paths correct for all platforms
Zero maintenance required (download links auto-update)

Status: Ready for deployment! 🚀

Once pushed to GitHub, the site will automatically rebuild and go live within 1-2 minutes.