leptos_forge
| Crates.io | leptos_forge |
| lib.rs | leptos_forge |
| version | 0.6.3 |
| created_at | 2025-10-27 13:40:59.485046+00 |
| updated_at | 2025-10-27 13:40:59.485046+00 |
| description | Build and test your Leptos components |
| homepage | https://mskorkowski.github.io/ |
| repository | https://github.com/mskorkowski/leptos-forge |
| max_upload_size | |
| id | 1902944 |
| size | 175,221 |
(mskorkowski)
documentation
README
Leptos Forge
Leptos Forge is the library which helps with creating and testing user interfaces written in Rust and Leptos.
The most recent documentation is available at leptos_forge site.
Warning
Leptos Forge is still at the early stages of development and is really a bare-bones project. Many of the developer experience features are not yet implemented.
Parts already released to crates.io
Parts released to crates.io are considered as good enough for others to use
leptos_forge_build_script- readable output handling for cargo build scripts
- reliable integration with tailwindcss cli
leptos_forge_utils_leptos- URwSignal - generic purpose read/write signal
- css classes manipulation add/remove/swap
- StoredRef - wrapper type which allows to keep the
Elementin the leptos store
leptos_forge_utilsProbably useless outside of theleptos_forgecodebase
Compatibility with leptos
Below there is table of Leptos versions with which leptos_forge is compatible
with
leptos_forge version |
Leptos version |
|---|---|
| 0.6.0- | 0.8 |
Features
- Trivial integration with Leptos - You can use Leptos components directly in your Forge stories without any additional setup
- Descriptive - Leptos Forge allows you to write your descriptions using Markdown
- Rust API - This project was created with programming Rust in mind to make it easy to write your stories
Leptos Forge vs Storybook
Storybook is a popular tool used to create frontend components in isolation and test them and was a big inspiration for Leptos Forge. However, Leptos Forge has some unique features that make it different from Storybook:
| Feature | Leptos Forge | Storybook |
|---|---|---|
| Programming language | Rust | JavaScript/TypeScript |
| Targeted frameworks | Leptos | React, Vue, Angular and many more |
| Usage | It's a library around which you write your stories | It's an application that manages your stories |
| Extending | Since you control the entire application, you can easily extend it to fit your needs | Storybook has a lot of features and extensions to meet your needs but if you need something not on that list, it's not so easy to add it yourself |
| Look | Ugly, let's be frank | It's clean and nice to look at |
| Which should I use? | If you are using Rust and Leptos, you might want to consider Leptos Forge. You must remember it's still a bleeding edge project. | If Storybook meets your needs, go there. It's mature, stable and supported by a lot of people |
Version numbers and how stable it is?
For versions 1+ we will follow the SemVer specification but it's still a far away future.
To make it a bit easier to play with the current version of the project we will use the convention similar to the SemVer, but breaking
changes instead of major version will update a minor version number and we will create a migration information. Nonbreaking changes will
update a patch version number. If we do a big change in the lib we will also bump the minor version.
In terms of stability I (Marek) can say that core should be rather stable. There are two reasons for this:
- I'm using Leptos Forge for my private projects and it does most of the things I would like to do with Leptos Forge*
- I'm human and rewriting all of the stories I've created for my projects won't be fun
*There is quite a lot of UX issues in Leptos Forge, which will be ironed out in the future but due to nature of the Leptos Forge they are mostly isolated.
Getting Started
There is a comprehensive guide on how to start using leptos_forge on the site.
License
Project is under MIT license. See LICENSE for details.
Contributing
Create an issue where you will describe what and why would you like to change. We will iron it out together. All PRs are welcome.
Why Leptos Forge uses custom components
Leptos Forge is using internally the components defined in the libs/ui_components crate. We've created these components so you can use them in the code
related to your stories. This way Leptos Forge doesn't depend on any particular UI library, so you can use whatever