SETUP GUIDE

From zero to
fully live.

Follow these steps in order. Backend on Railway → Extension in Chrome → Website on Vercel → WhatsApp Bot → Payments. Total time: about 2 hours.

What you're setting up
The Wravio Chrome extension + backend server. The extension reads pages and shows the UI. The backend handles AI calls and usage tracking. Both need to be running for Wravio to work.
STEP 1 — BACKEND

Deploy the backend on Railway.

1
Download the backend
Download wravio-backend-v4-final.zip from your Wravio files. Extract it. You get a folder with main.py, requirements.txt, Procfile, .env.example.
2
Push to GitHub
Open terminal in the backend folder and run:
git init git add . git commit -m "Wravio backend v4" git remote add origin https://github.com/YOUR_USERNAME/wravio-backend.git git push -u origin main
3
Deploy on Railway
Go to railway.app → New Project → Deploy from GitHub → select your repo. Railway detects Python and deploys automatically.
4
Add PostgreSQL
In Railway dashboard → + New → Database → Add PostgreSQL. Railway sets DATABASE_URL automatically. Database tables are created on first boot.
5
Add environment variables
In Railway → your service → Variables tab. Add:
OPENROUTER_API_KEY = sk-or-v1-your-key PRIMARY_MODEL = nvidia/nemotron-ultra-253b-v1:free FALLBACK_MODEL = meta-llama/llama-3.1-8b-instruct:free ADMIN_KEY = wravio-admin-2026 SITE_URL = https://wravio.com META_VERIFY_TOKEN = wravio-bot-verify
6
Get your Railway URL
Settings → Domains → Generate Domain. You get a URL like https://wravio-backend.up.railway.app. Test it by opening /health — should return {"ok": true}.
STEP 2 — EXTENSION

Install the Chrome extension.

1
Download and extract
Download wravio-v7-ext.zip. Extract it. You get a folder called ext with popup.js, background.js, content.js, gmail.js, linkedin.js, and manifest.json.
2
Update the backend URL
Open background.js. Find line 4:
const BACKEND = "https://wravio.com/api";
Change to your Railway URL:
const BACKEND = "https://your-railway-url.up.railway.app/api";
3
Load in Chrome
Open Chrome → go to chrome://extensions → enable Developer mode (top right) → click Load unpacked → select the ext folder. Pin Wravio from the puzzle icon in the toolbar.
4
Test it
Open any Upwork job post → press Alt+A → the popup opens showing "Upwork · reading" → pick Write Proposal → click Run → proposal appears in 5-8 seconds.
STEP 3 — WEBSITE

Deploy the website on Vercel.

1
Prepare the folder
Create a folder called wravio-site. Add all HTML files renamed as follows: index.html (landing), freelancer.html, business.html, student.html, features.html, whatsapp-guide.html, setup-guide.html, faq.html, about.html, contact.html, privacy.html, app.html, trial-payment.html.
2
Update API URL in app.html
Open app.html → find const API_URL → update to your Railway URL + /api/generate.
3
Deploy on Vercel
Go to vercel.com → Add New Project → drag your wravio-site folder → Deploy. Vercel deploys in 30 seconds. Connect your wravio.com domain in Settings → Domains.
STEP 4 — WHATSAPP BOT

Connect the WhatsApp bot.

1
Set up Meta WhatsApp Cloud API
Go to developers.facebook.com → Create App → Business type → Add WhatsApp product → Add your phone number → verify via SMS.
2
Get a permanent token
Business Settings → System Users → Add → Generate Token → check whatsapp_business_messaging → copy the token.
3
Add to Railway Variables
META_WHATSAPP_TOKEN = EAAxxxxxx META_PHONE_NUMBER_ID = 1234567890 META_VERIFY_TOKEN = wravio-bot-verify
4
Set webhook in Meta Developer Console
WhatsApp → Configuration → Webhook → Edit. Set callback URL to:
https://your-railway-url.up.railway.app/webhook/whatsapp
Verify token: wravio-bot-verify. Subscribe to messages.
STEP 5 — PAYMENTS

Connect Rapid Gateway for Rs. 100 payments.

1
Sign up on Rapid Gateway
Go to rapidgateway.pk → Get Started → fill in your details → upload CNIC front and back. No NTN required. CNIC only. Sandbox keys given immediately.
2
Add to Railway Variables
RAPIDGATEWAY_API_KEY = rg_test_xxxx RAPIDGATEWAY_WEBHOOK_SECRET = rg_whsec_xxxx
3
Set webhook in Rapid Gateway dashboard
https://your-railway-url.up.railway.app/webhook/rapidgateway
4
Update payment page
Open trial-payment.html → update BACKEND_URL to your Railway URL → update RG_PUBLIC_KEY to your Rapid Gateway public key.
Need help?
Email support@wravio.com with your error message and which step you're on. Include your Railway deployment logs if the backend is failing.