Skip to content

feat(docs): dynamic open graph images for /integrations - #1684

Merged
cmpadden merged 6 commits into
mainfrom
feat/integrations-og-images
Aug 5, 2026
Merged

feat(docs): dynamic open graph images for /integrations#1684
cmpadden merged 6 commits into
mainfrom
feat/integrations-og-images

Conversation

@cmpadden

@cmpadden cmpadden commented Aug 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

Follow-up to #1612.

The integrations directory and detail pages currently fall back to the site-wide social image, so shared integration links do not identify the integration being shared. This adds route-specific Open Graph and X images for /integrations and /integrations/[slug].

Integration detail images use a partnership-style composition with the eve wordmark and the selected integration logo. Multicolor SVGs are converted to tonal monochrome while preserving internal detail, then rasterized and cropped to their visible bounds so intrinsic SVG padding does not skew optical alignment. Logo sizing uses dampened ink-density normalization against the eve wordmark, balancing solid and lightweight marks without making compact logos too small. Metadata such as SVG titles is omitted, native aspect ratios are preserved, and content stays within a 60px social-image safe area. The template social images introduced in #1612 remain unchanged.

Validation

  • pnpm exec oxfmt --check apps/docs/app/'[lang]'/integrations/opengraph-image.tsx apps/docs/app/'[lang]'/integrations/twitter-image.tsx apps/docs/lib/integrations/directory-og-image.tsx apps/docs/lib/integrations/og-image.tsx
  • pnpm exec oxlint apps/docs/app/'[lang]'/integrations/opengraph-image.tsx apps/docs/app/'[lang]'/integrations/twitter-image.tsx apps/docs/lib/integrations/directory-og-image.tsx apps/docs/lib/integrations/og-image.tsx
  • pnpm --filter eve-docs exec tsc --noEmit
  • pnpm --filter eve-docs exec next build
  • Manually rendered representative Slack, Discord, Teams, Telegram, Jetty, and Datadog images to verify aspect ratios, monochrome detail, metadata handling, and safe-area placement.

Automated tests and published documentation are not applicable to this visual docs-site change. No changeset is required because the published eve package is unchanged.

Checklist

  • I linked an issue with prior discussion confirming this change is wanted
  • I ran the relevant checks from CONTRIBUTING.md
  • I added tests and documentation where relevant
  • I added a changeset if this touches the published eve package
  • DCO sign-off passes for every commit (git commit --signoff)

Signed-off-by: Colton Padden <colton.padden@vercel.com>
@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
eve-docs Ready Ready Preview Aug 5, 2026 6:43pm
eve-docs-4759 Ready Ready Preview, v0 Aug 5, 2026 6:43pm

Signed-off-by: Colton Padden <colton.padden@vercel.com>
Signed-off-by: Colton Padden <colton.padden@vercel.com>
Signed-off-by: Colton Padden <colton.padden@vercel.com>
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Bundle + Package Summary: apps/fixtures/weather-agent

Key takeaways

  • No notable deltas vs main (f51f866).

Delta vs main (f51f866)

Area Metric Baseline Current Delta
Package Packed tarball 7.65 MB 7.66 MB +4.2 kB ⚠️
Package Unpacked publish size 28.69 MB 28.70 MB +5.9 kB ⚠️
Package Installed footprint 72.02 MB 72.02 MB +5.9 kB ⚠️
Package Published files 3030 3034 +4
Package Installed files 6729 6733 +4
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 16.98 MB 16.98 MB -40 B ✅
Runtime Public routes 13 13 0
Changed function payloads vs main (f51f866) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 8.49 MB 8.49 MB -20 B ✅ none
functions/.well-known/workflow/v1/flow.func changed 8.49 MB 8.49 MB -20 B ✅ none

eve init install

