Deploy Check

Deploy Check

Purpose

Prevent shipping broken code to production.

Checks:

• ✅ Build succeeds
• ✅ TypeScript compiles
• ✅ i18n synchronized (zh-TW ↔ en)
• ✅ No critical errors

Quick Checklist

1. Build Verification

npm run build

Must pass:

• Build completes (no errors)
• No TypeScript errors
• All routes generated

Common issues:

• Type errors → Fix TypeScript types
• Module not found → Check imports
• Image optimization → Check file sizes

2. TypeScript Check

npx tsc --noEmit

Must pass:

• Zero type errors
• All components typed correctly

3. i18n Synchronization

# Invoke i18n-sync skill
Skill(skill="i18n-sync")

Must pass:

• messages/zh-TW.json valid
• messages/en.json valid
• All keys synchronized
• No missing translations

Auto-fix: If i18n-sync fails, it will report missing keys. Fix before deploying.

4. Route Accessibility

Test both locales:

zh-TW:
- [ ] /zh-TW (home)
- [ ] /zh-TW/projects
- [ ] /zh-TW/speaking
- [ ] /zh-TW/about

en:
- [ ] /en (home)
- [ ] /en/projects
- [ ] /en/speaking
- [ ] /en/about

Quick test:

npm run dev
# Visit each route manually

5. Responsive Design

Test viewports:

• Mobile (375px)
• Tablet (768px)
• Desktop (1440px)

Key checks:

• Navigation works on all sizes
• Images scale correctly
• Text readable (no overflow)

Deployment Flow

1. Pre-deployment checks:
   - Run this skill (deploy-check)
   - Fix any failures

2. Commit and push:
   - git add .
   - git commit -m "feat: description"
   - git push

3. Vercel auto-deploys:
   - Monitor build logs
   - Check deployment URL

4. Post-deployment:
   - Verify production site
   - Test both languages
   - Check all critical pages

Integration

Works with:

• i18n-sync - Translation validation
• content-update - Content changes
• Git hooks - Auto-check before push

Invoked by:

• BeforePush hook (recommended)
• Manual: /deploy-check command
• Auto: Keywords (deploy, push, 部署)

Common Failures

Build Fails

Error: Type 'X' is not assignable to type 'Y'
→ Fix TypeScript types
→ Re-run: npm run build

i18n Mismatch

Missing in en.json: projects.newproject.title
→ Add translation key
→ Re-run: Skill(skill="i18n-sync")

Route 404

Page /speaking/event-slug not found
→ Check dynamic routes
→ Verify slug naming

Emergency Skip

ONLY if absolutely necessary:

# Skip pre-deployment checks (NOT RECOMMENDED)
git push --no-verify

When to skip:

• ⚠️ Hotfix for critical production bug
• ⚠️ Content-only change (no code)
• ⚠️ Emergency security patch

Never skip for:

• ❌ New features
• ❌ Refactoring
• ❌ Dependencies update

Success Output

✅ Deploy Check: PASS

Build: ✅ Success (3.2s)
TypeScript: ✅ No errors
i18n: ✅ Synchronized (zh-TW ↔ en)
Routes: ✅ All accessible

🚀 Ready to deploy!

Version: 2.0 (Simplified) Project: young-personal-site Last Updated: 2024-12-31