Build on Darwa

# 1 — install
npm i -g @darwa/cli

# 2 — authenticate (opens a browser)
darwa login

# 3 — deploy the current directory
darwa deploy

# 4 — follow the logs
darwa logs --follow

services:
  - name: storefront          # web service
    type: web
    runtime: node22
    build: npm ci && npm run build
    start: npm start
    regions: [us-east, eu-central]
    scale: { min: 1, max: 8, on: cpu }

  - name: image-worker        # background worker
    type: worker
    runtime: node22
    start: node worker.js
    queue: { name: images, type: priority }
    concurrency: 20
    retries: { attempts: 5, backoff: exponential }

resources:
  - postgres: storefront-db
  - bucket: user-uploads

const port = process.env.PORT || 3000;
app.listen(port, "0.0.0.0", () => console.log(`listening on ${port}`));

darwa env set DATABASE_URL=... --env production
darwa env set LOG_LEVEL=debug     --env preview
darwa env diff staging production

{
  "redirects": [
    { "from": "/old-page", "to": "/new-page", "status": 301 },
    { "from": "/blog/:slug", "to": "/articles/:slug" }
  ],
  "rewrites": [
    { "from": "/api/*", "to": "https://api.acme.com/*" }
  ],
  "headers": [
    { "for": "/*", "set": { "X-Frame-Options": "DENY" } }
  ]
}

<img src="/hero.jpg" width="1600" height="900" alt="…" />
<!-- served as AVIF 188 KB instead of JPEG 4.2 MB -->

import { Worker } from "bullmq";

new Worker("images", async job => {
  await resize(job.data.key);
}, { connection: { url: process.env.QUEUE_URL } });

darwa schedule add nightly-export --cron "0 2 * * *" --overlap skip
darwa schedule add health-sweep   --every "5 minutes"
darwa schedule run nightly-export        # trigger once, now

agent: invoice-recovery
runtime: python3.12
entry: agents/recovery.py

triggers:
  - webhook: stripe/invoice.payment_failed
  - schedule: "0 9 * * 1-5"
  - queue: billing-events

approvals:
  - when: amount > 1000
    notify: slack#finance

from darwa import memory

profile = memory.get("customer:cus_9F21")               # long-term
memory.set("customer:cus_9F21", {"last_outcome": "recovered"})
hits = memory.search("payment failures resolved", k=5)  # semantic

darwa tools grant invoice-recovery postgres:read --tables invoices,customers
darwa tools grant invoice-recovery gmail:send   --from billing@acme.com
darwa tools deny  invoice-recovery stripe:refunds

darwa db create storefront-db --engine postgres:17 --size standard
darwa db url storefront-db --pooled
darwa db psql storefront-db          # opens a session, no tunnel needed

darwa db backups storefront-db
darwa db restore storefront-db --to "2026-08-02 14:12:09"
# restores into a NEW instance; promote it once you have verified it

import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";

const s3 = new S3Client({
  endpoint: process.env.DARWA_STORAGE_ENDPOINT,
  region: "eu-central",
});

await s3.send(new PutObjectCommand({
  Bucket: "user-uploads",
  Key: "2026/06/IMG_4482.jpg",
  Body: file,
}));

darwa storage sign user-uploads/2026/06/photo.jpg --put --expires 15m

curl https://darwa.com/api/v1/services \
  -H "Authorization: Bearer $DARWA_TOKEN"

npm i -g @darwa/cli      # or: brew install darwa/tap/darwa
darwa --version
darwa login

darwa tokens create ci-agent \
  --scope deploy:staging,logs:read,metrics:read \
  --project storefront --expires 90d