🦄 Mantine Next.js + Docs 1.0: a docs template with no docs framework

Hey everyone 👋

The Mantine Next.js + Docs template is out as v1.0.0: a starter for documentation sites with no docs framework in between. The pages are compiled by /mdx, code is highlighted by Shiki at build time, search is Pagefind, and every piece of the interface is a Mantine 9 component: the shell, the sidebar, the table of contents, the ⌘K search, the code blocks.

The story: our docs sites ran on Nextra, and it served us well, until a newer zod broke its build. From then on every site had to wait for a Nextra release before it could update that dependency. When I listed what Nextra actually did for us, most of it was assembling libraries we could call ourselves.

So the template keeps only the glue: it reads content/ and its _meta files into a sidebar and wires each library to the next. It reads Nextra's layout unchanged, so a site moves over by copying its pages. Against our Nextra template, the JavaScript went from 732 to 301 KiB.

Version 1.0 also brings a new home page, drawn like a blueprint (graph paper, registration marks, dimension lines) and shared with our Nextra and Fumadocs templates, one paper colour each, with live GitHub stars and npm downloads. The 30-second film shows it going from a line drawing to the real interface.

The tip: before you adopt a framework, list what it does that a library call would not. If the list is short, the price is not the code you skip, it is the release schedule you inherit.

Would you pick a framework or a template for your next docs site? And what should a docs starter ship with that this one doesn't?

🎬 Video:


🔗 Demo:
🧩 GitHub:
📚 Hub:

6 views

Add a comment

Replies

Be the first to reply

Have a question or a thought to share? Add a comment above to start the conversation.