@deployit/cli

🚀 Deployit CLI Tool

A powerful CLI tool to deploy multiple apps with one command, using Git, PM2, and Node.js.

---

✨ Features

• Multi-App Deployment: Deploy multiple apps at once by selecting apps and ports.
• Git Sync: Optionally sync the latest remote repo before deploying.
• PM2 Process Manager: Restart or reload apps with zero downtime.
• Dry Run Mode: Simulate the entire deployment without making changes.
• Config File Support: Use .deployrc.json for easy setups.
• Interactive Mode: Automatically prompts for missing options.
• Rollback on Failure: Automatically reverts to the previous working Git commit if a deployment fails.
• App Health Check: Pings the app after deployment to verify it's running.
• CI/CD Friendly: Usable in GitHub Actions or any CI pipeline.

---

📦 Installation

Use directly with npx (no install needed):

npx deployit --project MyProject --app app1,app2 --port 3000,3001 --env dev --sync true

Or install globally:

pnpm add -g @deployit/cli

Then:

deployit --project MyProject --app app1,app2 --port 3000,3001 --env prod

---

⚙️ Usage

One-Line Command

npx deployit --project MyProject --app web,public --port 1440,1441 --env dev --sync true --dry-run false --health-check

Option	Description
--project	Name of the project
--app	Comma-separated list of apps
--port	Comma-separated list of ports
--env	Environment: dev or prod
--sync	Git sync before deployment: true or false
--dry-run	Simulate deployment without executing
--health-check	Perform a health check after app deployment

🛠️ Interactive Mode

If you run without enough arguments, the CLI will ask interactively:

npx deployit

You'll be prompted to enter project name, apps, ports, and environment.

---

🛠️ .deployrc.json Config (Optional)

Create a .deployrc.json in your project root:

{
  "project": "MyProject",
  "app": ["web", "public"],
  "env": "dev",
  "ports": {
    "web": 1440,
    "public": 1441
  }
}

Then simply run:

npx deployit

✅ It will auto-read .deployrc.json!

---

🔄 How It Works

1. (Optional) Git Sync
2. Save current Git commit hash
3. Cleanup old PM2 apps
4. Build your apps
5. Start apps using PM2
6. Health check the apps (optional)
7. If any step fails, automatically rollback to the saved Git commit

---

🚨 Exit Codes

Situation	Exit Code
Success	0
App Build Failure	1
Invalid Arguments/Config	2
Git Sync Failure	3

---

📜 License

MIT © [Deployit]