Project Structure

Understand the SkyPort repository layout and runtime boundaries.

SkyPort keeps the repository split into a small number of clearly defined surfaces.

package.json

{
  "name": "skyport",
  "version": "1.0.0",
  "description": "Self-hosted infrastructure platform",
  "private": true
}

Backend

The backend owns API routes, WebSocket streams, runtime collection, and host integration.

backend/cmd/server/main.go

package main

func main() {
    // Backend server entry point
}

The CLI provides the operator-facing command surface.

cli/main.go

package main

import (
    "log"

    "skyport-cli/cmd"
)

func main() {
    if err := cmd.Execute(); err != nil {
        log.Fatal(err)
    }
}

The CLI stores its local state under ~/.skyport/.

~/.skyport/config.yaml

# SkyPort CLI configuration
host: localhost
port: 8080
token: ""
authenticated: false

Quick Start

Start SkyPort locally or on a VPS and verify the main workflows.

First Deployment

Walk through a real SkyPort deployment flow from project to logs.