PRE_PUSH_CHECKLIST.md

Pre-Push Checklist

Before pushing to GitHub, ensure the following:

✅ Security Checks

• No .env files are committed (check with git ls-files | grep .env)
• No hardcoded secrets in code (only fallback defaults for local dev)
• No API keys or credentials in code
• Database URLs use environment variables
• All sensitive configs use process.env with fallbacks only for local dev

✅ Code Quality

• TypeScript compiles without errors (npx tsc --noEmit)
• No console.log statements in production code
• No TODO/FIXME comments without issue references
• Code follows project style guidelines

✅ Files & Directories

• node_modules/ is in .gitignore
• dist/ and build/ directories are ignored
• .DS_Store and other OS files are ignored
• Log files are ignored
• Generated Prisma files are handled correctly

✅ Documentation

• README.md is up to date
• API endpoints are documented
• Environment variables are documented
• Setup instructions are clear

✅ Git

• Meaningful commit messages
• No large files (>100MB)
• No merge conflicts
• Branch is up to date with main/develop

Quick Commands

# Check for secrets
grep -r "supersecretlocal\|refreshsecret" --include="*.ts" --include="*.js" services/ libs/

# Check for .env files
git ls-files | grep .env

# Type check
npx tsc --noEmit

# Check git status
git status

# Verify .gitignore is working
git check-ignore -v libs/prisma/.env