Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ ProdReady - Code Security & SEO Audit for AI Code

ProdReady Logo

Your Copilot Writes. We Verify.

License: MIT JavaScript TypeScript

Live Demo โ€ข Documentation โ€ข Contributing โ€ข Report Bug


The "Vibe Coder" Problem:

AI coding assistants (Cursor, GitHub Copilot, ChatGPT, v0, Bolt) overwhelmingly generate code in Next.js and React because:

  • ๐Ÿ“Š 80%+ of AI-generated web apps use Next.js or React
  • ๐Ÿค– LLM training data is heavily weighted toward these frameworks
  • ๐Ÿš€ "Vibe coders" (developers who rely heavily on AI) primarily ship in this stack

Our Mission: Catch the security holes and SEO gaps that AI assistants create before you deploy.

While all JavaScript/TypeScript projects are supported, we've optimized our rules for the frameworks where AI makes the most mistakes. As AI coding expands to other languages, so will ProdReady.

๐Ÿš€ So, What is ProdReady?

ProdReady is an open-source security, SEO, and code quality scanner for JavaScript/TypeScript projects. It performs 50+ automated checks in seconds to catch issues that AI coding assistants often miss before you deploy to production.

Optimized for Next.js with full support for React, Vue, Node.js, and any JS/TS codebase.

๐ŸŽฏ Supported Languages & Frameworks

Language/Framework Support Level Notes
Next.js โœ… Full Optimized with framework-specific checks
React โœ… Full Component-level security & accessibility
TypeScript โœ… Full Type safety checks, any detection
JavaScript โœ… Full ES6+, CommonJS, ESM
Vue.js โš ๏ธ Partial JS/TS checks work, framework checks planned
Node.js โš ๏ธ Partial Security checks work, API-specific checks planned
Svelte โš ๏ธ Partial Basic checks only
Angular โš ๏ธ Partial Basic checks only
Python/Ruby/Go ๐Ÿ”œ Planned Coming in future versions

๐Ÿ”“ GitHub Repository Access

Current Version (v1.0):

  • โœ… Public repositories - Full access, no authentication required
  • โŒ Private repositories - Not supported yet

Why? The scanner uses GitHub's public API without authentication. This is perfect for open-source projects but can't access private repos.

Coming Soon (Phase 3):

  • ๐Ÿ”œ GitHub OAuth integration
  • ๐Ÿ”œ Personal access token support
  • ๐Ÿ”œ Scan your private repositories securely
  • ๐Ÿ”œ Team/organization repository access

Workaround for Private Repos:

  1. Clone your repo locally
  2. Run ProdReady locally (see Local Setup)
  3. Point scanner to local directory (feature coming soon)

โš ๏ธ The Problem: AI Writes Fast, But Ships Vulnerabilities Faster

AI coding assistants (Cursor, GitHub Copilot, ChatGPT, v0, Bolt) are revolutionizing development speed, but they're also creating a new class of security and quality issues:

What AI Does Wrong Why It Matters Real Impact
๐Ÿ”‘ Exposed API keys Hardcodes secrets in code โ†’ Unauthorized access, $1000s in API bills
๐Ÿ•ณ๏ธ Missing input validation Skips sanitization โ†’ Injection attacks, data breaches
๐Ÿ› Debug code in production Leaves console.logs, test routes โ†’ Exposes internal logic to attackers
๐Ÿ” No SEO metadata Forgets <title>, OG tags โ†’ Invisible to Google, no social shares
๐Ÿ”“ Hardcoded secrets Commits .env values โ†’ Scraped from public repos in minutes
โ™ฟ Poor accessibility Missing alt text, ARIA labels โ†’ Excludes users, violates WCAG
๐ŸŽจ Inline styles everywhere Hardcoded colors, magic numbers โ†’ Unmaintainable, inconsistent UI
๐Ÿ—‘๏ธ Zombie code Unused imports, empty components โ†’ Bloated bundles, slower load times

The "Vibe Coder" Reality:

  • โœ… AI writes your app in hours instead of weeks
  • โŒ But ships with security holes you won't notice until it's too late
  • ๐Ÿšจ 68% of AI-generated code has at least one security issue (GitHub, 2024)

ProdReady is your safety net. Scan before you ship, catch what AI missed, deploy with confidence.


โœจ Features

๐Ÿ”’ Security Scanning (20+ Checks)

  • API Key Detection - Finds exposed OpenAI, Stripe, AWS, and other API keys
  • Secret Scanning - Detects hardcoded credentials and tokens
  • XSS Prevention - Identifies dangerous dangerouslySetInnerHTML usage
  • .env File Protection - Ensures environment files are gitignored
  • Input Validation - Checks for missing form validation
  • External Link Safety - Detects unsafe target="_blank" without rel="noopener"

๐Ÿ” SEO & Accessibility (15+ Checks)

  • Metadata Validation - Ensures proper <title>, <meta> tags
  • OpenGraph Tags - Verifies social media preview configuration
  • Image Alt Text - Finds images missing accessibility attributes
  • Semantic HTML - Detects div soup and missing semantic elements
  • robots.txt & sitemap.xml - Checks for essential SEO files
  • Favicon Verification - Ensures custom branding is in place

๐Ÿงน Code Hygiene (15+ Checks)

  • Console.log Detection - Finds debug statements in production code
  • Unused Imports - Identifies zombie imports bloating your bundle
  • TODO Comments - Flags unfinished work before deployment
  • TypeScript Safety - Detects dangerous any types
  • Hardcoded Values - Finds hardcoded colors, URLs, and magic numbers
  • Empty Components - Identifies components that return null

๐ŸŽฏ Why ProdReady?

