Configuration

Environment Variables

Storybook Requirements

The server connects to Storybook via:

• /index.json - Component index endpoint
• /iframe.html - Component rendering endpoint

Ensure your Storybook instance exposes these endpoints.

Smart Caching

The server implements a 5-minute TTL cache for:

• Storybook index data
• Component HTML extraction

This improves performance and reduces API calls.

Timeout Protection

Default timeouts are configured for:

• Connection attempts
• Component rendering
• CSS fetching

Troubleshooting

Connection Failed

• Ensure Storybook is running
• Verify STORYBOOK_URL is correct
• Check /index.json endpoint directly in browser

Component Not Found

• Use exact story ID format: component-name--story-name
• Run list_components first to see available components

Slow Extraction

• First run may be slow due to Puppeteer initialization
• Consider using caching for frequently accessed components