Developer Workflow Optimization

# 1. Start from a clean, up-to-date main branch
git checkout main
git pull --rebase origin main

# 2. Create a feature branch with descriptive name
git checkout -b feat/user-notifications

# 3. Make small, focused commits
git add src/components/NotificationBell.tsx
git commit -m "feat(notifications): add notification bell component"

git add src/hooks/useNotifications.ts
git commit -m "feat(notifications): add useNotifications hook"

git add src/app/api/notifications/route.ts
git commit -m "feat(notifications): add notifications API endpoint"

# 4. Push and create PR
git push -u origin feat/user-notifications
gh pr create --title "feat: add user notification system" \
  --body "## Summary
- Add notification bell component in the header
- Real-time updates via WebSocket
- Mark as read functionality

## Test plan
- [ ] Notifications appear in real time
- [ ] Marking as read updates the UI
- [ ] Works on mobile viewports"

# 5. After review, merge with squash
gh pr merge --squash --delete-branch

# Shell functions for common git workflows (~/.zshrc)

# Create feature branch from updated main
feature() {
  git checkout main &&
  git pull --rebase origin main &&
  git checkout -b "feat/$1"
}
# Usage: feature user-notifications

# Create a bugfix branch
bugfix() {
  git checkout main &&
  git pull --rebase origin main &&
  git checkout -b "fix/$1"
}
# Usage: bugfix login-redirect

# Push current branch and create a draft PR
draft() {
  local branch=$(git branch --show-current)
  git push -u origin "$branch"
  gh pr create --draft --fill
}

# Sync current branch with main (rebase)
sync() {
  local branch=$(git branch --show-current)
  git fetch origin main &&
  git rebase origin/main
}

# Clean up merged branches
cleanup() {
  git checkout main &&
  git pull &&
  git branch --merged | grep -v "main|master|*" | xargs -n 1 git branch -d
  echo "Cleaned up merged branches"
}

# .github/workflows/ci.yml
name: CI
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npm run lint
      - run: npm run typecheck

  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npm test -- --coverage
      - uses: codecov/codecov-action@v4

  build:
    runs-on: ubuntu-latest
    needs: [lint, test]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npm run build

# Use GitHub CLI to manage issues from the terminal
gh issue list --assignee @me              # My open issues
gh issue create --title "Bug: ..." --label bug  # Create issue
gh issue view 42                          # View issue details
gh pr checks                              # Check CI status
gh pr review --approve                    # Approve a PR
gh pr merge --squash                      # Merge PR

# Link commits to issues automatically
git commit -m "fix(auth): handle expired tokens

Fixes #42"  # Closes issue #42 when PR merges

# Efficient code review workflow
# 1. Checkout the PR locally for thorough review
gh pr checkout 123

# 2. Run the project to test changes
npm run dev

# 3. Run tests related to changes
npm test -- --related

# 4. Leave review comments
gh pr review 123 --comment --body "Looks good overall, a few suggestions..."
gh pr review 123 --approve

# Use direnv for automatic environment loading
# .envrc in project root
export DATABASE_URL="postgresql://localhost:5432/myapp"
export REDIS_URL="redis://localhost:6379"
export NODE_ENV="development"

# direnv automatically loads when you cd into the project
# and unloads when you leave

# Install direnv
brew install direnv
# Add to ~/.zshrc: eval "$(direnv hook zsh)"

# Allow the .envrc file
direnv allow .

// docker-compose.yml for local development services
version: "3.8"
services:
  postgres:
    image: postgres:16
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

  maildev:
    image: maildev/maildev
    ports:
      - "1080:1080"   # Web UI
      - "1025:1025"   # SMTP

volumes:
  postgres-data: