Skip to navigation Skip to main content
These docs are for an upcoming version of Build Awesome — take extra care before linking here as URLs may change! Look to the latest stable docs instead (or the full release history).

Build Awesome helps you build better websites.

Build Awesome is a developer tool to help you build fast websites even faster.

  • It’s secure and resilient: with static websites there is no runtime to fail in the middle of the night.
  • It’s lightweight: we’ve decreased our dependency count with every major release since 2018.
  • It’s scalable: deploy with the most efficient architecture for the modern agent-heavy web.
  • It’s stable: stop getting burned upgrading your dependencies. We want your website to deploy without headaches for years to come.
  • It’s trusted by folks at IndieWeb Avatar for https://www.nasa.gov/NASA IndieWeb Avatar for https://home.web.cern.ch/Cern IndieWeb Avatar for https://tc39.es/TC39 IndieWeb Avatar for https://about.google/Google IndieWeb Avatar for https://www.microsoft.com/Microsoft IndieWeb Avatar for https://www.cloudflare.com/Cloudflare IndieWeb Avatar for https://www.mozilla.org/Mozilla (and more).

You should have a website and Build Awesome can help you create your very own home on the web. Get started!

Quick Start

Build Awesome requires a way to run JavaScript on your computer and we recommend Node.js (version 22 or newer). You can check whether or not you have Node.js installed by running node --version in a Terminal. (Well, wait—what is a Terminal?) If node is not found or it reports a version number below 22, you will need to install Node.js before moving on.

Next create an index.md Markdown file. You can do this in the text editor of your choice (Notepad.exe, TextEdit, Nova, Visual Studio Code, or others).

Now run Build Awesome using npx, an npm-provided command that is bundled with Node.js.

npm pnpm yarn
npx @awesome.me/buildawesome --serve
pnpm dlx @awesome.me/buildawesome --serve

pnpm is an optional alternative to npm that needs to be installed separately.

yarn dlx @awesome.me/buildawesome --serve

Yarn is an optional alternative to npm that needs to be installed separately.

Build Awesome compiles any files in the current directory matching valid file extensions (md is one of many) to the _site output folder. It might look like this:

[buildawesome] Writing _site/index.html from ./index.md (liquid)
[buildawesome] Wrote 1 file in 0.03 seconds (v4.0.0-alpha.10)
[buildawesome] Watching…
[buildawesome] Server at http://localhost:8080/

The --serve option also starts a local development server. Open up http://localhost:8080/ in your favorite web browser to view your website.

If you’d like to experiment further with different template syntax, try out the playground below.

Try Build Awesome in Your Browser

Now try editing one of the three files in this project. You can make use of Front Matter, Liquid and Markdown template syntax. Change the title in front matter on a blog post and watch the list update on the index page!

---
subject: World
---
# Hello {{ subject }}

You can type here!

- [Markdown](/docs/languages/markdown/)
- [Liquid](/docs/languages/liquid/)

## Posts

{%- for post in collections.posts %}
- [{{ post.data.title }}]({{ post.url}})
{%- endfor %}

_Built with {{ buildawesome.generator }}_
---
title: First blog post ⬅️
tags: posts
---
# {{ title }}
---
title: Second blog post
tags: posts
---
# {{ title }}

News from the Blog

Why should you use Build Awesome?

Get started with Build Awesome today! or read more about its predecessor Eleventy’s project goals (from 2018).

Documentation

Todd and Bruce said this button should be bigger and as you can see they were right.

Built Awesome

A random sample taken from 901 authors. Check out the fastest of their 1308 websites.

Don’t take my word for it Rainbow

Listen to what these happy developers are saying about Build Awesome and Eleventy:

“2022 winner of the Google Open Source Peer Bonus Award” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fgoogle.com%2FGoogle

“Don’t tell Zach I said it but Eleventy is seeming fresh as hell so far” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fwil.to%2FMat Marquis

“Eleventy is almost fascinatingly simple.” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fchriscoyier.net%2FChris Coyier

“#1 Product of the Day (May 2022)” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fproducthunt.com%2FProduct Hunt

“I looked into and actively tried using various static site generators for this project. Eleventy was the only one I could find that gave me the fine-grained control I needed at blazingly fast build times.” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fmathiasbynens.be%2FMathias Bynens

“I use Eleventy on almost every project at this point and I love it.” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Flea.verou.me%2FLea Verou

“I heard Eleventy was good” Favicon for zachleat.com/img/lachzeat-glasses.pngLach Zeatherman

“Jekyll is dead to me” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fandy-bell.co.uk%2FAndy Bell

“Eleventy + Netlify have become my new workflow for static sites. I think I'm in love.” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fminamarkh.am%2FMina Markham

“Eleventy is a killer static site generator. That’s all.” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Fwww.sarasoueidan.com%2FSara Soueidan

“Eleventy is absolutely wonderful. It’s by far the nicest static site generator I’ve used in what feels like forever.” Favicon for v1.indieweb-avatar.11ty.dev/https%3A%2F%2Faddyosmani.com%2FAddy Osmani

…and many more!

Alternatives

This project aims to directly compete with all other static site generators. We encourage you to try out a few others: