| name | replit-migration-deep-dive |
| description | Migrate to Replit from Heroku, Railway, Vercel, or local development environments.
Use when moving an existing app to Replit, migrating databases,
or converting Docker/buildpack apps to Replit's Nix-based system.
Trigger with phrases like "migrate to replit", "heroku to replit",
"move to replit", "replit migration", "railway to replit", "convert to replit".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(pip:*) |
| version | 1.12.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","replit","migration","heroku","railway"] |
| compatibility | Designed for Claude Code |
Replit Migration Deep Dive
Current State
!cat .replit 2>/dev/null | head -10 || echo 'No .replit found'
!cat Procfile 2>/dev/null || echo 'No Procfile (not Heroku)'
!cat Dockerfile 2>/dev/null | head -10 || echo 'No Dockerfile'
!cat railway.json 2>/dev/null || echo 'No railway.json'
Overview
Comprehensive guide for migrating existing applications to Replit from Heroku, Railway, Vercel, Render, or local development. Covers converting configuration files, migrating databases, adapting to Replit's Nix-based environment, and setting up Replit-native features.
Prerequisites
- Source application with working deployment
- Access to current database for export
- Git repository with application code
- Replit Core or Teams plan
Migration Paths
| From | Complexity | Duration | Key Changes |
|---|
| Local dev | Low | 1-2 hours | Add .replit + replit.nix |
| Heroku | Medium | 2-4 hours | Procfile to .replit, addons to Replit services |
| Railway | Low-Medium | 1-3 hours | railway.json to .replit |
| Vercel | Low | 1-2 hours | Usually frontend-only, use Static deploy |
| Docker | Medium | 3-6 hours | Dockerfile to replit.nix |
Instructions
Step 1: Import from GitHub
1. Go to replit.com > Create Repl > Import from GitHub
2. Paste your repository URL
3. Replit auto-detects language and creates default config
4. Review and adjust .replit and replit.nix
Step 2: Convert from Heroku
Procfile to .replit:
web: npm start
worker: node worker.js
release: node migrate.js
run = "npm start"
entrypoint =
= [, , ]
= [, , ]
=
=
