Shoelace's Docsify site

[trusktr]

Hello! I'm one of the people maintaining Docsify now. The Shoelace is a really good example.

I've already converted Docsify internals to Solid.js, and will soon make a new implementation of SSR and also add SSG using the support from Solid. TLDR static site generation is coming.

Then eventually there will be both a <Docsify> Solid component, and a <docsify-app> custom element. This is going to be nice because then we'll be able to allow users to customize the Docsify template in more ways than just overriding CSS (props.children in Solid, and <slot> with custom elements).

I'm a big fan of custom elements, and Shoelace looks really nice! I see Shoelace uses lit. I made an alternative to lit powered by Solid.js for reactivity, templating, and speed, adding decorators for concise class syntax: https://github.com/lume/element

A glimpse of what it looks like:
https://codepen.io/trusktr/embed/qBavKmX
https://codepen.io/trusktr/pen/rNWMmvg
Plus LUME's 3D elements.

Are you in the Docsify Discord server? It would be nice to see you there if you're not there already. :) https://discord.gg/3NwKFyR

[claviska]

I don't know much about Solid.js, but a <docsify-app> custom element sounds like a win. I don't care much about SSR, but SSG would be great.

While I'd hate to introduce another build step to publish the docs site, the only thing I'm missing by using Docsify is OpenGraph + Twitter Card data, so every single thing I link to shows the same image/title/description. I've considered moving to 11ty to solve that since I use it for other non-documentation projects, but that would be a lot of rework to build out a custom theme.

[trusktr]

Looks like you have since updated to 11ty. The site is really nice!