@bernerspace/cli

A powerful command-line interface for deploying applications to the cloud with automatic HTTPS, container building, and infrastructure management.

What is Bernerspace?

Bernerspace is a streamlined deployment platform that enables developers to quickly deploy applications to the cloud. The CLI tool handles everything from packaging your code to setting up Kubernetes deployments with automatic HTTPS certificates.

Key Features

✅ One-Command Deploy - Deploy any application with bernerspace init
✅ Auto HTTPS - Automatic SSL certificate provisioning
✅ Multi-Language Support - Python, JavaScript/TypeScript, and more
✅ GitHub Integration - Secure OAuth authentication
✅ Container Building - No Docker required locally
✅ Environment Management - Secure configuration handling

Quick Start

Installation

npm install -g @bernerspace/cli

Deploy Your First App

# Navigate to your project directory
cd my-awesome-app

# Initialize and deploy
bernerspace init

That's it! The CLI will:

1. Authenticate you via GitHub OAuth
2. Auto-detect your application type
3. Package and upload your code
4. Build a container image in the cloud
5. Deploy to Kubernetes with HTTPS

Commands

bernerspace init

Initialize and deploy a project. This is the main command that handles the complete deployment workflow:

• Authentication: GitHub OAuth login (if not already authenticated)
• Project Setup: Create new project or select existing one
• Auto-Detection: Automatically detects language and checks for Dockerfile
• Environment Setup: Configure environment variables for deployment
• Deploy: Triggers automatic build and deployment process

bernerspace details

View your stored authentication details and current project information.

bernerspace logout

Clear authentication credentials and log out from Bernerspace.

How It Works

Your Code → CLI Package → Cloud Build → Kubernetes → Live HTTPS URL

1. Upload: CLI packages your application and uploads to Google Cloud Storage
2. Build: Kaniko builder creates container image in Kubernetes cluster
3. Deploy: Automatic creation of Kubernetes resources (Deployment, Service, Ingress)
4. Expose: Ingress controller provisions load balancer and HTTPS certificates
5. Live: Your application is accessible via public HTTPS URL

Supported Languages

• Python (Django, Flask, FastAPI, etc.)
• JavaScript/TypeScript (Node.js, Express, React, Next.js, etc.)
• Any language with a Dockerfile

Configuration

The CLI stores configuration locally:

• macOS: ~/.bernerspace/config.json
• Linux: ~/.config/bernerspace/config.json
• Windows: %APPDATA%\bernerspace\config.json

Prerequisites

• Node.js 20+
• GitHub account (for authentication)
• Internet connection

Examples

Deploy a Python Flask App

cd my-flask-app
bernerspace init
# Follow the prompts to configure environment variables
# Your app will be live at https://your-app.ideabrowse.com

Deploy a Node.js Express App

cd my-express-app
bernerspace init
# CLI auto-detects Node.js and handles the deployment

Deploy with Custom Dockerfile

cd my-custom-app
# Make sure you have a Dockerfile in your project root
bernerspace init
# CLI will use your existing Dockerfile

Troubleshooting

Authentication Issues

bernerspace logout
bernerspace init

Command Not Found

Make sure the CLI is installed globally:

npm install -g @bernerspace/cli

Deployment Failures

Check that your application:

• Has a valid package.json, requirements.txt, or Dockerfile
• Exposes the correct port (usually 3000, or 80)
• Has all necessary environment variables configured

Contributing

We welcome contributions! Please see our GitHub repository for:

• Source code
• Issue tracking
• Development setup
• Contribution guidelines

Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 GitHub Discussions

License

ISC License - see the LICENSE file for details.

Built with ❤️ by the Bernerspace team