Project structure

Find the right file without learning a large framework.

Files at a glance

Path Purpose
src/pages/docs/ Markdown documentation pages
src/_includes/layouts/base.njk Shared HTML shell
src/_includes/layouts/docs.njk Shared page shell
src/_includes/macros/nav.njk Recursive sidebar markup
src/_data/site.json Site name, description, and external link
src/assets/css/tokens.css Light and dark semantic tokens
src/assets/css/docs.css Docs components and responsive layout
src/pages/assets/styles.11ty.js Combines CSS into one output file
src/assets/app.js Theme, search, menu, and outline
eleventy.config.js Plugins, collection, Markdown setup

How a page renders

Eleventy reads front matter and renders Markdown, then places the HTML inside the Nunjucks layouts docs.njk and base.njk. Markdown files do not run through Nunjucks, so template syntax in examples stays literal. Use a .njk page when you need template loops or macros. The docs collection supplies the search index. The navigation plugin turns each page’s eleventyNavigation data into the sidebar tree.

Change the brand

Update src/_data/site.json for the name and links. Shared Hugeicons are defined in lib/icons.js; src/pages/assets/favicon.11ty.js generates the matching favicon. Color roles live in src/assets/css/tokens.css; page styling lives in src/assets/css/docs.css.