storybook-dev-host-launch

Diagnoses and resolves unreachable Storybook dev servers caused by missing Docker compose port mappings.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill storybook-dev-host-launch-vilnacrm-org
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: storybook-dev-host-launch
Source: https://github.com/VilnaCRM-Org/claude-plugins/tree/main/plugins/react-frontend-sdlc/skills/storybook-dev-host-launch
Command: npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill storybook-dev-host-launch-vilnacrm-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A Storybook dev server that prints its startup banner but cannot be reached from the browser on port 6006 looks like a hang, when the real cause is usually a missing port bridge between the Docker container and the host. This Skill guides you through diagnosing the compose port configuration and launching Storybook where the browser can actually reach it. ## Core Features & Use Cases - Port-mapping diagnosis: Checks whether the compose service publishes the Storybook port and whether the dev server binds 0.0.0.0 instead of loopback inside the container. - Repository-shape guidance: Applies different fixes per shape — React SPA (already publishes 6006), Next.js (use EXEC_MODE=host with the make target), and component-library (run the dev server on the host via the package manager). - Capability gating: Skips cleanly when the repository profile has no Storybook capability, and distinguishes the dev server from the internal static Storybook service used by visual tests. - Use Case: In a component-library repository, make storybook appears to hang because the compose service declares no ports; the Skill directs you to run bun x storybook dev -p 6006 on the host so the browser can connect. ## Quick Start Ask the assistant to figure out why the Storybook dev server is unreachable from the browser on port 6006 and start it in a way that works.

Frequently Asked Questions about storybook-dev-host-launch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Storybook dev server hang with no browser access on port 6006?▼

The server is usually running fine but unreachable because the Docker compose service does not publish port 6006 to the host. Check the compose file for a ports mapping before assuming the dev server target is broken.

How do I run Storybook outside Docker for a component library?▼

Run the dev server directly on the host through the repository's package manager, for example bun x storybook dev -p 6006. This is needed because the compose service declares no ports, so nothing is bridged to the host.

Does adding --host 0.0.0.0 fix an unreachable Storybook in Docker?▼

No. The flag fixes the bind address inside the container but does not create a port bridge to the host. Without a compose ports mapping, the host still has no route to the container's port 6006.

Can I reach the Storybook instance used by visual tests from my browser?▼

No. The static Storybook build served for Playwright visual tests is deliberately internal to the compose network and reached by the test runner via service name, not published to the host.

How do I start Storybook on the host in a Next.js repository?▼

Keep the existing make target and flip the execution mode with EXEC_MODE=host make storybook-start. The value is a validated enum, so a typo produces a hard error rather than a silent fallback.