Mkdirs

What is Mkdirs

Mkdirs is a directory boilerplate for building and launching a directory website without starting from zero. It combines a front-end template, a content workflow, and monetization-friendly features in one open-source package. The site positions it as a way to launch an AI-powered directory in about 30 minutes, although real setup time will depend on your customization and deployment choices.

The directory boilerplate is built around the core things a directory site needs: listings, search, filters, submissions, blog content, authentication, newsletters, and SEO. It also includes a built-in Sanity Studio for content management, so item and content edits can be handled in the CMS rather than hard-coded into the app.

Because Mkdirs is open source, it is best understood as a starter framework for a directory business, not a hosted SaaS. You configure it, deploy it to your own platform, and manage the content yourself.

Key features

Mkdirs focuses on the practical pieces that make a directory boilerplate useful for real publishing and monetization.

• Advanced listings experience: search by item name, description, or rich text content, plus filterable and sortable results.
• Detailed item pages: listing pages are designed to give each item its own structured presentation.
• Sanity CMS integration: content management covers items, categories, tags, blogs, and users inside Sanity Studio.
• Authentication: built on Auth.js with email/password login, email verification, password reset, and Google or GitHub sign-in.
• Submissions: supports both free and paid submissions, including a form with AI autofill, rich text editing, and image uploads.
• Monetization options: affiliate links, paid submissions, and sponsored ads are built into the concept of the boilerplate.
• Blog and email tools: includes a blog system, newsletter subscription and unsubscription, and React email templates.
• SEO and presentation: SEO metadata, Open Graph, autogenerated sitemap, dark mode, responsive design, and customizable themes are included.
• Tech stack: the project uses Next.js, Auth.js, shadcn/ui, Tailwind CSS, Sanity, Resend, Stripe, and the Vercel AI SDK.

For teams evaluating a directory boilerplate, the mix of CMS, auth, payments, and SEO is the main value. Mkdirs tries to remove the repetitive setup work that normally slows down a directory launch.

How to use it

1. Configure your directory boilerplate. Clone the repository and adjust the website to match your niche, brand, and content structure.
2. Deploy the app. Publish it to your preferred hosting platform; the source material does not name a required host.
3. Manage content in Sanity Studio. Add and edit listings, categories, tags, blog posts, and users from the CMS.
4. Set up monetization. Use affiliate links, paid submissions, or sponsored ad placements if those fit your business model.
5. Customize the experience. Tune the theme, layouts, and pages so the directory matches your audience and content strategy.

This directory boilerplate is most useful when you want a fast path from idea to live site. The built-in workflow is aimed at people who want to spend more time on content and growth, and less time wiring together auth, payments, and CMS logic.

Who it is for

Mkdirs is a good fit for makers who want a directory boilerplate with monetization features already planned in.

• Indie founders building niche directories around tools, services, communities, or resources.
• Creators and marketers who need a searchable directory plus blog and newsletter support.
• Developers who want a Next.js-based directory boilerplate instead of assembling auth, CMS, and payments independently.
• Operators planning revenue through affiliate links, paid submissions, or sponsored placements.

The project also appears relevant to people who value speed. The marketing language emphasizes shipping faster and launching an AI-powered directory quickly, so Mkdirs is aimed at teams that want an opinionated starting point rather than a blank slate.

What to know before you use it

Mkdirs is a directory boilerplate, not a hosted directory platform, so you should expect setup, deployment, and ongoing maintenance on your side. The site says it has no database or storage setup, but you still need to configure the project and the services it depends on.

A few practical caveats matter:

• The “30 minutes” launch claim is promotional, not a guaranteed timeline.
• AI autofill supports submission forms, but it is still a helper feature, not a replacement for review or moderation.
• SEO tools, Open Graph, and sitemap generation help with discoverability, but they do not guarantee rankings or traffic.
• Payment and email features depend on external services such as Stripe and Resend.
• If you need enterprise-grade guarantees, a fully managed SaaS, or a custom compliance review, you should verify those requirements separately before adopting this directory boilerplate.

If your goal is to ship a directory website with listings, submissions, CMS, and monetization built in, Mkdirs is a focused directory boilerplate worth evaluating. If you need a turnkey hosted service, check whether the self-hosted setup matches your workflow before you commit.