bruvtools 🚀

- Deploy any language with a single command.
- Automatic SSL certificates on every deployment.
- Zero-downtime rolling updates.
- Auto scaling of app instances.
- Private and secure – your own server.
- Cost effective at ~$5/month.
- Smart collision detection for app names.

- Domain name ($2/year) - for wildcard DNS (.yourdomain.com)
- Server with public IP ($5/month) - DigitalOcean, Vultr, Linode, etc.
- Docker installed - included in one-click deployment

npm install -g bruvtools
bruvtools --version  # Should show: 0.2.16

bruvtools init
bruvtools deploy my-app
For the easiest setup, use the automated script from within the bruvtools repository:

Note: The setup script must be run from within the bruvtools repository directory as it uses the included mcp-server.js file.

   {

     "mcpServers": {

       "bruvtools": {

         "command": "bruvtools",

         "args": ["mcp"],

         "env": {

           "CAPROVER_PASSWORD": "your-caprover-password",

           "CAPROVER_DOMAIN": "your-domain.com",

           "CAPROVER_MACHINE": "your-machine-name"

         }

       }

     }

   }

   

   {

     "mcpServers": {

       "bruvtools": {

         "command": "bruvtools",

         "args": ["mcp"],

         "cwd": "${workspaceFolder}"

       }

     }

   }

   

bruvtools deploy my-app

bruvtools init

// Universal function (manually add to your project)
function getEnvVar(varName) {
  // First try to get the variable directly
  if (process.env[varName]) {
    return process.env[varName];
  }
  
  // If not found, try to reconstruct from split parts
  let reconstructed = '';
  let partIndex = 1;
  
  while (true) {
    const partName = ${varName}_${partIndex};
    const part = process.env[partName];
    
    if (part) {
      reconstructed += part;
      partIndex++;
    } else {
      break;
    }
  }
  
  return reconstructed || undefined;
}
// Use in your app

const JWT_TOKEN = getEnvVar('JWT_TOKEN'); // Works with both single and split tokens!

default_provider: caprover
providers:
  caprover: 
    machine: your-caprover-machine-name
    domain: your-domain.com
projects:
  my-app:
    provider: caprover
    port: 80

Set up a wildcard A record in your DNS:
- Type: A record
- Host: .captain (or .apps, .dev, etc.)
- Points to: Your server's IP address
- TTL: 300 (or default)

bruvtools init

bruvtools services # Show all deployed apps with URLs
bruvtools apps # Same as services (alias)
bruvtools deployed # Same as services (alias)
bruvtools dashboard # Same as services (alias)

bruvtools deploy <app-name> # Deploy with smart auto-creation
bruvtools create <app-name> # Create app manually (optional)
bruvtools status <app-name> # Check app status
bruvtools logs <app-name> # View app logs
bruvtools scale <app> <count> # Scale app replicas
bruvtools test <app-name> # Test app connectivity

bruvtools deploy my-app

bruvtools deploy my-app-dev     # Development
bruvtools deploy my-app-staging # Staging  
bruvtools deploy my-app-prod    # Production

ls examples/abecmed-api-legacy/keys/abecmed-368dfd6bae7c.json

cd bruvtools/examples/abecmed-api-legacy
bruvtools deploy abecmed-api-legacy

The Problem: CapRover and many cloud platforms have strict limits on environment variable sizes:
- CapRover: ~1000 character limit per environment variable
- Heroku: 32KB total for all environment variables
- AWS Lambda: 4KB total for all environment variables
- Docker: No hard limit, but performance degrades with very large values

Common Culprits:
- 🔑 JWT Tokens: Often 1000+ characters (especially with extensive claims)
- 🔐 Private Keys: RSA/ECDSA keys can be 1600+ characters
- 📄 JSON Configs: Large configuration objects
- 🌐 Base64 Encoded Data: Images, certificates, or binary data

1. Manual Splitting ✅ WORKING (recommended approach)

npm install -g bruvtools caprover

bruvtools --version  # Should show: 0.2.16

caprover --version   # Should show: 2.x.x
bruvtools init

bruvtools deploy my-app

---

Requirements: Node.js 16+ • License: MIT • Version: 0.2.16

> Your Private App Platform - Deploy microservices anywhere, any language, one CLI

Deploy Node.js, Go, Python, Java, PHP, Ruby, or any containerizable application to CapRover, AWS, GCP, or Kubernetes with the same simple commands. Zero vendor lock-in.

bruvtools transforms any cloud server into your private app platform - like having your own Heroku, Vercel, or Railway. Combined with CapRover, you get:

| Feature | Description |
|---------|-------------|
| ✅ Push to deploy | bruvtools deploy my-app and you're live |
| ✅ Auto SSL certificates | HTTPS enabled automatically |
| ✅ Any language | Node.js, Python, Go, Java, PHP, Ruby, Docker |
| ✅ Zero downtime deployments | Rolling updates built-in |
| ✅ Auto scaling | Scale apps up/down as needed |
| ✅ Private & secure | Your own server, your own rules |
| ✅ Cost effective | $5/month vs $25+ on other platforms |

npm install -g bruvtools
bruvtools --version  # Should show: 0.2.16

default_provider: caprover
providers:
  caprover: 
    machine: your-caprover-machine-name
    domain: your-domain.com
projects:
  my-app:
    provider: caprover
    port: 80