Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/koala73/worldmonitor/llms.txt

Use this file to discover all available pages before exploring further.

World Monitor lets you share country intelligence briefs to social media platforms with rich previews, formatted text, and dynamically generated images.

​
Generating a Story

Every country brief can be exported as a shareable story containing:
  • Country name and flag
  • CII score (0–100 with color-coded ring)
  • Threat counts (protests, conflicts, military activity)
  • Theater posture (NORMAL, ELEVATED, CRITICAL)
  • Active signals (chips showing signal types and counts)
  • Top prediction markets (Polymarket contracts with probabilities)
1

Open a country brief

Click any country on the map or use Cmd+K to search for a country.
2

Click the Share button

Located in the top-right corner of the brief.
3

Select a platform

Choose from:
  • Twitter/X
  • LinkedIn
  • WhatsApp
  • Telegram
  • Reddit
  • Facebook
4

Platform-appropriate text is generated

Each platform has its own formatting style (see below).
5

Copy or open share link

The text is copied to your clipboard, or a share dialog opens with pre-filled content.

​
Platform-Specific Formatting

World Monitor generates platform-appropriate formatting for each social network:
Character limit: 280 charactersFormat:
🚨 UKRAINE Intelligence Brief

Instability Index: 73/100 🔴

Signals:
• 12 protests
• 8 military flights
• 3 naval vessels
• 23 active conflicts

Theater: ELEVATED ⚠️

Full analysis: https://worldmonitor.app/story?c=UA&t=brief
Features:
  • Emoji-heavy for visual appeal
  • Hashtags: #OSINT #Geopolitics #Ukraine
  • Link to full brief with OG image

​
Dynamic Open Graph Images

When you share a story link, social platforms display a rich preview card with a dynamically generated image.

​
How It Works

1

Story URL is generated

Format: https://worldmonitor.app/story?c=<country>&t=briefExample: https://worldmonitor.app/story?c=UA&t=brief
2

Social crawler requests the page

When Twitter, Facebook, LinkedIn, etc. preview the link, they send a request with a bot user-agent:
User-Agent: Twitterbot/1.0
User-Agent: facebookexternalhit/1.1
User-Agent: LinkedInBot/1.0
3

Bot detection triggers OG image endpoint

World Monitor detects the bot user-agent (10+ known signatures) and serves an HTML page with og:image meta tags pointing to:
https://worldmonitor.app/api/og-story?c=UA&t=brief
4

SVG card is generated on-the-fly

The /api/og-story endpoint generates a 1200×630px SVG card containing:
  • Country name and flag
  • CII score gauge arc (color-coded by severity)
  • 0–100 score bar
  • Signal indicator chips (threats, military, markets, convergence)
5

Social platform caches the image

The bot renders the SVG as a PNG and caches it. Users see the preview card in their feed.

​
OG Image Example

<meta property="og:title" content="Ukraine Intelligence Brief" />
<meta property="og:description" content="CII Score: 73/100 (CRITICAL) | 12 protests, 8 military flights, 23 conflicts" />
<meta property="og:image" content="https://worldmonitor.app/api/og-story?c=UA&t=brief" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:type" content="article" />
Regular browsers (non-bots) receive a 302 redirect to the SPA, so users clicking the link see the full interactive dashboard, not a static card.

​
Canvas-Based Image Export

You can also export a country brief as a PNG image for offline sharing:
1

Open a country brief

Click any country on the map.
2

Click Export → PNG

Located in the export dropdown.
3

Canvas rendering begins

The entire brief is rendered to an HTML5 <canvas> element:
  • CII score ring (SVG → Canvas)
  • Signal chips
  • Top news headlines
  • 7-day timeline chart
  • QR code linking back to live dashboard
4

PNG download triggers

File name: ukraine-brief-2026-03-01.png

​
Use Cases

  • Reports: Embed in PowerPoint or Keynote
  • Social sharing: Post to Instagram, Twitter, etc.
  • Archival: Save snapshots for historical comparison
  • Print: High-resolution output suitable for printing
PNG export can take 5–10 seconds for briefs with large timelines or many signals. Be patient while the canvas renders.
Every story generates a unique deep link that encodes:
  • Country code (c=UA)
  • Story type (t=brief)
URL structure: 
https://worldmonitor.app/story?c=<ISO-2>&t=<type>
Examples:
  • Ukraine brief: ?c=UA&t=brief
  • Iran analysis: ?c=IR&t=brief
  • Taiwan threat assessment: ?c=TW&t=brief
Deep links always resolve to the latest data — CII scores, signals, and news update in real-time.

​
Social Platform Support

World Monitor’s OG image endpoint is tested against these social crawlers:

✅ Full Support

  • Twitter/X (Twitterbot)
  • Facebook (facebookexternalhit)
  • LinkedIn (LinkedInBot)
  • Telegram (TelegramBot)
  • Discord (Discordbot)
  • Reddit (redditbot)
  • WhatsApp (WhatsApp)

⚠️ Partial Support

  • Instagram (requires Business accounts for link previews)
  • Snapchat (no link preview API)
  • TikTok (no OG tag support)
If a platform doesn’t support OG images, users will see a plain link. The deep link still works — they just won’t see a preview card.

​
Troubleshooting

Social platforms cache OG images aggressively. If you update a brief:
  1. Twitter: Use the Card Validator to refresh
  2. Facebook: Use the Sharing Debugger to scrape again
  3. LinkedIn: Use the Post Inspector to refresh
Or add a cache-busting parameter: ?c=UA&t=brief&v=2
This usually happens if the canvas renders before all data loads:
  • Wait until the brief fully loads (all charts and signals visible)
  • Try again — the export will include all content
  • Check browser console for Canvas API errors
Twitter has a 280-character limit. World Monitor auto-truncates to fit:
  • Key data (CII, signals) is prioritized
  • Full details are in the deep link
  • Users clicking the link see the complete brief