cling

README

(cling)

static site hosting manager designed for CI workflows (think github pages but self-hosted)

usage

cli options (not fully implemented)

[serve]         start cling server and ensure caddy webserver is running & configured
  -password       secret key for authentication
  -keep           how many old versions to keep (default 0)
  [-caddy SOCK]   path to Caddy socket, without `unix://` (default /caddysocket/caddy.sock)
push            upload website files to the server
  -password       secret key for authentication
  -server URL     cling server address
  -host HOST      website domain name
  [-root PATH]    site files root
help [cmd]      show this help

to-do lists

general

• configuration
  • environment variables
  • cli flags
• dockerize it (one image for both flows)

server

• http route
  • handle file upload
  • basic authentication
• decompress archive
• generate folder structure
• interface with caddy
  • configure routes based on folder structure (hostname and latest version)
  • generate routes for things like error pages
• delete old versions when done

client

• basic authentication
• compress archive
• make PUT request with file attached

potential future features

• multiple users