A modern e-commerce storefront built with Node.js and Express, featuring a premium dark luxury UI, real-time cart management, and integrated observability via Sentry and Datadog.

• Storefront UI — Dark luxury aesthetic with Cormorant Garamond typography, gold accents, and smooth animations
• Product Catalog — Browse and search products across widgets, gadgets, tools, and accessories
• Cart & Checkout — Slide-out cart drawer with quantity management and full checkout flow
• Observability — Integrated Sentry error tracking and Datadog APM/metrics/logs
• Automated Alerts — Sentry webhook integration that auto-creates investigation sessions on errors

• Node.js 18+
• Docker and Docker Compose
• Sentry account (for error tracking)
• Datadog account (for APM and metrics)

cp .env.example .env

Set the following in .env:

docker-compose up --build -d

This starts three services:

• checkout-api — Express app on port 3000
• loadgen — Synthetic traffic generator
• datadog-agent — APM traces, metrics, and log collection

curl http://localhost:3000/health

Open http://localhost:3000 in your browser to view the storefront.

npm install
npm start

                        ┌─────────────┐
 Internet ──▶ DNS ──▶   │   nginx     │  :80 (→ HTTPS redirect)
                        │   (SSL)     │  :443 (SSL termination)
                        └──────┬──────┘
                               │ proxy_pass
┌─────────────────┐     ┌──────┴───────────┐     ┌─────────────────┐
│  Traffic         │────▶│  Checkout API    │────▶│  Sentry         │
│  Generator       │     │  (Express/Node)  │────▶│  Datadog Agent  │
│  (loadgen)       │     │  :3000 (internal)│     │  (APM + Logs)   │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                              │
                              ▼
                        ┌──────────────┐
                        │  Devin API   │──────▶  Slack #alerts
                        │  (auto-fix)  │        (session updates)
                        └──────────────┘

cp .env.example .env
# Fill in SENTRY_DSN, DD_API_KEY, DD_SITE, SLACK_BOT_TOKEN, SLACK_CHANNEL_ID
# Set DOMAIN_NAME and CERT_EMAIL for SSL
# Set DEVIN_TRIGGER_MODE=api and DEVIN_API_KEY for direct API mode
# Or set DEVIN_TRIGGER_MODE=slack (default) with SLACK_USER_TOKEN for @mention mode
docker-compose up --build -d

This starts five services:

• nginx — Reverse proxy with SSL termination (ports 80/443)
• checkout-api — Express app (port 3000, internal only)
• certbot — Automatic Let's Encrypt certificate renewal
• loadgen — Synthetic traffic generator
• datadog-agent — APM traces, metrics, and log collection

1. Point a DNS A record to your EC2 public IP
2. Open ports 80 and 443 in the security group
3. Set DOMAIN_NAME and CERT_EMAIL in .env
4. Run bash scripts/init-ssl.sh once to obtain the initial SSL certificate
5. Certificates auto-renew via certbot every 12 hours

See AGENTS.md for detailed instructions.

Redeploying to EC2: See the detailed redeploy steps in AGENTS.md. The key requirement is to back up the .env file before extracting a new tarball — if the .env is lost, Slack alerts and all integrations will silently stop working.

Error tracking with automatic alert rules:

• Checkout Error Spike — Triggers on elevated error rates
• New Issue on Release — Triggers on first-seen issues
• Regression Detected — Triggers when a resolved issue reappears

APM tracing, custom metrics, and structured logging:

• APM Traces — Full distributed tracing for all requests
• Custom Metrics — Checkout success/failure counters, latency histograms
• Logs — Structured JSON logs with trace correlation

When a Sentry alert fires, the /webhooks/sentry endpoint automatically creates a Devin session to investigate the error. The session includes:

• Full error details (type, message, stack trace location, severity)
• Occurrence metadata (first/last seen, event count, release, environment)
• Tags and extra context from the Sentry event
• Instructions to use Sentry and Datadog MCP integrations for investigation

When configured, alerts are also posted to a Slack channel with rich Block Kit formatting:

• Initial alert — Error details, severity, release, and buttons to view the Devin session and Sentry issue
• Session updates — Status changes (running, blocked, completed) posted as thread replies
• PR notifications — When Devin creates a fix PR, the link is posted to the thread
• Completion — Final message with link to the full investigation session

Requires SLACK_BOT_TOKEN and SLACK_CHANNEL_ID environment variables.

# Create Datadog dashboard
DD_API_KEY=xxx DD_APP_KEY=xxx DD_SITE=us5.datadoghq.com node scripts/setup-datadog-dashboard.js

# Create Sentry alert rules
SENTRY_AUTH_TOKEN=xxx SENTRY_ORG=xxx SENTRY_PROJECT=xxx node scripts/setup-sentry-alerts.js

Private — internal use only.