🚀 Vercel Source Downloader

Download source code from any Vercel deployment in seconds

⚡ Quick Start

No installation needed! Just run:

npx vercel-source-downloader your-app.vercel.app

That's it! Your deployment source code will be downloaded to a local folder.

📦 View on npm | 🐙 View on GitHub

🎯 Why Use This?

Ever needed to:

• 📦 Backup a deployment before making changes?
• 🔍 Recover source code when local files are lost?
• 🐛 Debug production by getting the exact deployed code?
• 🚚 Migrate projects between accounts?
• 📊 Audit what's actually deployed vs what's in git?

This tool makes it simple.

📸 Demo

$ npx vercel-source-downloader my-app.vercel.app

✔ Getting deployment id
✔ Loading source files tree
✔ Downloading ./my-app/components/ui/button.tsx
✔ Downloading ./my-app/app/page.tsx
✔ Downloading ./my-app/lib/utils.ts
... 

✓ Successfully downloaded source code to my-app
→ Total files: 116
→ Total directories: 23

🛠️ Setup

1️⃣ Get Your Vercel Token

1. Visit Vercel Tokens
2. Click "Create Token"
3. Give it a name and copy the token

2️⃣ Set Your Token

Option A: Create a .env file (recommended)

VERCEL_TOKEN=your_token_here
VERCEL_TEAM=team_xxx  # Optional, for team deployments

Option B: Use environment variable

export VERCEL_TOKEN=your_token_here

Option C: Pass inline

VERCEL_TOKEN=your_token npx vercel-source-downloader app.vercel.app

3️⃣ Download Your Deployment

npx vercel-source-downloader your-app.vercel.app

📚 Usage Examples

Basic Download

# Download to folder named after the deployment
npx vercel-source-downloader my-app.vercel.app

Custom Destination

# Download to specific folder
npx vercel-source-downloader my-app.vercel.app ./backup-folder

Using Deployment ID

# From Vercel dashboard URL or API
npx vercel-source-downloader dpl_FhQJMKpXXXXXXXXXXXXXXXXX

Preview Deployments

# Download PR preview or branch deployment
npx vercel-source-downloader my-app-git-feature-xyz.vercel.app

Team Deployments

# Set team ID in .env or inline
VERCEL_TEAM=team_xxx npx vercel-source-downloader team-app.vercel.app

🎨 Features

Feature	Description
🚀 No Install	Run directly with npx
⚡ Fast Downloads	Parallel file downloads
📁 Structure Preserved	Maintains exact folder structure
🔄 Skip Existing	Won't re-download existing files
📊 Progress Indicators	See download progress for each file
🎯 Smart Detection	Auto-detects deployment IDs vs URLs
👥 Team Support	Works with team deployments
🎨 Beautiful Output	Color-coded, clear feedback

🚨 Troubleshooting

Error: "Missing VERCEL_TOKEN"

Make sure you've set your token:

echo "VERCEL_TOKEN=your_token_here" > .env

Error: "Deployment not found"

• Check you have access to the deployment
• For team deployments, set VERCEL_TEAM
• Try using the deployment URL instead of ID
• Ensure you're using the correct Vercel account token

Error: "No 'src' directory found"

Some deployments might not have source files. This tool downloads the /src directory from the deployment.

Downloads are slow

The tool downloads files in parallel, but large projects may take time. Check your internet connection.

🔒 Security Best Practices

1. Never commit .env files - Add to .gitignore
2. Use read-only tokens when possible
3. Rotate tokens regularly
4. Set token expiration in Vercel dashboard
5. Use environment variables in CI/CD

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

MIT © William Kasel

🙏 Credits & Acknowledgments

This project was inspired by zehfernandes/get-vercel-source-code. While that repository provided the initial concept and approach, this is a complete rewrite with significant enhancements.

🆕 Key Improvements Over Original

This modern implementation includes:

• ✨ NPX support for instant usage without installation
• 🎨 Enhanced CLI with colored output and progress indicators
• 📊 Better error handling and user feedback
• 📁 Support for Vercel dashboard IDs
• 📖 Comprehensive documentation
• 🚀 Parallel downloads for improved speed
• 👥 Team deployment support

Special thanks to Zeh Fernandes for the original concept that inspired this project.

📮 Support

• 🐛 Report Issues
• 💡 Request Features
• 📧 Contact

⭐ Show Your Support

If this tool helped you, please consider giving it a star on GitHub!

---

Made with ❤️ for the Vercel community