Skip to main content

Frugal

tag codecov license

Frugal is a hybrid, dynamic and static site generator that aims to minimize the amount of JavaScript served, thanks to partial hydration:

  • Static pages rendered at build time: by default Frugal produces static html.
  • Server side pages render at request time
  • Bring your own framework: Frugal works with any UI framework able to compile to html
  • Manual partial hydration for interactive island in pages if you use Preact
  • Client-side and server-side form submission for both static and dynamic pages
  • Incremental build: if both data and code did not change, the page is not rebuilt
  • Client session: transform your MPA into a SPA at little cost

Getting Started

Visit the Getting started pages to get started with Frugal.

Documentation

The docs are live at https://frugal.deno.dev.

Why?

Modern web development is geared toward delivering more JavaScript. JSX and client-side navigation enabling larger codebase and optimized with code splitting. Each new optimization is not used to make web faster, but rather to send more.

Don’t get me wrong, those tools and optimizations are fantastic (and Frugal relies on them). But somewhere along the way, we kinda lost ourselves.

The idea is to keep most of the developer experience of those tools (JSX, CSS in JS), but ship everything static in html and css and only the dynamic parts in JS.

That’s the difference between Frugal and Next.js for example. Next.js will bundle the whole JSX (even the static parts), and ship it alongside a static rendering in html. So everything static is send twice (one time in the html, and then in uncompressed form in the JS bundle), and the browser has to do rendering twice (one time with the html, and then by parsing and executing a JS bundle that mutate the DOM).

With Frugal, we lose the ability to do client-side navigation, because the JS does not have all the information to render the pages we navigate to (since only the dynamic parts are in the JS), but we make it up by having small cacheable pages (so roundtrip to the server a quick and infrequent).

Compared to Next.js, Frugal is less opinionated:

  • No filesystem-based router, you are free to organize your codebase your way.
  • Static page refresh is done on demand via webhook, rather than on each visit.
  • Frugal is frontend-framework agnostic. As long as you can return a string, Frugal is happy.
  • Optional integration with Preact.