feat(infra): add SST infrastructure with Cloudflare deployment

[andrewmelchor]

Summary

Add SST v3 infrastructure with Cloudflare deployment for the webdocs site. This establishes the foundation for automated
preview deployments, staging, and production releases.

Key changes:

• SST config with Cloudflare as home provider for state management
• Stage-based domain routing (production → docs.t-req.io, dev → dev.docs.t-req.io, PR previews → pr-{N}.docs.t-req.io)
• GitHub Actions workflows for CI/CD automation
• Root tsconfig.json for SST TypeScript type definitions
• Relocated webdocs from apps/ to packages/

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring
• Chore (dependency update, build script changes, etc.)

How Has This Been Tested?

• Unit tests
• E2E tests
• Manual testing (please describe)
  Manual testing performed:
  • Deployed to personal stage (andrew) via bunx sst deploy --stage andrew
  • Verified webdocs site builds and deploys to Cloudflare Workers
  • Confirmed SST TypeScript types resolve correctly in IDE

Checklist

• I have followed the contributing guidelines
• I have performed a self-review of my own code
• I have added tests that prove my fix is effective or that my feature works
• I have updated the documentation accordingly
• My changes generate no new warnings

[github-actions]

🚀 Preview Deployment

Your changes have been deployed to:

📖 Docs: https://docs-pr-6.t-req.io

This preview will be automatically removed when the PR is closed.

[greptile-apps]

Greptile Summary

Establishes SST v3 infrastructure for automated Cloudflare deployments of the webdocs site with stage-based domain routing.

Key changes:

• SST config with Cloudflare as the home provider for state and hosting
• Three-tier deployment strategy: production (docs.t-req.io), dev (dev.docs.t-req.io), and PR previews (pr-N.docs.t-req.io)
• GitHub Actions workflows for automated CI/CD: PR previews, dev deployments on main push, manual production releases, and preview cleanup
• Root tsconfig.json added for SST TypeScript type definitions
• Webdocs relocated from apps/ to packages/ directory
• Production stage protected with removal: 'retain' and protect: true

Issues found:

• Production deployment summary displays incorrect URL (docs.t-req.dev instead of docs.t-req.io)

Confidence Score: 4/5

• Safe to merge with one minor URL typo fix needed
• Infrastructure is well-structured with proper stage protection, fork handling, and cleanup workflows. The only issue is a typo in the deployment summary URL which doesn't affect functionality
• .github/workflows/deploy-production.yml - contains incorrect production URL in deployment summary

Important Files Changed

Filename	Overview
.github/workflows/deploy-production.yml	Manual production deployment workflow with typo in summary URL
.github/workflows/deploy.yml	Automated PR preview and dev deployments with proper fork handling
sst.config.ts	SST config with Cloudflare provider and stage-based protection
infra/stage.ts	Stage-based domain routing logic for production, dev, and PR previews
infra/webdocs.ts	Cloudflare StaticSite resource for webdocs deployment

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant GH as GitHub
    participant Actions as GitHub Actions
    participant SST as SST CLI
    participant CF as Cloudflare
    participant DNS as DNS (t-req.io)

    Note over Dev,DNS: PR Preview Flow
    Dev->>GH: Open/Update Pull Request
    GH->>Actions: Trigger deploy.yml workflow
    Actions->>Actions: Install dependencies & build
    Actions->>SST: bunx sst deploy --stage pr-N
    SST->>CF: Deploy to Workers (pr-N.docs.t-req.io)
    CF->>DNS: Configure subdomain
    DNS-->>CF: DNS configured
    CF-->>SST: Deployment complete
    SST-->>Actions: Success
    Actions->>GH: Comment with preview URL

    Note over Dev,DNS: Dev Deployment Flow
    Dev->>GH: Push to main branch
    GH->>Actions: Trigger deploy.yml workflow
    Actions->>Actions: Install dependencies & build
    Actions->>SST: bunx sst deploy --stage dev
    SST->>CF: Deploy to Workers (dev.docs.t-req.io)
    CF->>DNS: Configure subdomain
    DNS-->>CF: DNS configured
    CF-->>SST: Deployment complete
    SST-->>Actions: Success

    Note over Dev,DNS: Production Deployment Flow
    Dev->>GH: Manual workflow dispatch
    GH->>Actions: Trigger deploy-production.yml
    Actions->>Actions: Install dependencies & build
    Actions->>SST: bunx sst deploy --stage production
    SST->>CF: Deploy to Workers (docs.t-req.io)
    CF->>DNS: Configure domain
    DNS-->>CF: DNS configured
    CF-->>SST: Deployment complete (retained)
    SST-->>Actions: Success
    Actions->>GH: Deployment summary

    Note over Dev,DNS: Cleanup Flow
    Dev->>GH: Close Pull Request
    GH->>Actions: Trigger cleanup.yml workflow
    Actions->>SST: bunx sst remove --stage pr-N
    SST->>CF: Remove Workers deployment
    CF-->>SST: Cleanup complete
    SST-->>Actions: Success

Loading

[greptile-apps]

_{53 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}