🦄 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 @next/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: https://next-app-mantine-docs-template.vercel.app
🧩 GitHub: https://github.com/gfazioli/next-app-mantine-docs-template
📚 Hub: https://mantine-extensions.vercel.app/


p/jot-2-0
p/interview-coach-3
p/runevr
p/google-cloud-platform
p/producthunt
p/findergit
p/lancetta
p/reso
p/many-displays
p/slotify-2
p/kodlo
p/ai-context-flow
p/airuncode
p/dino-kids
p/jev
p/supabase
p/lasso-11
p/aperture-7
p/raycast
Replies
Be the first to reply
Have a question or a thought to share? Add a comment above to start the conversation.