---

name: deploy-railway-v1 description: Safe Railway deployment with pre-flight guards and rollback procedures

Deploy Railway Skill v1.0

Purpose: Deploy to Railway with all guards passing first.

1) Non-Negotiables (Policy)

Pre-Deploy Requirements

ALL guards must pass before deployment:

Copynpm run guard:all
npm run build

Config Files

• railway.json - Railway configuration
• Procfile - Start command
• .env - Environment variables (never commit)

---

2) Inputs & Outputs

Deployment Checklist

Copyinterface DeploymentChecklist {
  guards: {
    layouts: boolean;
    routes: boolean;
    content: boolean;
    assets: boolean;
  };
  build: boolean;
  tests: boolean;
  commit: string;
}

Output

• Deployment URL
• Build logs
• Health check status

---

3) Quality Gates

Pre-Flight Checks

Copy# 1. Run all guards
npm run guard:all

# 2. Build production bundle
npm run build

# 3. Type check
npm run check

# 4. Health check (if server running)
curl -s http://localhost:3000/health

Deployment Command

Copy# Login (if needed)
railway login

# Deploy
railway up

Post-Deploy Verification

Copy# Check production health
curl -s https://your-app.railway.app/health

# Check key routes
curl -s https://your-app.railway.app/
curl -s https://your-app.railway.app/shop

---

Railway CLI Reference

Available Scripts

Common Commands

Copyrailway status          # Check project status
railway logs            # View logs
railway up              # Deploy
railway down            # Stop service
railway variables       # Manage env vars

---

Rollback Procedure

If deployment fails:

1. railway logs - Check error
2. Fix the issue locally
3. git revert HEAD if needed
4. Re-run pre-flight checks
5. Deploy again

---

Environment Variables

Required in Railway:

CopyDATABASE_URL=postgresql://...
JWT_SECRET=...
STRIPE_SECRET_KEY=...
NODE_ENV=production