JAMstack is fast only if you make it so
JAMstack is often promoted as a good way to provide performant sites. It's even the first listed benefit on jamstack.wtf, a "guide [which] gathers the concept of JAMstack in a straight-forward guide to encourage other developers to adopt the workflow". But too many JAMstack sites are very slow.
You may have seen Alex Russell's frequent rants about Gatsby:
@matthewcp @justinfagnani @gatsbyjs @kylemathews @addyosmani Looking across the full set of traces, modern Gatsby seems to produce pages that take 2-3x as long as they should to become interactive.
This is not OK. Gatsby/NPM/React regressively tax access to content.
In less generous moments, I'd go as far as to say it's unethical.
Gatsby is an easy target (among many others) because it is currently not optimized for performance out of the box, despite what's promoted. It is possible to fix it, for example with this plugin, and I believe good React developers can make it shine, but it should be the default, not an afterthought.
Eleventy is very different, as Zach Leatherman reminds us in Eleventy’s New Performance Leaderboard:
Eleventy doesn’t do any special optimizations out of the box to make your sites fast. It doesn’t protect you from making a slow site. But importantly it also doesn’t add anything extra either.
Sometimes, using the server side build is enough to get data from an API and serve HTML to all visitors, which is much better for performance.
For example, swyx wrote Clientside Webmentions about implementing Webmention with Svelte. Any article promoting Webmention and easing its adoption is welcome! But even if it's nice for a demo of Webmention and Svelte, I wouldn't recommend doing it client side.
Server side first §︎
I prefer doing it on the server.
It allows to:
- call webmentio.io API only when building the site, which should be less often than visitors viewing pages
- cache the result of requests to webmention.io and the timestamp of the latest, so that the next one only asks for new webmentions
It puts less pressure on webmention.io, with one single request per build, when a client implementation will make a much larger request (or even several, with pagination) for each page view.
- my website received 75 webmentions in April 2020. I have probably built it a hundred times during the same period, so let's say 100 requests to webmention.io with small responses
- in the same period, my website had 3,746 page views (underestimated, I still use Google Analytics 🤷♂️), which would have made 3,746 requests to webmention.io with large responses
Using the server side build to get the webmentions provides multiple benefits:
- The performance for the users is much better, with HTML already computed on the server and statically served
- Much less API calls are made, requiring much less computing time and power
- Everyone should know that Aaron Parecki provides the awesome webmention.io service for free, and most Webmention users seem to use it nowadays, so being nice with its API feels better
Enhance client side, if really needed §︎
If you know you receive a lot of very useful webmentions that you have to show to your visitors, you can enhance the server side generated list with a bit of client side.
So, instead of doing this for every page view, at least:
Then, keep track of a user's calls to the API, in localStorage or IndexedDB, so that you don't make these calls again a short while after. You could even use a Service Worker to cache requests and their timestamp.
Client side only API calls sometimes make more sense §︎
I agree Webmentions are not the most complex use case to explain that you should as much as possible call APIs from the server at build time instead of from the client:
- Webmentions to show are the same for all visitors
- Missing a few of the latest ones is probably not an issue
So yes, many other use cases make client side API calls necessary, or better than server side ones, I understand that.
I just say it should not be the default.
AJMstack Mstack §︎
Here's for example what you can see on jamstack.wtf (simplified):
It makes more obvious there is a pile of things, quite useful for a "stack".
But I would like to suggest this modification:
Of course, it reads as AJMstack instead of JAMstack, so I bet I won't be successful promoting it… 🤷♂️
It even allows to present this as a great progressive enhancement platform, as we can start with plain old (did I hear "boring"?) Markup…
Here's the Mstack:
If you want to share an error or suggest an enhancement of this content, please edit the source on Github.