docs: Add Railway quick start deployment guide

RAILWAY_QUICKSTART.md

@@ -0,0 +1,114 @@
+# Railway Deployment - Quick Start (5 Minutes)
+
+Deploy your Farsi Transcriber to Railway in just 5 minutes! 🚀
+
+---
+
+## **What You'll Get**
+
+✅ Your app live online
+✅ Free $5/month credit
+✅ 24/7 uptime
+✅ Automatic scaling
+✅ No credit card needed (free tier)
+
+---
+
+## **Step 1: Create Railway Account** (2 min)
+
+1. Go to **https://railway.app**
+2. Click **"Login with GitHub"**
+3. Authorize with your GitHub account
+4. Done! You get $5 free credit ✅
+
+---
+
+## **Step 2: Create Backend Service** (2 min)
+
+1. Click **"Create New Project"**
+2. Select **"GitHub Repo"**
+3. Find your **whisper** fork
+4. Railway auto-detects Python project
+5. **Root Directory:** `farsi_transcriber_web/backend`
+6. Click **Deploy**
+7. **Wait 2-3 minutes** for deployment
+8. **Copy the URL** that appears (e.g., `https://farsi-api-xxx.railway.app`)
+
+---
+
+## **Step 3: Create Frontend Service** (1 min)
+
+1. In Railway project, click **"New Service"** → **"GitHub Repo"**
+2. Select **whisper** again
+3. **Root Directory:** `farsi_transcriber_web`
+4. Click **Deploy**
+5. **Wait 3-5 minutes** for build and deployment
+
+---
+
+## **Step 4: Connect Frontend to Backend** (Bonus step - 1 min)
+
+1. In Railway, select **frontend** service
+2. Go to **Variables**
+3. Edit `VITE_API_URL` and paste your backend URL from Step 2
+4. Click **Deploy** to redeploy with correct API URL
+
+---
+
+## **That's It! 🎉**
+
+Your app is now live! Click the frontend service to see your live URL.
+
+Example URLs:
+- Frontend: `https://farsi-transcriber-prod.railway.app`
+- Backend: `https://farsi-api-prod.railway.app`
+
+---
+
+## **Test Your App**
+
+1. Click your frontend URL
+2. Add a file
+3. Click Transcribe
+4. Wait for transcription
+5. Export results
+
+---
+
+## **Detailed Guide**
+
+For more details, see: `farsi_transcriber_web/RAILWAY_DEPLOYMENT.md`
+
+---
+
+## **Cost**
+
+- **First 3 months:** FREE ($5/month credit)
+- **After that:** ~$2-3/month for personal use
+- Can upgrade to paid tier for more resources
+
+---
+
+## **Common Issues**
+
+**"API connection failed"**
+- Make sure backend URL is correct in frontend variables
+- Redeploy frontend after updating API URL
+
+**"Model not loaded"**
+- Wait 1-2 minutes on first transcription
+- Model downloads on first use
+
+**"Build failed"**
+- Check Railway logs for errors
+- Ensure all files are committed
+
+---
+
+## **Support**
+
+For detailed setup help, see: `farsi_transcriber_web/RAILWAY_DEPLOYMENT.md`
+
+---
+
+**Your Farsi Transcriber is now online!** Share the URL with anyone! 🌐