# How to publish a Storybook site

A built Storybook is a static site, which makes this the cheapest way to give a designer or a client a component library they can click through.

- Build command: `npm run build-storybook`
- Folder to upload: `storybook-static`
- Renders on a server by default: no

## Steps

1. **Build the project.** Run npm run build-storybook in the project folder. This is the step Droply does not do for you: we publish finished pages, we never run your build.
2. **Find the output folder.** The build writes a finished site to storybook-static. That folder, not the project folder, is what gets uploaded.
3. **Drag it in.** Drop the folder (or a ZIP of it) into Droply. It is live on an HTTPS droply.id subdomain in seconds, and re-uploading publishes a new version at the same URL.

## Worth knowing about Storybook

- The script is `build-storybook`, not `build`. Running the project build gives you the application, not the component explorer.
- The output folder is `storybook-static`.
- It is a published web page, so it is public unless you protect it. Password protection is checked at the edge and covers every file, which is usually what an internal component library wants.
- A story that calls a real API still calls it from the visitor browser. A published Storybook pointed at a staging service is a public pointer to that service.

## Frequently asked questions

### Does Droply build my Storybook project for me?

No, and it never will. Droply publishes finished static files. Running your build would mean running your dependencies on our servers, which is a different and much riskier product. Build locally or in your existing CI, then upload the result.

### Which folder do I upload?

The storybook-static folder that npm run build-storybook creates, not the project folder. Upload it directly or ZIP it first; both work.

### What happens when I update the site?

Build again and upload again. The new version replaces the old one at the same URL, so a link you have already shared keeps working. The Pro, Business and Enterprise plans keep a version history you can roll back to in one click.

### Can I use my own domain?

Yes, on the Pro, Business and Enterprise plans. Point your domain at Droply, and the certificate is issued and renewed automatically.