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:
- Create 2 Cloudflare Pages projects (prod + dev)
- Connect them to GitHub repository
- Add custom domains
- 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 tostorybook.ourlantern.app - Push to
devโ deploys tostorybook.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:
| Document | Purpose | Audience |
|---|---|---|
docs/engineering/deployment/STORYBOOK_SETUP_GUIDE.md | Step-by-step Cloudflare setup | DevOps/Admin |
docs/storybook/STAKEHOLDER_GUIDE.md | How to view and use Storybook | Designers, PMs, Stakeholders |
docs/engineering/deployment/STORYBOOK_DEPLOYMENT.md | Complete deployment reference | Developers |
docs/storybook/STORYBOOK.md | Developer documentation | Developers |
Testing the Build โ
You can verify the build works locally before deploying:
# 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!