Skip to content

Storybook Website Deployment โ€” Summary โ€‹

Goal โ€‹

Make Storybook (component library) accessible to stakeholders at:

  • Production: storybook.ourlantern.app
  • Development: storybook.dev.ourlantern.app

What is Storybook? โ€‹

An interactive component library where designers, PMs, and stakeholders can:

  • Browse all UI components
  • Interact with components (change colors, sizes, states)
  • View component documentation
  • Share direct links to specific components

Current Status โ€‹

โœ… Code is ready โ€” All configuration and documentation complete
โณ Cloudflare setup needed โ€” 15-20 minute manual setup required

Next Steps โ€‹

1. Follow the Setup Guide โ€‹

Open: docs/engineering/deployment/STORYBOOK_SETUP_GUIDE.md

This guide provides step-by-step instructions with all the details you need.

What you'll do:

  1. Create 2 Cloudflare Pages projects (prod + dev)
  2. Connect them to GitHub repository
  3. Add custom domains
  4. Verify deployments work

Time required: 15-20 minutes

2. Share with Stakeholders โ€‹

Once deployed, share these resources:

URLs:

  • Production: https://storybook.ourlantern.app
  • Development: https://storybook.dev.ourlantern.app

Guide for stakeholders:

  • docs/storybook/STAKEHOLDER_GUIDE.md โ€” How to view and use Storybook (non-technical)

3. Automatic Deployments โ€‹

After setup, deployments are fully automatic:

  • Push to main โ†’ deploys to storybook.ourlantern.app
  • Push to dev โ†’ deploys to storybook.dev.ourlantern.app
  • Feature branches โ†’ get preview URLs (e.g., feature-xyz.lantern-storybook-dev.pages.dev)

Documentation Reference โ€‹

All documentation is complete and ready:

DocumentPurposeAudience
docs/engineering/deployment/STORYBOOK_SETUP_GUIDE.mdStep-by-step Cloudflare setupDevOps/Admin
docs/storybook/STAKEHOLDER_GUIDE.mdHow to view and use StorybookDesigners, PMs, Stakeholders
docs/engineering/deployment/STORYBOOK_DEPLOYMENT.mdComplete deployment referenceDevelopers
docs/storybook/STORYBOOK.mdDeveloper documentationDevelopers

Testing the Build โ€‹

You can verify the build works locally before deploying:

bash
# Build static Storybook
npm run build-storybook

# Verify output
ls -la storybook-static/

# Should see: index.html, assets/, iframe.html, etc.

Questions? โ€‹

  • Setup help: See docs/engineering/deployment/STORYBOOK_SETUP_GUIDE.md
  • Deployment issues: See docs/engineering/deployment/STORYBOOK_DEPLOYMENT.md
  • Cloudflare Pages docs: developers.cloudflare.com/pages

Ready to proceed? Open docs/engineering/deployment/STORYBOOK_SETUP_GUIDE.md and follow the steps!

Built with VitePress