SETUP_DIRECT_DOWNLOADS.md

📥 Setup Direct Download Links

Quick Setup Guide

Step 1: Generate Native App Packages

1. Deploy your app first (to get a public URL)

   npm run build
   # Deploy dist folder to Netlify/Vercel/etc.

2. Use PWABuilder to generate packages:

   • Go to: https://www.pwabuilder.com/
   • Enter your deployed app URL
   • Click "Start" → "Build My PWA"
   • Download packages for each platform

Step 2: Add Download Files to Your Project

1. Create a public/downloads folder:

   public/
     downloads/
       app-android.apk
       app-windows.msix
       app-mac.dmg
   

2. Place your generated files in this folder

Step 3: Deploy with Downloads

When you build and deploy, the download links will work automatically:

npm run build
# Deploy dist folder (includes public/downloads)

Alternative: Host Downloads Separately

If files are too large for your hosting:

1. Upload to cloud storage (Google Drive, Dropbox, etc.)
2. Get shareable links
3. Update download links in src/pages/Landing.tsx

File Size Considerations

• Android APK: ~5-20 MB
• Windows MSIX: ~10-30 MB
• Mac DMG: ~10-30 MB

Most hosting services support files up to 100MB, so this should be fine.

Testing Downloads

1. Build your app: npm run build
2. Test locally: npm run preview
3. Visit: http://localhost:4173/downloads/app-android.apk
4. Verify file downloads correctly

Current Implementation

The landing page now includes:

• ✅ Direct download buttons for Android, Windows, Mac, iOS
• ✅ Fallback to PWABuilder if files don't exist
• ✅ Clear instructions for each platform
• ✅ Professional UI with platform icons

Next Steps

1. Generate packages using PWABuilder
2. Add files to public/downloads/
3. Rebuild and redeploy
4. Download links will work automatically!