Feature ESLint IDE Tools ProdReady
Security vulnerability detection โš ๏ธ Partial โš ๏ธ Partial โœ… Full
SEO & accessibility checks โŒ None โŒ None โœ… Full
Cross-file analysis โš ๏ธ Partial โš ๏ธ Partial โœ… Full
Zero configuration โŒ None โš ๏ธ Partial โœ… Full
Pre-launch checklist โŒ None โŒ None โœ… Full
Actionable fix guides โš ๏ธ Partial โš ๏ธ Partial โœ… Full
Works on any public repo โŒ None โŒ None โœ… Full

ProdReady complements your existing tools - it's not a replacement, it's your final check before shipping.


๐Ÿš€ Quick Start

Option 1: Use the Web App (No Installation)

  1. Visit prod-ready-navy.vercel.app
  2. Paste your GitHub repository URL
  3. Get your security report in 30 seconds

Option 2: Run Locally

# Clone the repository
git clone https://github.com/MrForward/ProdReady.git
cd prodready

# Install dependencies
npm install

# Set up environment variables
cp env.example.txt .env.local
# Add your Supabase credentials (optional for email capture)

# Run development server
npm run dev

# Open http://localhost:3000

Option 3: Deploy Your Own Instance

Deploy with Vercel

See Deployment Guide for detailed instructions.


๐Ÿ“– How It Works

  1. Paste Repository URL - Any public GitHub repository
  2. Instant Scan - 50+ checks run automatically in 30 seconds
  3. Get Report - See every issue with severity, location, and fix guide
  4. Fix Issues - Copy AI-ready prompts for your coding assistant

Example Output

๐ŸŽฏ Vibe Score: 81/100 (Grade B)
โœ… 16 Checks Passed
โŒ 3 Issues Found

๐Ÿ”ด CRITICAL: Exposed API Key
   File: src/lib/openai.ts:12
   Fix: Move to environment variable

๐ŸŸก MEDIUM: Missing Alt Text
   File: src/components/hero.tsx:45
   Fix: Add descriptive alt attribute

๐ŸŸข LOW: Console.log in Production
   File: src/app/page.tsx:89
   Fix: Remove or use proper logging

๐Ÿ› ๏ธ Technology Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript 5
  • Styling: Tailwind CSS 4
  • UI Components: Radix UI
  • Database: Supabase (PostgreSQL)
  • Deployment: Vercel
  • Scanner Engine: Custom AST analysis + GitHub API

๐Ÿ“š Documentation

For Users

For Developers


๐Ÿค Contributing

We welcome contributions! ProdReady is open-source and community-driven.

Ways to Contribute

  1. Add New Security Rules - Help us detect more vulnerabilities
  2. Improve Fix Guides - Make our recommendations more actionable
  3. Report Bugs - Found an issue? Open an issue
  4. Improve Documentation - Help others understand ProdReady
  5. Spread the Word - Star the repo, share on Twitter

Development Setup

# Fork and clone the repository
git clone https://github.com/YOUR_USERNAME/ProdReady.git

# Install dependencies
npm install

# Create a branch
git checkout -b feature/your-feature-name

# Make your changes and test
npm run dev
npm run build

# Submit a pull request

See CONTRIBUTING.md for detailed guidelines.


๐ŸŽฏ Use Cases

For Solo Developers

  • โœ… Catch security issues before deployment
  • โœ… Ensure SEO best practices
  • โœ… Clean up AI-generated code

For Teams

  • โœ… Pre-deployment checklist in CI/CD
  • โœ… Code review automation
  • โœ… Onboarding new developers

For Agencies

  • โœ… Client project audits
  • โœ… Quality assurance
  • โœ… Competitive analysis

๐Ÿ“Š Roadmap

โœ… Phase 1: Core Scanner (Complete)

  • 50+ security, SEO, and hygiene checks
  • GitHub integration
  • Real-time scanning
  • Detailed reports with fix guides

๐Ÿšง Phase 2: Auto-Fix (In Progress)

  • One-click AI-powered fixes
  • Pull request generation
  • Batch issue resolution

๐Ÿ“… Phase 3: CI/CD Integration (Planned)

  • GitHub OAuth - Scan private repositories
  • Personal Access Tokens - Secure authentication
  • GitHub Actions integration
  • GitLab CI support
  • Slack/Discord notifications
  • API for custom integrations

๐Ÿ”ฎ Phase 4: Multi-Language Support (Future)

  • Python support (Django, Flask)
  • Ruby support (Rails)
  • Go support
  • PHP support (Laravel)
  • Java/Kotlin support

๐ŸŒŸ Phase 5: Advanced Features (Future)

  • Custom rule creation
  • Team collaboration
  • Historical tracking
  • Performance benchmarking

Vote for which feature you want next โ†’


๐ŸŒŸ Why Open Source?

We believe security and code quality tools should be:

  • Transparent - You can see exactly what we check
  • Trustworthy - No black box algorithms
  • Customizable - Add your own rules
  • Free - No paywalls for basic security

ProdReady will always be free and open-source.


๐Ÿ“„ License

ProdReady is MIT licensed.


๐Ÿ™ Acknowledgments

Built with:


๐Ÿš€ Get Started

Ready to ship production-ready code?

  1. Try it now: prod-ready-navy.vercel.app
  2. Star the repo: Help others discover ProdReady
  3. Share feedback: Open an issue

Made with โค๏ธ by product manager, for developers and vibecoders

Website โ€ข GitHub โ€ข Twitter

About

The quality gate for AI-generated code. Instantly transforms messy prototypes into secure, production-ready applications by detecting secret leaks and SEO gaps that LLMs miss.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages