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 |
The easiest way to get started is with DigitalOcean's one-click CapRover deployment:
What this gives you:
Alternative setup: Follow the CapRover Getting Started Guide for manual installation on any cloud provider.
npm install -g bruvtools
bruvtools --version # Should show: 0.2.16
# Clone and test the working example
git clone https://github.com/fcavalcantirj/bruvtools.git
cd bruvtools/examples/hello-world
# Setup bruvtools (one time)
bruvtools init
# This creates:
# - bruvtools.yml (configuration: machine names, domains, projects)
# - .env (secrets: passwords, API keys)
# ⚠️ IMPORTANT: Never commit bruvtools.yml or .env to version control!
# Deploy with smart auto-creation and collision detection
bruvtools deploy my-app
# ✅ Checks if app exists
# ✅ Auto-creates app if needed
# ✅ Handles name collisions (my-app-1, my-app-2, etc.)
# ✅ Deploys with clear step-by-step progress
# ✅ Your app is live with HTTPS!
🎯 That's it! Your private app platform is ready. Your app is now live at https://my-app.yourdomain.com with automatic SSL.
With Model Context Protocol (MCP) support, you get a revolutionary development experience - deploy directly from Cursor.com without ever leaving your editor:
| Feature | Description |
|---|---|
| 📋 List all apps | See your entire infrastructure from within your IDE |
| 📊 Pull logs in real-time | Debug without switching windows |
| 🚀 Deploy with AI assistance | Just ask Claude: "Deploy this to production" |
| 📈 Monitor status live | App health, metrics, and scaling from your editor |
| 🔄 Rollback instantly | "Rollback to previous version" - done! |
| 🎯 Smart suggestions | AI recommends optimizations based on your code |
🤯 The Experience:
You: "Deploy this Node.js app to my-api-v2"
Claude: ✅ Deploying to CapRover...
✅ App created with collision detection
✅ Building Docker image...
✅ Live at https://my-api-v2.yourdomain.com
✅ SSL certificate auto-configured
You: "Show me the logs"
Claude: [Real-time logs streaming in your editor]
You: "Scale this to 3 replicas"
Claude: ✅ Scaled to 3 replicas, load balanced automatically
This is the future of development - your AI pair programmer that can actually deploy and manage your infrastructure. No context switching, no separate terminals, no deployment dashboards. Just code, ask, and it's live.
For the easiest setup, use the automated script from within the bruvtools repository:
# Clone the repository to get the setup script
git clone https://github.com/fcavalcantirj/bruvtools.git
cd bruvtools
# Run the automated MCP setup
chmod +x setup-mcp.sh
./setup-mcp.sh
# Follow the prompts for global or project-specific installation
Note: The setup script must be run from within the bruvtools repository directory as it uses the included mcp-server.js file.
# Install bruvtools globally (if not already installed)
npm install -g bruvtools
# Verify MCP server is available
bruvtools --version # Should show: 0.2.16
Open Cursor.com Settings:
Cmd/Ctrl + , to open settingsAdd bruvtools MCP Server:
{
"mcpServers": {
"bruvtools": {
"command": "bruvtools",
"args": ["mcp"],
"env": {
"CAPROVER_PASSWORD": "your-caprover-password",
"CAPROVER_DOMAIN": "your-domain.com",
"CAPROVER_MACHINE": "your-machine-name"
}
}
}
}
Alternative: Use Local Configuration:
If you have bruvtools.yml and .env files in your project:
{
"mcpServers": {
"bruvtools": {
"command": "bruvtools",
"args": ["mcp"],
"cwd": "${workspaceFolder}"
}
}
}
Open any project in Cursor.com and try these commands with Claude:
You: "List all my deployed apps"
Claude: [Shows your CapRover apps with URLs and status]
You: "Deploy this project as my-new-app"
Claude: [Deploys your current project to CapRover]
bruvtools deploy my-app
# ✅ Step 1: Creating app...
# ✅ Step 2: Packaging...
# ✅ Step 3: Deploying...
# ✅ Step 4: Enabling SSL...
# 🔍 Step 5: Verifying deployment health...
# ✅ Instance count: 1
# ✅ App is responding correctly!
# 🎉 Deployment completed successfully!
🚨 Large Environment Variable Detection & Auto-Splitting ⚠️ EXPERIMENTAL
bruvtools can detect when environment variables exceed platform limits and offers smart solutions (currently experimental):
bruvtools init
# 🔍 Analyzing environment variables...
# ⚠️ Large environment variable detected: JWT_TOKEN (1083 characters)
# 💡 CapRover has ~1000 character limits on environment variables
🔄 Manual Token Reconstruction ✅ WORKING
You can manually implement split environment variables using this pattern:
// 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!
bruvtools uses a clean separation between configuration and secrets:
default_provider: caprover
providers:
caprover:
machine: your-caprover-machine-name
domain: your-domain.com
projects:
my-app:
provider: caprover
port: 80
# CapRover Authentication
CAPROVER_PASSWORD=your-caprover-password
# Optional: App secrets
DATABASE_URL=postgresql://user:pass@host:port/db
API_KEY=your-api-key
⚠️ Security: Both files are automatically added to .gitignore and should NEVER be committed to version control.
*.yourdomain.com)Set up a wildcard A record in your DNS:
*.captain (or *.apps, *.dev, etc.)# Interactive setup (one time)
bruvtools init
# View all deployed apps/services
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)
# Deploy and manage apps
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
# ✅ App "my-app" created and deployed
bruvtools deploy my-app
# ⚠️ App "my-app" already exists, using "my-app-1" instead
# ✅ App "my-app-1" created and deployed
# Deploy to different environments
bruvtools deploy my-app-dev # Development
bruvtools deploy my-app-staging # Staging
bruvtools deploy my-app-prod # Production
| Language | Auto-Detection | Status |
|---|---|---|
| Node.js | package.json | ✅ Fully Tested |
| Go | go.mod | ✅ Ready |
| Python | requirements.txt | ✅ Ready |
| Java | pom.xml, build.gradle | ✅ Ready |
| PHP | composer.json | ✅ Ready |
| Ruby | Gemfile | ✅ Ready |
| Any | Dockerfile | ✅ Ready |
Try the CNPJ API live:
# Get Brazilian company information by CNPJ (tax ID)
curl "http://cnpj-enricher.bruvbot.com.br/ficha?cnpj=11222333000181"
| Platform | Monthly Cost | Features |
|---|---|---|
| bruvtools + CapRover | $5 | Unlimited apps, SSL, scaling, your server |
| Heroku | $25+ | Limited apps, SSL extra, shared resources |
| Vercel Pro | $20+ | Limited functions, bandwidth limits |
| Railway | $20+ | Limited usage, shared infrastructure |
| AWS/GCP | $50+ | Complex setup, hidden costs |
💡 With DigitalOcean's $100 credit, you get 20 months free!
| Issue | Solution |
|---|---|
| "CapRover CLI not found" | npm install -g caprover and restart terminal |
| "App name not allowed" | Use lowercase letters and hyphens only (e.g., my-app-name) |
| "Authentication failed" | Check your .env file has correct CAPROVER_PASSWORD |
| Shows default CapRover page | Wait 2-3 minutes for deployment to complete |
The Problem: CapRover and many cloud platforms have strict limits on environment variable sizes:
Common Culprits:
Manual Splitting ✅ WORKING (recommended approach)
# Split a 1083-character JWT token manually
export JWT_TOKEN_1="first_part_here"
export JWT_TOKEN_2="second_part_here"
export JWT_TOKEN_3="third_part_here"
# Add getEnvVar() function to your code (manual implementation)
# Use getEnvVar('JWT_TOKEN') to reconstruct automatically
Alternative Solutions ✅ WORKING
# Option 1: Store in files (for very large data)
echo "large_private_key_content" > /app/private.key
# Then read in your app: fs.readFileSync('/app/private.key', 'utf8')
# Option 2: Use external secret management
# - AWS Secrets Manager
# - HashiCorp Vault
# - Azure Key Vault
# - Google Secret Manager
Keep secrets out of git
# Always in .gitignore:
.env
.env.local
.env.production
bruvtools.yml
Use appropriate storage for data type
Test your reconstruction
// Always test that your tokens work after reconstruction
const token = getEnvVar('JWT_TOKEN');
console.log(`Token length: ${token ? token.length : 0} characters`);
if (!token || token.length < 100) {
throw new Error('JWT token reconstruction failed!');
}
| Platform | Per Variable | Total Limit | Notes |
|---|---|---|---|
| CapRover | ~1000 chars | No total limit | Hard limit, fails silently |
| Heroku | 32KB | 32KB total | Includes variable names |
| AWS Lambda | No per-var limit | 4KB total | Very restrictive |
| Docker | No hard limit | Memory dependent | Performance impact |
| Kubernetes | 1MB | No total limit | Base64 encoded in etcd |
✅ Fully Supported! bruvtools works seamlessly on Windows PowerShell.
# 1. Install both tools
npm install -g bruvtools caprover
# 2. Verify installation
bruvtools --version # Should show: 0.2.16
caprover --version # Should show: 2.x.x
# 3. Deploy normally (same as Mac/Linux)
bruvtools init
bruvtools deploy my-app
Requirements: Node.js 16+ • License: MIT • Version: 0.2.16
We welcome contributions! This is a serious open-source project focused on making deployment simple and reliable.
Made with ❤️ by the bruvtools team • Never Give Up! 🚀
FAQs
Universal Cloud Deployment CLI - Deploy Anywhere, Manage Everything
The npm package bruvtools receives a total of 19 weekly downloads. As such, bruvtools popularity was classified as not popular.
We found that bruvtools demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.
Security News
AGENTS.md is a fast-growing open format giving AI coding agents a shared, predictable way to understand project setup, style, and workflows.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.