Nexlayer CLI

⚠️ Pre-Release Notice: This project is currently in early development (pre-beta). The codebase is not yet ready for production use or forking. We expect to release beta v1 in Q2 2025. Until then, the repository will remain private and invite-only.

Nexlayer CLI

Deploy Full-Stack AI Applications in Seconds ⚡️

🚀 What is Nexlayer?

Nexlayer is the fastest way to deploy full-stack AI applications with a single command.
It automates containerized full-stack AI deployments on production-ready enterprise-grade kubernetes without complex setup or infrastructure management.

🔥 Why Use Nexlayer?

🚀 Instant deployments. Infinite scale. Zero DevOps. All without Kubernetes complexity.

✅ Zero DevOps required – Deploy without managing Kubernetes or infrastructure.
✅ One-command deploys – nexlayer deploy gets your AI-powered web app live instantly.
✅ Smart project detection – nexlayer init auto-configures your full-stack application.
✅ Web-First Architecture – Optimized for web applications that leverage AI capabilities.
✅ Scales automatically – Enterprise-grade auto-scaling, no config needed.
✅ Custom domains – nexlayer domain set links your app to a domain in seconds.
✅ Simple monitoring – nexlayer info provides instant deployment insights.
✅ Comprehensive validation – nexlayer validate ensures your configuration is correct.
✅ True developer speed – No YAML headaches, just focus on your code.

🔥 From local development to internet scale in seconds—deploy full-stack AI-powered web applications, not just raw models. 🚀

⚡ Quick Start

1️⃣ Install Nexlayer CLI

Recommended: Install with the automated script (supports all features)

curl -sSL https://raw.githubusercontent.com/Nexlayer/nexlayer-cli/main/install.sh | bash

• ✅ Configures shell environment automatically
• ✅ Verifies system requirements
• ✅ Supports both global and local installation
• ✅ Better project path handling and error reporting

Alternative: Install directly using Go (minimal installation)

go install github.com/Nexlayer/nexlayer-cli@latest

• ✅ Simple one-line installation
• ✅ Uses Go's standard package management
• ⚠️ Manual shell configuration may be needed
• ⚠️ Limited to current working directory

2️⃣ Create and Initialize a Project

mkdir myapp && cd myapp
nexlayer init

• Auto-detects your framework (Next.js, React, Vue.js, Python, Go, etc.)
• Generates a nexlayer.yaml deployment file
• Sets up environment variables and dependencies

3️⃣ Validate Your Configuration

nexlayer validate

• Validates your configuration against the Nexlayer schema
• Provides detailed error messages and suggestions
• Offers auto-fix capabilities for common issues

4️⃣ Deploy Your Application

nexlayer deploy

• Instantly deploys your app to the Nexlayer AI Cloud Platform
• Handles containerization, infrastructure provisioning, and scaling
• Provides a unique URL to access your application

5️⃣ Manage Your Deployment

# Check deployment status
nexlayer info

# Set a custom domain
nexlayer domain set my-app --domain example.com

# View all active deployments
nexlayer list

💻 Command Reference

Essential Commands and Flags

Authentication Commands

Global Flags

🚀 Complete Deployment Workflow

# 1. Initialize project with interactive setup
nexlayer init --interactive

# 2. Validate configuration with detailed output
nexlayer validate --verbose

# 3. Test deployment without applying changes
nexlayer deploy --dry-run

# 4. Deploy the application
nexlayer deploy

🛠 Example: Deploying a Next.js App

Let's deploy a simple Next.js app with Nexlayer. https://github.com/Nexlayer/hello-world-nextjs

📂 Project Structure

hello-world-nextjs/
├── app/                      # Next.js application
│   ├── pages/                # Next.js pages (routes)
│   │   ├── index.tsx         # Homepage
│   │   ├── about.tsx         # Example additional page
│   ├── public/               # Static assets (images, icons, etc.)
│   │   ├── logo.png          # Example asset
│   ├── package.json          # Node.js dependencies
│   ├── next.config.ts        # Next.js configuration
│   ├── tsconfig.json         # TypeScript configuration
├── nginx/                    # NGINX configuration (Reverse Proxy)
│   ├── default.conf          # NGINX site config
│   ├── nginx.conf            # Global NGINX settings
├── Dockerfile                # Defines the container image
├── nexlayer.yaml             # Nexlayer deployment configuration
├── .gitignore                # Git ignore file
├── README.md                 # Documentation

🔧 nexlayer.yaml Configuration

application:
  name: "hello-world-nextjs"
  pods:
  - name: web
    path: /
    image: ghcr.io/nexlayer/hello-world-nextjs:v0.0.1
    servicePorts:
    - 80

Note: The definitive schema for nexlayer.yaml configuration is maintained in the yaml package, which serves as the single source of truth for all YAML configurations.

📚 Documentation

• 📖 YAML Schema – Single source of truth for nexlayer.yaml configuration
• 📡 API Reference – Manage deployments via API

💪 Contributing

We welcome contributions! Check out our Contributing Guide to get involved.

📜 License

Nexlayer CLI is MIT licensed.

🚀 Ready to Deploy?

• 🔹 Website: nexlayer.com
• 🔹 Docs: docs.nexlayer.com
• 🔹 Feedback: Join discussion