How shivanshks06/skyforge works
SkyForge is a web application for deploying GitHub projects into each user's AWS account, then monitoring, securing, and tearing down those deployments. The main workflow runs from project selection and planning in the browser, through API-enqueued deployment jobs, to worker-managed builds and AWS provisioning; health checks gate the LIVE state. Separate product branches cover security controls and incident response, monitoring and recovery, rollback, and verified destruction. The graph follows documented and indexed relationships; unsampled subsystems are included where README describes them, with uncertain wiring omitted.
Main entry points: deploymentWorker.js Deployment worker · server.js Express API · deploymentController.js Deployment requests · db.js Project state
Components 34
Web client
- SkyForge UI
client/src/App.jsx - Project workflow
client/src/pages/DeploymentPlan.jsx - Deployment console
client/src/pages/DeploymentConsole.jsx - Security dashboard
client/src/pages/Security.jsx
API and data
- Express API
server/server.js - Authentication
server/middleware/authMiddleware.js - Project management
server/controllers/projectController.js - Planning and environment
server/controllers/planningController.js - Deployment requests
server/controllers/deploymentController.js - Project state
server/config/db.js - AWS connections
server/services/awsConnectionService.js
Build and deploy
- Job queues
server/queues/deploymentQueue.js - Deployment worker
server/workers/deploymentWorker.js - Repository checkout
server/services/sourceService.js - Stack detection
server/services/detectionEngine.js - Environment scan
server/services/envScanner.js - Build planning
server/services/buildPlanner.js - Docker templates
server/services/templateEngine.js - Image registry
server/services/ecrService.js - Container deployment
server/services/ecsService.js - Static deployment
server/services/staticDeployer.js - Health checks
server/services/healthService.js
Operations
- Monitoring worker
server/workers/monitorWorker.js - Monitor schedule
server/queues/monitorQueue.js - Rollback worker
server/workers/rollbackWorker.js - Destroy workflow
server/workers/destroyWorker.js
Security
- Security controls
server/controllers/securityController.js - Security scanning
server/services/securityService.js - Security automation
server/services/securityAutomation.js - WAF protection
server/services/wafService.js - Incident response
server/services/incidentService.js
Other components
- Project operator
- GitHub
- User AWS account
Connections 47
- Project operator → SkyForge UI: uses
README.md - SkyForge UI → Project workflow: navigates
client/src/App.jsx - SkyForge UI → Deployment console: navigates
client/src/App.jsx - SkyForge UI → Security dashboard: navigates
client/src/App.jsx - Project workflow → Express API: requests plans
- Deployment console → Express API: requests deploy
- Security dashboard → Express API: requests controls
- Express API → Authentication: protects routes
server/server.js - Express API → Project management: routes to
server/server.js - Express API → Planning and environment: routes to
- Express API → Deployment requests: routes to
server/server.js - Authentication → Project state: looks up user
server/middleware/authMiddleware.js - Project management → Project state: reads and writes
server/controllers/projectController.js - Planning and environment → Project state: reads and writes
- Deployment requests → Job queues: enqueues jobs
server/controllers/deploymentController.js - Deployment requests → Project state: records deployment
server/controllers/deploymentController.js - Deployment worker → Job queues: consumes jobs
- Deployment worker → Project state: updates deployment
server/workers/deploymentWorker.js - Deployment worker → AWS connections: resolves credentials
server/workers/deploymentWorker.js - Deployment worker → Repository checkout: checks out source
server/workers/deploymentWorker.js - Repository checkout → GitHub: downloads repository
- Deployment worker → Environment scan: checks requirements
server/workers/deploymentWorker.js - Deployment worker → Build planning: plans build
server/workers/deploymentWorker.js - Build planning → Stack detection: detects stack
- Build planning → Docker templates: generates Dockerfile
server/services/templateEngine.js - Deployment worker → Image registry: pushes image
server/workers/deploymentWorker.js - Deployment worker → Container deployment: provisions container
server/workers/deploymentWorker.js - Deployment worker → Static deployment: deploys static site
server/workers/deploymentWorker.js - Container deployment → User AWS account: creates AWS resources
- Static deployment → User AWS account: creates S3 and CDN
- Deployment worker → Health checks: checks live health
server/workers/deploymentWorker.js - Health checks → Deployment worker: returns health result
server/workers/deploymentWorker.js - Monitor schedule → Monitoring worker: schedules checks
server/queues/monitorQueue.js - Monitoring worker → Health checks: checks availability
server/workers/monitorWorker.js - Monitoring worker → Security automation: runs security jobs
server/workers/monitorWorker.js - Deployment requests → Rollback worker: queues rollback
- Rollback worker → Container deployment: restores deployment
server/workers/rollbackWorker.js - Deployment requests → Destroy workflow: queues teardown
- Destroy workflow → Container deployment: removes resources
- Destroy workflow → Static deployment: removes static resources
- Express API → Security controls: routes security
- Security controls → Security scanning: runs checks
server/controllers/securityController.js - Security controls → Incident response: lists incidents
server/controllers/securityController.js - Security scanning → WAF protection: configures firewall
server/services/securityService.js - Security automation → WAF protection: syncs protection
server/services/securityAutomation.js - Security automation → Incident response: records incidents
server/services/securityAutomation.js - Security scanning → User AWS account: scans deployed app