# Nera

> Nera is a lightweight, plugin-based static site generator for Node.js. You write Markdown with YAML frontmatter, template with Pug, and extend the build with small single-purpose npm plugins; one CLI, `@nera-static/nera`, scaffolds, builds, previews, validates and updates a site.

## Docs

- [Introduction](https://nera.js.org/docs/index.md): What Nera is, how it works, and where to go next.
- [Getting started](https://nera.js.org/docs/getting-started.md): Scaffold a new Nera site with the nera CLI and build it.
- [Core concepts](https://nera.js.org/docs/core-concepts.md): The render pipeline, the app and meta objects, layouts and translations.
- [Writing content](https://nera.js.org/docs/writing-content.md): Markdown files, frontmatter, and the derived meta values.
- [Plugins](https://nera.js.org/docs/plugins.md): Installing plugins, the hook contract, config resolution, and templates.
- [Deployment](https://nera.js.org/docs/deployment.md): Building the site and hosting the public/ folder.
- [CLI reference](https://nera.js.org/docs/cli.md): The nera CLI — scaffold, build, preview, update, validate and check a site.
- [Using Nera with AI](https://nera.js.org/docs/using-ai.md): Work on a Nera site with an AI assistant — AGENTS.md, docs for AI, the check loop and example prompts.

## Tutorials

- [Build a blog with Nera](https://nera.js.org/tutorials/build-a-blog.md): Scaffold a site, add posts, and list them newest-first with a local plugin.
- [Build a navigation with active states](https://nera.js.org/tutorials/custom-navigation.md): Use plugin-navigation to render a header and footer menu, with the current page highlighted.
- [Tag your content and get topic pages for free](https://nera.js.org/tutorials/tag-your-content.md): Add tags to pages with plugin-tags and get auto-generated tag overview pages and a tag cloud.
- [Add client-side search](https://nera.js.org/tutorials/add-search.md): Wire up plugin-search to generate an index and a working search box.
- [Add prev/next links between pages](https://nera.js.org/tutorials/prev-next-pagination.md): Use plugin-page-pagination to link sibling pages in reading order.
- [Open external links in a new tab](https://nera.js.org/tutorials/external-links-new-tab.md): Use plugin-link-attributes to add target and rel to outbound links automatically.
- [Add canonical links for SEO](https://nera.js.org/tutorials/canonical-links-seo.md): Use plugin-canonical-links to emit correct canonical and alternate-language link tags.
- [Write your own local plugin](https://nera.js.org/tutorials/write-a-local-plugin.md): Build a project-local plugin that adds data to app, using the getAppData hook.
- [How this website is built](https://nera.js.org/tutorials/how-this-site-is-built.md): A case study of the Nera site itself — the plugins, the ordering, and the local plugin behind it.

## Plugins

- [@nera-static/plugin-canonical-links](https://github.com/seebaermichi/nera-plugin-canonical-links): Adds canonical and alternate-language <link> tags for SEO.
- [@nera-static/plugin-code-blocks](https://github.com/seebaermichi/nera-plugin-code-blocks): Highlights fenced code blocks at build time, with a file name bar, copy button and shell prompts.
- [@nera-static/plugin-contact-form](https://github.com/seebaermichi/nera-plugin-contact-form): Renders a backend-free contact form that builds a mailto link on submit.
- [@nera-static/plugin-images](https://github.com/seebaermichi/nera-plugin-images): Generates responsive AVIF/WebP images with srcset, width/height and lazy loading at build time.
- [@nera-static/plugin-link-attributes](https://github.com/seebaermichi/nera-plugin-link-attributes): Rewrites links to add target, rel and other attributes.
- [@nera-static/plugin-navigation](https://github.com/seebaermichi/nera-plugin-navigation): Builds one or many navigations from config, with active states.
- [@nera-static/plugin-one-page](https://github.com/seebaermichi/nera-plugin-one-page): Assembles multiple sections into a single-page site.
- [@nera-static/plugin-page-navigation](https://github.com/seebaermichi/nera-plugin-page-navigation): In-page navigation generated from a page's headings.
- [@nera-static/plugin-page-pagination](https://github.com/seebaermichi/nera-plugin-page-pagination): Previous/next links between sibling pages in a directory.
- [@nera-static/plugin-popular-content](https://github.com/seebaermichi/nera-plugin-popular-content): Surfaces popular or featured pages in a list.
- [@nera-static/plugin-search](https://github.com/seebaermichi/nera-plugin-search): Generates a client-side search index and search box.
- [@nera-static/plugin-simple-page-list](https://github.com/seebaermichi/nera-plugin-simple-page-list): Renders a simple list of pages from a directory.
- [@nera-static/plugin-sitemap](https://github.com/seebaermichi/nera-plugin-sitemap): Generates a sitemap.xml of every rendered page and a robots.txt pointing to it.
- [@nera-static/plugin-social-media-links](https://github.com/seebaermichi/nera-plugin-social-media-links): Renders configurable social media icon links.
- [@nera-static/plugin-stacks](https://github.com/seebaermichi/nera-plugin-stacks): Groups related content into reusable stacks.
- [@nera-static/plugin-statistics](https://github.com/seebaermichi/nera-plugin-statistics): Computes reading time and other per-page statistics.
- [@nera-static/plugin-tags](https://github.com/seebaermichi/nera-plugin-tags): Tag pages and auto-generated tag overview pages.

## CLI

- [CLI reference](https://nera.js.org/docs/cli.md): The nera CLI — scaffold, build, preview, update, validate and check a site.
- [@nera-static/nera on npm](https://www.npmjs.com/package/@nera-static/nera): The one package a site depends on: the `nera` CLI with `new`, `build`, `dev`, `serve`, `validate`, `check` and `update`.

## Optional

- [llms-full.txt](https://nera.js.org/llms-full.txt): Every English docs page and tutorial above as one Markdown file, in reading order.