/hoarcekat

A Storybook-like plugin that makes it easy to preview individual UI elements. Especially useful with Roact.

Primary LanguageLuaOtherNOASSERTION

Hoarcekat

What is it?

Hoarcekat is a Storybook-like plugin that makes it easy to preview individual UI elements.

Developers write "stories" that explain how their UI should be previewed. It runs without any knowledge of the rest of your application, meaning you can use it to easily create and preview your UI as isolated components. Because of this, it is especially useful when using Roact, though Roact is not required.

How do I write a story?

Stories are ModuleScripts whose name ends with .story. These ModuleScripts return a function that takes an Instance (the preview frame) that then returns a destructor function, which cleans up the instance of anything the component put in.

It's much simpler to understand when you look at an example story.

How do I download it?

Method 1:

You can download the plugin on the Roblox marketplace.

Method 2:

You can download the latest version in the GitHub releases. From here, go to the "Plugins Folder" found under the "Plugins" tab in Roblox Studio, and put the .rbxmx in there.

Why the name?

Roblox engineers have been working on their own Storybook-like plugin for a long time named "Horsecat". However, due to problems with which the solutions are outside their control, it has not been made available to the public yet. Hoarcekat is meant to hold over until the official Horsecat is unveiled. Thus, the name is just an intentionally botched spelling.