Mkdirs is an open-source scaffold (boilerplate) for directory-type websites, positioned as the "best directory scaffold," with built-in AI, item listings, payments, submissions, CMS, blog, authentication, Newsletter, SEO, and themes.
Purpose: Used to quickly build and manage directory-type websites. It is officially said that an AI-driven directory website can go live in 30 minutes, helping developers avoid coding from scratch. Materials show that 350+ creators already use it.
Main capabilities:
- Directory features: A feature-rich directory, supporting advanced keyword search by name, description, or rich text content, supporting filtering and sorting, and providing detailed item pages.
- Content management: Integrates the headless CMS Sanity, managing items, categories, tags, blog, and users through the built-in Sanity Studio. No need to configure a database or storage yourself.
- Authentication: Built-in secure authentication based on Auth.js, supporting email/password login, email verification and password reset, Google or GitHub login, and user account settings.
- Submission and monetization: Supports free and paid submissions. The submission form supports AI auto-fill, rich text editing, and image uploads, and supports sponsored ad submissions. Materials also mention ways to monetize such as earning commissions through affiliate links, offering paid submissions, and premium ad slots.
- Blog and Newsletter: Built-in blog system, supporting blog categories, authors, and rich text content; supports Newsletter subscription and unsubscription, using React email templates to send emails.
- Layout and themes: Built-in multiple page layouts and components, supporting dark mode, responsive design, and customizable themes.
- SEO: Built-in SEO metadata for all pages (especially items and blog), automatically generates Sitemap, and supports multiple languages.
- Documentation and tutorials: Provides complete documentation and video tutorials.
Tech stack: Uses a production-grade full-stack React framework, Next.js open-source authentication library, modern website components, a CSS framework for rapid UI development, headless CMS, developer email service, secure online payment service, and TypeScript open-source AI toolkit. The materials do not list the specific product names of each tech stack one by one (except Auth.js and Sanity).
Usage: The three-step process given in the materials is: 1. Clone the repository and customize the website to complete the directory configuration; 2. Deploy the project to the preferred platform; 3. Manage content in the CMS (built-in Sanity Studio). The materials mention "1 template, 3 codebases," and list the template demo site demo.mkdirs.com, as well as IndieHub (indiehub.best) and BoilerplateHunt (boilerplatehunt.com) built with Mkdirs.
Applicable scenarios: Suitable for independent developers and entrepreneurs who want to quickly build directory websites, portfolio collection sites, resource navigation sites, or vertical-domain directory sites, especially suitable for directory operation scenarios that require paid submissions, ad slots, and SEO traffic.
Limitations and gaps: The materials do not provide information such as specific pricing methods and prices, template license, list of supported platforms, performance metrics, specific names of each tech stack, and the models or providers behind the AI features. Not yet provided.
