Skip to content

Team Helios is building a ship-readiness checker for GitHub projects. Analyzes deployment health, security, docs, and DX. Outputs a Ship Score (0-100) and auto-generates PRs with fixes.

License

Notifications You must be signed in to change notification settings

nife-codes/shipshield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

79 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShipShield

Ship-readiness checker for GitHub projects. Analyzes deployment health, security, docs, and developer experience. Outputs a Ship Score (0-100) and auto-generates PRs with fixes.

🔗LIVE DEMO | 🔗LIVE BACKEND

How It Works

  1. Paste a GitHub repo URL
  2. ShipShield scans the repo across 4 categories
  3. Get a Ship Score (0-100) with specific issues flagged
  4. Auto-generate a PR that fixes the problems

Scoring Categories

  • Deployment Reality (25 pts) - Response time, HTTPS, console errors
  • Repo Credibility (25 pts) - Commit patterns, contributors, README quality
  • Production Safety (25 pts) - Secrets, LICENSE, .env.example, .gitignore
  • Developer Experience (25 pts) - Setup complexity, documentation, helper scripts

Tech Stack

  • Frontend: React + Tailwind
  • Backend: Node.js + Express
  • APIs: GitHub (Octokit), Puppeteer
  • Database: Firebase (Firestore)
  • Hosting: Vercel

Live App

Local Setup

See backend/README.md for backend setup. See frontend/README.md for frontend setup.

Team

  • Nife: Backend - scoring engine, GitHub API
  • Israel: Backend - PR generation, deployment checks, Firebase
  • Idris: Frontend lead - dashboard, UI/UX
  • Ife: Frontend - visualization, animations

License

MIT

About

Team Helios is building a ship-readiness checker for GitHub projects. Analyzes deployment health, security, docs, and DX. Outputs a Ship Score (0-100) and auto-generates PRs with fixes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages