How tegarthegreat/skifity works
Skifity is a self-hosted Kubernetes application platform: an operator connects servers, then deploys and manages apps through a web panel, CLI, or MCP assistant. The main app path runs from a user request through the API, build/deploy services, and the Kubernetes cluster; supporting capabilities include server provisioning, databases, templates, backups, authentication, and persistent state. The README documents product-level relationships; source excerpts confirm selected startup, authentication, database, backup, and MCP wiring. Unsampled relationships are not asserted beyond documented behavior.
Main entry points: api.go HTTP API · dbsvc/manager.go Managed databases · backup/manager.go Backup and restore · deployer.go Deployment
Components 20
User interfaces
- Skifity binary
cmd/skifity/main.go - Web panel
web/src/App.tsx - CLI
internal/cli/commands.go - MCP server
internal/mcpserver/server.go
Platform control
- HTTP API
internal/api/api.go - Server provisioning
internal/provision/provisioner.go - Git sources
internal/gitsrc/webhook.go - App templates
internal/templates/templates.go - Embedded docs
internal/docsite/docsite.go
App runtime
- Build detection
internal/builder/detect.go - Deployment
internal/deploy/deployer.go - Cluster management
internal/cluster/cluster.go - Managed databases
internal/dbsvc/manager.go
State and recovery
- Backup and restore
internal/backup/manager.go - Platform state
internal/store/store.go
Identity and extensions
- Authentication
internal/auth/service.go
Other components
- Operator
- AI assistant
- Kubernetes API
- S3-compatible storage
Connections 27
- Operator → Web panel: manages apps
README.md - Operator → CLI: runs commands
README.md - AI assistant → MCP server: requests tools
README.md - Skifity binary → CLI: dispatches commands
cmd/skifity/main.go - Skifity binary → MCP server: starts server
cmd/skifity/main.go - Skifity binary → Web panel: starts panel
cmd/skifity/main.go - Web panel → HTTP API: calls API
README.md - CLI → HTTP API: uses API
README.md - MCP server → CLI: uses client
internal/mcpserver/server.go - HTTP API → Authentication: authenticates
- HTTP API → Server provisioning: adds servers
README.md - HTTP API → Git sources: accepts repositories
README.md - HTTP API → App templates: installs templates
README.md - HTTP API → Deployment: requests deployment
README.md - Deployment → Build detection: builds image
README.md - Deployment → Cluster management: applies releases
README.md - Cluster management → Kubernetes API: manages resources
README.md - HTTP API → Managed databases: manages databases
README.md - Managed databases → Cluster management: reads cluster status
internal/dbsvc/manager.go - Managed databases → Platform state: stores records
internal/dbsvc/manager.go - Managed databases → Deployment: syncs linked app
internal/dbsvc/manager.go - HTTP API → Backup and restore: manages backups
README.md - Backup and restore → Cluster management: runs backup jobs
internal/backup/manager.go - Backup and restore → Platform state: records backups
internal/backup/manager.go - Backup and restore → S3-compatible storage: stores backup objects
- HTTP API → Platform state: persists platform data
- Operator → Embedded docs: reads guidance
README.md