How dendianugerah/velld works
Velld is a self-hosted database-backup manager. Users authenticate, configure database connections and schedules, then review backup history to compare, restore, or manage backups; settings cover notifications and S3 storage. The API entry point wires routes, services, and repositories, while the web history view exposes comparison and restore actions. Backup scheduling and several backup internals are present in the tree but were not sampled, so their links are left unverified rather than inferred.
Main entry points: main.go HTTP server and routes · history-list.tsx Backup history · backup_service.go Backup service · settings_service.go Settings service
Components 23
Web application
- Sign-in and registration
apps/web/app/(auth)/login/page.tsx - Connection management
apps/web/components/views/connections - Backup history
apps/web/components/views/history/history-list.tsx - Settings screens
apps/web/app/settings/page.tsx - API client
apps/web/lib/api-client.ts
Identity
- Auth handlers
apps/api/internal/auth - Auth service
apps/api/internal/auth/auth_service.go - User repository
apps/api/internal/auth/auth_repository.go
Connections
- Connection handlers
apps/api/internal/connection - Connection service
apps/api/internal/connection/connection_service.go - Connection repository
apps/api/internal/connection/connection_repository.go
Backup management
- Backup handlers
apps/api/internal/backup - Backup service
apps/api/internal/backup/backup_service.go - Backup repository
apps/api/internal/backup/backup_repository.go - Backup scheduler
apps/api/internal/backup/backup_scheduler.go - S3 object storage
apps/api/internal/backup/s3_storage.go
Settings and persistence
- HTTP server and routes
apps/api/cmd/api-server/main.go - Settings service
apps/api/internal/settings/settings_service.go - Settings repository
apps/api/internal/settings/settings_repository.go - Notifications
apps/api/internal/notification/notification_service.go - SQLite database
apps/api/internal/database/database.go - Email delivery
apps/api/internal/mail/mail.go
Other components
- User
Connections 17
- User → Sign-in and registration: signs in
README.md - User → Connection management: configures databases
README.md - User → Backup history: reviews backups
README.md - Backup history → Settings screens: manages settings
- HTTP server and routes → Auth handlers: routes auth
apps/api/cmd/api-server/main.go - HTTP server and routes → Connection handlers: routes connections
apps/api/cmd/api-server/main.go - HTTP server and routes → Backup handlers: routes backups
apps/api/cmd/api-server/main.go - HTTP server and routes → Settings service: constructs service
apps/api/cmd/api-server/main.go - HTTP server and routes → Notifications: constructs service
apps/api/cmd/api-server/main.go - HTTP server and routes → SQLite database: initializes
apps/api/cmd/api-server/main.go - Auth service → User repository: reads and writes
apps/api/internal/auth/auth_service.go - Backup history → Backup history: opens compare and restore
apps/web/components/views/history/history-list.tsx - Backup service → Backup scheduler: schedule support
- Backup service → S3 object storage: optional object storage
- Backup service → Backup repository: persists backup records
- Settings service → Settings repository: stores settings
- Notifications → Email delivery: failure email