README
¶
servd
Run and manage many local development servers at once. servd gives registered web projects stable backend ports and routes them by exact hostname through one local proxy.
Get started
brew install reidransom/tap/servd
servd version
See the full servd documentation for installation methods, quick start, command selection, hostname routing, dashboard operation, automation, and remote access.
Contributing
go build ./... && go vet ./... && go test ./... -race
MIT licensed. Maintained by r2ware.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
servd
command
Command servd runs and manages many local dev servers at once.
|
Command servd runs and manages many local dev servers at once. |
|
internal
|
|
|
app
Package app holds small helpers shared by the CLI commands and the TUI (which can't import each other).
|
Package app holds small helpers shared by the CLI commands and the TUI (which can't import each other). |
|
buildinfo
Package buildinfo resolves and formats servd's build metadata.
|
Package buildinfo resolves and formats servd's build metadata. |
|
commands
Package commands wires up the servd CLI (Cobra) and its subcommands.
|
Package commands wires up the servd CLI (Cobra) and its subcommands. |
|
config
Package config loads and persists servd's settings and the site registry.
|
Package config loads and persists servd's settings and the site registry. |
|
flock
Package flock provides advisory file locking for servd's read-modify-write cycles on its persistent files (state.json, sites.toml).
|
Package flock provides advisory file locking for servd's read-modify-write cycles on its persistent files (state.json, sites.toml). |
|
hostnames
Package hostnames composes and validates the DNS names served by servd.
|
Package hostnames composes and validates the DNS names served by servd. |
|
hostsfile
Package hostsfile manages the servd-owned block in the system hosts file.
|
Package hostsfile manages the servd-owned block in the system hosts file. |
|
launcher
Package launcher resolves registered sites into concrete commands.
|
Package launcher resolves registered sites into concrete commands. |
|
mdns
Package mdns publishes servd mDNS hostnames for the lifetime of the proxy.
|
Package mdns publishes servd mDNS hostnames for the lifetime of the proxy. |
|
netcheck
Package netcheck has small TCP port probes shared by site registration, doctor, and the proxy control code.
|
Package netcheck has small TCP port probes shared by site registration, doctor, and the proxy control code. |
|
proxy
Package proxy is an exact-host routing reverse proxy.
|
Package proxy is an exact-host routing reverse proxy. |
|
registration
Package registration registers individual projects with stable slugs and available ports.
|
Package registration registers individual projects with stable slugs and available ports. |
|
state
Package state tracks the latest supervised runtime attempt for dev servers.
|
Package state tracks the latest supervised runtime attempt for dev servers. |
|
supervisor
Package supervisor starts, stops and inspects dev-server processes.
|
Package supervisor starts, stops and inspects dev-server processes. |
|
tui
Package tui implements servd's interactive dashboard (Bubble Tea).
|
Package tui implements servd's interactive dashboard (Bubble Tea). |
Click to show internal directories.
Click to hide internal directories.