The first ever web site built with Davaux (then statically generated with Davaux) is online and it's the documentation web site for Davaux. It's currently hosted using Codeberg pages, but I plan to move it to a faster server in the near future. You can see the source for it here. Keep in mind the NPM packages for Davaux haven't been published yet, so you'll have to clone the Davaux repository if you want to try it out right now.
The docs site uses MDX in its page routes, this is a feature and not a requirement. It makes it simpler to document with Markdown and then use that Markdown on pages that compile to HTML, while also supporting JSX. Davaux also has a package for Markdown support in pages, if you don't need the JSX capability in MDX. If you just want to use JSX, no extra package is needed. The way Davaux works, you can develop a site using SSR locally and then deploy it as SSR or SSG. It also has a preview server to test the statically generated site locally.
I had planned to release the first Alpha version of Davaux on NPM today, but I've identified a couple of gaps I want to fix first. It may still get released today, but I expect to at least release this week. The issue is currently you have the option of building a site using the OML runtime in Davaux, but if you build using it for production you also enable OML caching by default. OML caching can be great, but it has drawbacks when using dynamic data outside of Islands. It needs to be an opt-in feature and not the default just because OML is enabled.
The other gap is also in OML. I've been working on an OML specification and some of the terminology changed during that process. I need to update the OML runtime in Davaux to follow the latest spec. I'll also publish the OML spec when I publish Davaux to NPM.
My plan is for Davaux to be considered Alpha for the 0.8.x releases. It shouldn't change dramatically, but there is an opportunity to fix things if needed. The 0.9.x releases will be considered Beta, it could get breaking changes, but I'd try not to. I'm hoping the Beta period is short and most of the issues are hammered out in the Alpha stage.
David D.
No Comments