I maintain a library of components and being able to spin up a new project and hit the ground running makes for a great experience.
I'm looking at documenting with lookbook instead of storybook, but both look decent.
I maintain a library of components and being able to spin up a new project and hit the ground running makes for a great experience.
I'm looking at documenting with lookbook instead of storybook, but both look decent.
Rails appears to have (Apple-style) taken some cues from elsewhere and made the user experience actually nice.
It was possible to build a very fast component-based apps without any JS whatsoever (I did a few), with the choice of using client-side code being left entirely to the developer.
If you were OK with JS, it also had the capabilities of partial server-side-rendering without page reloads. That's years before Pjax/Turbolinks/Phoenix LiveView were invented.
The major issues with it was that creating components wasn't as straightforward as in a modern framework like React, it was seen as "advanced stuff". Also, it didn't really enforce code separation like MVC does, so spaghetti code was the norm. The main "escape hatch", CodeBehind, was also grossly abused by developers, so leaky abstractions were the norm in it. It was also neglected a bit by Microsoft IMO.
It could have been a cool tech for niche apps, but most people chose to run to the next shiny thing rather than really learning how to make a good application in it. Kind of a shame.
How does Lookbook stack up against Storybook? Always keen to stay in the Ruby ecosystem if possible :-)
So far it's been plain sailing, I'm already familiar with Yard-style docs and getting everything up and running from the spec/dummy app was really straightforward.
The library I maintain currently uses a home-rolled docs page (https://dfe-digital.github.io/govuk-components/) that needs to be refreshed manually. It's been an 'ok' approach until now but as it's matured we need something that's automated and easier to maintain.
Quick link for others: https://github.com/DFE-Digital/govuk-components
I'm going to take a look through the repo as I'm sure there's some patterns you've found given you're at a much bigger scale. Any hot tips?
My tip would be to not worry too much about covering every last detail or feature immediately, aim to do what most people need most of the time and release early - then if there's demand for extra stuff add it as you go.
Just a further variation of the "no simple way to share JS in a gem to be packed via webpacker" story, I guess.