Minted Directory Template

Minted Directory Template is a markdown-driven directory website starter built on Nuxt, Nuxt Content, and Tailwind CSS that turns flat files into an SEO-optimized static listing site.

What is the Minted Directory Template?

Minted Directory Template is an open-source directory website template hosted on GitHub at masterkram/minted-directory. It accepts markdown files as its only content source, so listing entries placed in the /content/dir folder are automatically rendered as directory pages, while articles in /content/blog become blog posts. The site runs on Nuxt with Nuxt Content for file-based content management and Tailwind CSS for styling, and it can be exported as a pre-rendered static site using the pnpm run generate command. Documentation and a live demo are available at minteddirectory.com.

Key Features

• Markdown-based listings — Add directory entries as markdown files in /content/dir; no database or CMS setup is required.
• Batteries-included SEO — Ships with the Nuxt SEO module, so metadata, sitemaps, and social-sharing basics are covered out of the box.
• Pre-built directory components — Includes ready-made UI components designed for listing layouts, reducing the amount of front-end work needed.
• Customizable theming — Change the primary color, secondary color, and font family in tailwind.config.ts, plus adjust site-wide settings through app.config.ts.
• Dark and light mode — Built-in theme toggle lets visitors switch between light and dark appearances.
• Sponsored content support — Mark listings as sponsored to display them as promoted entries, creating a monetization path for the directory.
• Blog included — Add markdown files to /content/blog to publish articles alongside the directory content.

Who is it for?

• Indie hackers and side-project creators: Launch a niche directory quickly by writing markdown files instead of wiring up a CMS or database.
• Developers who prefer static sites: Use Nuxt and the generate command to produce a pre-rendered static site without managing a server.
• SEO-focused site owners: Take advantage of the bundled Nuxt SEO module to handle metadata without extra configuration.
• Small editorial teams: Publish both directory listings and a blog from the same markdown folder structure.

What can you do with it?

• Launch a curated tool directory: Add tools or resources as markdown entries in /content/dir and present them with the pre-built components.
• Build a sponsored listings flow: Mark specific entries as sponsored to display them as promoted content, mirroring common directory business models.
• Publish a companion blog: Store articles in /content/blog to support the directory with guides and news.
• Rebrand the front-end: Swap colors and fonts through tailwind.config.ts to match a niche audience without touching layout code.

How does it work?

Start by duplicating the GitHub template, then clone it locally or run gh repo create my-directory --template masterkram/minted-directory --private --clone. Install dependencies with pnpm install, launch the dev server with pnpm dev, and add markdown files to /content/dir for listings or /content/blog for articles. When ready, run pnpm run generate to export a pre-rendered static site for deployment.

FAQ

How do I add a listing to Minted Directory?

Add a new markdown file to the /content/dir folder. The template reads these files and renders them as directory entries, so you don't need a database or admin panel to publish content.

How do I customize the colors and fonts?

Open tailwind.config.ts and change the primary, secondary, and fontFamily settings. The README also points to app.config.ts for additional site-wide configuration, with a settings guide available on the docs site.

Does Minted Directory support blog posts?

Yes. Create markdown files in the /content/blog folder to add articles, and the Nuxt Content integration handles rendering them on the site.

How do I deploy the site?

Run pnpm run generate to generate a pre-rendered static version of the site. The official deployment guide is linked in the README at minteddirectory.com/docs/deployment.

Can I use it with any package manager?

The README's setup commands use pnpm. The repository does not mention support for npm or Yarn, so sticking with pnpm is the safest path.