Metric Baseline Current Delta
Installed footprint 110.43 MB 110.43 MB +5.9 kB ⚠️
Installed packages 121 121 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 43.10 MB 43.11 MB +5.9 kB ⚠️
devDependency package bytes 5.04 MB 5.04 MB 0 B ➖
Build Metadata
  • Preset: vercel
  • Nitro: nitro@3.0.260610-beta
  • Output directory: apps/fixtures/weather-agent/.vercel/output
  • Build metadata timestamp: 2026-08-05T18:44:48.726Z
  • Route aliases: 13 public, 1 internal (14 total aliases)
  • Vercel routes in config: 16
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.30.7
  • Package directory: packages/eve
  • Tarball: 7.66 MB (eve-0.30.7.tgz)
  • Unpacked payload: 28.70 MB across 3034 published files
  • Installed footprint: 72.02 MB across 6733 installed files
  • Installed root package: 27.34 MB
  • Installed dependencies: 44.68 MB
  • Runtime dependencies: 2
  • Peer dependencies: 5 (4 optional)

Installed footprint is measured from an isolated temporary npm install of the packed tarball.

Heavy installed dependencies

  • eve: 27.34 MB (38.0%)
  • @rolldown/binding-linux-x64-gnu: 19.35 MB (26.9%)
  • ai: 6.60 MB (9.2%)
  • zod: 5.07 MB (7.0%)
  • undici: 3.50 MB (4.9%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [#################.......] 9.68 MB 33.7%
🟠 dist/src/compiled/@photon-ai/chat-adapter-ime... [####....................] 2.42 MB 8.4%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [###.....................] 1.51 MB 5.2%
🟡 dist/src/compiled/_chunks/node/undici-DWL_MYm... [#.......................] 502.4 kB 1.8%
🟡 dist/src/compiled/_chunks/workflow/undici-DWL... [#.......................] 502.4 kB 1.8%
🔴 Other published files                            [########################] 14.08 MB 49.1%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 27.34 MB 38.0%
🔴 @rolldown/binding-linux-x64-gnu [#################.......] 19.35 MB 26.9%
🔴 ai                              [######..................] 6.60 MB 9.2%
🔴 zod                             [####....................] 5.07 MB 7.0%
🟠 undici                          [###.....................] 3.50 MB 4.9%
🟠 nitro                           [##......................] 2.41 MB 3.3%
🔴 Other installed packages        [#######.................] 7.76 MB 10.8%
Runtime dependencies (2)
Package Range Notes
nitro 3.0.260610-beta
undici 8.9.0
Peer dependencies (5)
Package Range Notes
@opentelemetry/api ^1.0.0 optional peer
ai catalog:
braintrust ^3.0.0 optional peer
just-bash ^3.0.0 optional peer
microsandbox ^0.5.0 optional peer
eve init install drill-down

eve init install details

  • Command: eve init my-agent
  • Package manager: npm
  • Installed footprint: 110.43 MB across 8609 installed files
  • Installed packages: 121 total (115 transitive-only)
  • dependencies: 4 direct packages totaling 43.11 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 62.29 MB

Installed footprint is measured from an isolated temporary eve init my-agent using the current packed eve tarball.

Heavy installed dependencies

  • @typescript/typescript-linux-x64: 27.95 MB (25.3%)
  • eve: 27.34 MB (24.8%)
  • @rolldown/binding-linux-x64-gnu: 19.35 MB (17.5%)
  • zod: 9.02 MB (8.2%)
  • ai: 6.60 MB (6.0%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 25.3%
🔴 eve                              [#######################.] 27.34 MB 24.8%
🔴 @rolldown/binding-linux-x64-gnu  [#################.......] 19.35 MB 17.5%
🔴 zod                              [########................] 9.02 MB 8.2%
🔴 ai                               [######..................] 6.60 MB 6.0%
🟠 undici                           [###.....................] 3.50 MB 3.2%
🔴 Other installed packages         [##############..........] 16.67 MB 15.1%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.3 141.0 kB 0.1%
ai ^7.0.38 6.60 MB 6.0%
eve file:eve-0.30.7.tgz 27.34 MB 24.8%
zod 4.4.3 9.02 MB 8.2%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.3%
typescript 7.0.2 2.50 MB 2.3%
Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 8.49 MB 50.0%
🔴 functions/__server.func                         [########################] 8.49 MB 50.0%

Top Function Payloads

🟠 functions/.well-known/workflow/v1/flow.func • 1 public route • 8.49 MB
Metric Value
Public routes /.well-known/workflow/v1/flow
Runtime nodejs24.x
Handler index.mjs
Payload 8.49 MB
Function files 8.49 MB across 43 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.31 MB (27.2%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.31 MB 27.2%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.62 MB 19.1%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.5%
🟡 _chunks/sandbox.mjs             [########................] 769.0 kB 9.1%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.38 MB 28.0%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x",
  "maxDuration": "max",
  "experimentalTriggers": [
    {
      "type": "queue/v2beta",
      "topic": "__eve776561746865722d6167656e74_wkf_workflow_*",
      "consumer": "default",
      "retryAfterSeconds": 5,
      "initialDelaySeconds": 0
    }
  ],
  "environment": {
    "WORKFLOW_PRECONDITION_GUARD": "1"
  }
}

🟠 functions/__server.func • 12 public routes, 1 internal alias • 8.49 MB
Metric Value
Public routes /
/eve/v1/callback/[token]
/eve/v1/connections/[name]/callback/[token]
/eve/v1/health
/eve/v1/info
/eve/v1/session
/eve/v1/session/[sessionId]
/eve/v1/session/[sessionId]/cancel
/eve/v1/session/[sessionId]/stream
/eve/v1/session/clear
/eve/v1/session/compact
/eve/v1/session/reset
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 8.49 MB
Function files 8.49 MB across 43 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.31 MB (27.2%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.31 MB 27.2%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.62 MB 19.1%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.5%
🟡 _chunks/sandbox.mjs             [########................] 769.0 kB 9.1%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.38 MB 28.0%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x"
}

Build Timing: e2e/fixtures/agent-tools-sandbox

This is an informational timing measurement inside eve build, from preflight through publication. Output-size measurement and profile writing are excluded.

Build mode: deployable Vercel build with sandbox template prewarm included.

  • Build pipeline: 2.03 s -> 1.93 s (-98.5 ms) vs main (f51f866).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (f51f866)`
Phase Baseline Current Delta
extension.check 6.6 ms 1.1 ms -5.5 ms
project.resolve 8.7 ms 0.6 ms -8.1 ms
workspace.create 3.2 ms 0.6 ms -2.6 ms
host.prepare 245.4 ms 154.3 ms -91.1 ms
vercel.service-prefix.resolve 2.5 ms 2.4 ms -0.1 ms
nitro.create 210.4 ms 234.5 ms +24.1 ms
sandbox.prewarm 187.8 ms 177.9 ms -9.9 ms
nitro.cache.prepare 0.3 ms 0.2 ms -0.1 ms
nitro.prepare 0.8 ms 0.9 ms +0.1 ms
nitro.public-assets 0.8 ms 0.7 ms -0.1 ms
nitro.prerender 0.6 ms 0.5 ms -0.1 ms
nitro.bundle 1.34 s 1.33 s -5.5 ms
nitro.cache.write 0.4 ms 0.4 ms 0.0 ms
vercel.workflow-function.materialize 22.6 ms 23.3 ms +0.7 ms
agent-summary.emit 0.5 ms 0.5 ms 0.0 ms
nitro.close 0.1 ms 0.1 ms 0.0 ms
output.publish 3.6 ms 3.6 ms 0.0 ms
workspace.remove 2.3 ms 2.1 ms -0.2 ms

Signed-off-by: Colton Padden <colton.padden@vercel.com>
Signed-off-by: Colton Padden <colton.padden@vercel.com>
@cmpadden
cmpadden merged commit 007cd0f into main Aug 5, 2026
90 checks passed
@cmpadden
cmpadden deleted the feat/integrations-og-images branch August 5, 2026 18:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants