Hacker News new | past | comments | ask | show | jobs | submit login
Jamstack Handbook – All things Jamstack with 3 step-by-step tutorials (jamstackhandbook.com)
84 points by colbyfayock on Sept 16, 2020 | hide | past | favorite | 48 comments



Who is the Jamstack for in your opinion? I'm a web developer that makes a lot of apps and marketing sites for small to medium businesses and I find it very hard to justify the added complexity of a Jamstack architecture - there's just too many moving parts.

It seems to me you need a few things:

- A dedicated development team to manage the stack

- Enough traffic to justify the complexity

- Regular content publishing to make use of the build pipeline

- A need for speed beyond what's regularly acceptable

Great work anyway on the book, it's good to see people charging for curated knowledge.


Added complexity? At its simplest, Jamstack is just a static site generator. A service like Netlify will do the entire build pipeline for you (for free) just by pointing it at the git repo. Or if you want to DIY the hosting, then all you have to do is find somewhere that can host static files.

Jamstack is largely about removing complexity.


At its simplest yes. But if you are proposing this as a solution to a client, they will likely want to edit content. That will have to happen on a headless CMS instance. That's whole new stack to maintain alongside. You then need to set that up and configure the SPA to talk to it (GraphQL/Apollo?). When I come back to client project in a month, is all this still going to be working ...?

Maybe, but it's certainly not less complex then a traditional Wordpress site. So I'm wondering what are the criteria for using Jamstack successfully?

As you said it could be that it's good for simple static sites but not great for more complex content-drive sites - I don't know, that's what I'm asking.


Obviously it depends a lot on which CMS you're using and I can imagine there being a lot of complexity involved.

That said, setting up something like Contentful and integrating it with NextJS is roughly a day or two of work if you're doing it for the first time. And it all works over REST so you don't have to worry about GraphQL.

You can even do "previews" now with Next thanks to preview mode: https://next-preview.now.sh/


Contentful just abstracts away the complexity (for money). It's still complex, but you're paying instead of dealing with the complexity.


i think thats a fair point but there's a lot of benefit from from that. they're able to focus on making a great CMS

there are also some open source solutions that are great. Netlify CMS works really well for a very basic page / blog management solution

a lot of the headless CMS solutions also offer generous free tiers, making it perfect for web devs to spin up a free instance for their personal sites and projects


I think it's good for simple cases where a technically minded person will be editing the content. And I think it's good for complex cases where performance is important and the organisation is large enough to support at least one employee to manage the system. I think it's (not currently) good for the in between cases.


Stackbit and Publii are two examples of tools that remove a lot of technical barriers for the simple cases you are talking about.


Other than the simplest of static/marketing sites, jamstack is just taking standard server-side rendered frameworks and splitting it up into several layers: CMS and other content sources, external APIs, build process, backend "serverless" functions, etc.

This is more moving pieces and complexity. Yes it's easier to build the frontend using modern component models but I find the tradeoff is rarely worth it.


Jamstack is not less complex, it's just complex in different areas.


I think you might be underestimating just how important speed is becoming.

Not only is it now a very important ranking factor for SEO reasons. There's also going to be a point for most websites where the complexity (I'd argue that the standard WordPress install is a lot more complex than most JamStack setups, if you're going to be digging into the code) will eventually need to be offloaded to a build process that spits out a static site, just to meet the 'acceptable' threshold.


Speed is important, but with services like FaunaDB and Fly.io you can have low latency distributed monoliths, so to speak.


i think there's varying levels of complexity to the different solutions available jamstack or not

Jamstack, the complexity might be maintaining different services, such as a headless cms and the front end. the output though is static files that you can dump into static hosting pretty easily

on the other hand, you might have a serverful solution thats all in one stack. you run into other complexities with that like having to worry moreso about scaling and managing that server for traffic

there are tradeoffs between the 2. jamstack isn't a perfect solution but it has a lot of benefits. it's also relatively young in it's architectural lifecycle, so i would imagine a lot of these pain points to be worked out as it matures

the book tries to get into both the good and the challenging


I am a solo developer. I have built 6-7 projects which fall under Jamstack. I find it that it lessens the complexity, and as a bonus I can sleep much more easily at night knowing that my sites are hosted as static websites.


The invention of the "JAM stack" is one of the greatest marketing stunts I know of. Kudos to Netlify for rebranding HTML+AJAX


I have yet to encounter a link/email about "JAM Stack", including meetup invites, that isn't trying to sell me something. That there seems to be so many people hopping on this train confuses me.


How come?

AJAX is about loading HTML from the backend to the client dynamically.

JAMStack is about pre-rendering HTML from dynamic content into static files.


> JAMStack is about pre-rendering HTML from dynamic content into static files.

Where do the "Javascript and APIs" come into play, if not via AJAX?


Just to be clear, what do you mean with AJAX?


Making asynchronous requests to fetch data. In this context specifically, the common case of fetching data asynchronously and then rendering it to the DOM.

My impression is that Jamstack is meant to include apps that render client side, but disclude apps that require a custom dynamic backend - serving static data and fetching it asynchronously is in, as is hitting third party APIs (the API part of JAM), but writing your own backend to serve data from a DB / etc. is out. Does that make sense?


I've had good luck with serverless WSGI.


The problem that Netlify has is that they are simply a feature of the big cloud providers.

Microsoft is already testing the waters with their own offering and I'm sure AWS and Google are as well. I'm not sure Netlify will survive the onslaught.


i think there's a lot of truth to that - but they do is so fantastically well

there are a LOT of pain points to deal with rolling out all that is included with the base netlify offering

hosting a static site is pretty easy - but configuring routing between cloudfront and s3 can be complicated so that the reequests don't always reference the root index.html

creating an autodeploy infrastructure can be challenging as well, tools like github actions might make that a little easier, but there are a lot of considerations there

it also makes these kinds of solutions more accessible to developers who might not have the understanding or interest to set up that kind of infrastructure. front end devs can build sites, connect, and go with little fuss


I second this. Players like Netlify and Digital Ocean have a ridiculous amount of mindshare for solving a certain problem faster without the complexity that the big cloud providers bring.

I think the market is larger for simplified services without the IAM and S3 cruft, especially when you have to educate the client on the solution.


Netlify is impressively slick and streamlined.. It took like 5 minutes to host a Nuxt app from a private repo with SSL.. And that includes setting up the Netlify account.

Their redirects are a pain point though.


Agreed. As much as I would hate it as someone who utilizes their services, Netlify should look for an exit. AWS is probably the best bet. Between services such as Github Pages, Vercel, and Firebase there’s a lot of competition.


Adding to this, if you have markdown files in your website directory and simply pull them in and render them via Javascript, search engines will still index your markdown files. Your content is still discoverable.


I like the idea of JAMstack and will likely use it for simple toy projects. But I do not like the idea of promoting paid products on HN. this link is basically just an ad telling users to "buy the book".

There is nothing for me to read, learn or discuss on the landing page unless I buy the book.


The upvoting/downvoting mechanism should be sufficient unless you have a scenario where people are upvoting titles without reading the page.

Note to author: perhaps more enticing would be to have 4 examples, the first being a free preview of the book and rest would require payment. Then people could evaluate your tutorial style.


thanks - thats a good point - i plan on releasing the first tutorial free actually - i just haven't had the time to get that out yet, that'll be hopefully posted on freecodecamp.org in the next couple of days


This looks great. People interested may also want to take a look at Andy Bell's 11ty book, which is more of a general introduction to web development and the jamstack:

https://piccalil.li/course/learn-eleventy-from-scratch/


Andy Bell is fantastic, great rec


Can anyone point me to a good headless CMS solution that doesn't introduce vendor lock in? I've tried Contenful and I only got nothing but good things to say about it. Probably something open source and self hosted.


I really like Ghost https://ghost.org/

It's more for prose than ecommerce but it's really pleasant to use and great for headless through its GraphQL interface.

I recently wrote a tutorial on how to use it with Gatsby & AWS serverless infrastructure so that everything is self-hosted but without the overhead of operating servers. https://docs.stackery.io/docs/tutorials/jamstack-ghostgatsby...


Have you looked at Craft? It has headless-mode via a GraphQL API.


there are a lot of good options here: https://headlesscms.org/

i personally use Netlify CMS for my website. it's not as feature rich as some other options, but for a personal blog, it gets the job done, and it's open source


Thanks for that link, will take a look!


You dont need that much tooling. A static site generator will do. Build your site with vanilla HTML or markdown. Use web micro-services for widgets like search, comments, contact-form, etc.


for sure - that's definitely a valid solution. it all depends on the goals you're trying to meet


'an unexpected error has occured'

I hope you get it up and running again soon, because I am very curious to know what your handbook is all about.


:o where are you seeing that, on the homepage? it's loading for me


I get it in Safari 12.1.2 (12607.3.10) on the mac. It works correctly in Firefox for me now.


that's so strange - sorry you're experiencing that. im not having any issues on my mac's safari :( glad FF is working for you though

i'll try to see if i can figure out a way to reproduce


What’s the expected knowledge before you read this?


For the book - I don't think there really is a high expectation of knowledge, except maybe just general web development from a high level. The hope for the informational part is to get anyone acquainted with it

For the tutorials - the expectation is familiarity with Javascript and probably React, given the examples are React, though I walk through each steps with the code changes


Edit: Pardon me! I think I encountered some weirdness on mobile, I couldn’t scroll very far down. After a reload I’m seeing more.

——-

I’m seeing very little about the actual content of the book on the page. Could you please detail a little bit more about what’s actually covered? What apps are you building in those tutorials? Etc.


sorry i heard there are some issues with the site but i haven't been able to reproduce to fix :(

please let me know if you hvae more questions!


I guess there’s some use case for Jamstack static generators but unless you do frequent builds just building vanilla HTML is my preference.




Join us for AI Startup School this June 16-17 in San Francisco!

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: