Hotfix Workflow

When to Use

• Critical production bug affecting users
• Security vulnerability discovered
• Data integrity issue

Process

Diagram source

graph LR
    Detect[Detect Issue] --> Branch[Hotfix Branch from main]
    Branch --> Fix[Implement Fix]
    Fix --> Test[Fast Test]
    Test --> PR[PR to main]
    PR --> Deploy[Deploy to Prod]
    Deploy --> Backport[Merge to develop]

Steps

1. Create Hotfix Branch

git checkout main
git pull
git checkout -b hotfix/issue-description

2. Implement Fix

• Focus on the minimal fix only
• No refactoring or feature additions
• Add a regression test

3. Test

yarn test
yarn test:e2e  # if time permits

4. Deploy

# Fast-track PR review
# Merge to main
# CI/CD auto-deploys to production

5. Backport

git checkout develop
git merge hotfix/issue-description
git push

6. Post-Mortem

Related Pages

• Release Management — releases
• Incident Response — incident handling
• Git Workflow — branching