Introduction
What DirectoryKit is and what you can build with it.
What is DirectoryKit?
DirectoryKit is a ready-to-launch boilerplate for building directory websites: SaaS catalogs, AI tool lists, job boards, Product Hunt-style launchpads, and more. Everything you normally have to build from scratch — submissions, payments, auth, admin panel — is already wired up.
If you can edit a JSON file and copy-paste some API keys, you can ship a directory. No need to be a full-time developer.
What you'll get after setup
- A working website running on
http://localhost:3000in ~15 minutes - Users can sign up, submit projects, pay for premium listings
- You get an admin panel to approve/reject submissions
- Deploy to Vercel in 5 minutes when you're ready to go live
What you can build
- SaaS directories — curated tool lists with categories and ratings
- AI tool catalogs — trending AI products with plans and filters
- Job boards — listings with submissions, pricing tiers, and search
- Startup launchpads — Product Hunt-style discovery sites
- Resource directories — templates, assets, guides, links
- Local business directories — location-based listings
The tech stack (in one line each)
| Piece | What it does |
|---|---|
| Next.js 16 | The web framework. Pages, routing, server-side rendering. |
| React 19 | UI components. |
| TypeScript | Typed JavaScript — catches bugs before they happen. |
| Tailwind CSS + shadcn/ui | Styling. Pre-built beautiful components. |
| Supabase | Database + user auth + file storage. All-in-one backend. |
| Stripe | Payments. Collects money from users. |
| Resend | Email delivery. Welcome emails, notifications, etc. |
| pnpm | Package manager. Installs dependencies. Don't use npm. |
The project is configured for pnpm 10.4+. npm install will likely fail with dependency errors. Install pnpm first — it takes 10 seconds.
How customization works
Everything brand-specific lives in the config/ folder. You edit a config file, and the whole site updates — no code changes needed.
config/
├── site.config.ts ← your brand name, URL, social links
├── features.config.ts ← on/off switches for all features
├── plans.config.ts ← your pricing tiers
├── themes.config.ts ← 14 built-in color themes
└── ...11 more files, each controlling one thing
Think of it as a settings panel, but in code.
Prefer AI? You're in the right place
The boilerplate ships with AI-spec files (CLAUDE.md, AGENTS.md, Cursor rules, Copilot instructions) in the project root. That means any modern AI IDE — Claude Code, Cursor, Codex, Aider, Zed, GitHub Copilot — already knows the architecture, file paths, and conventions as soon as you open the project.
Throughout these docs you'll see purple AI Prompt boxes. Each one is a ready-to-paste instruction for your AI assistant — fill the {placeholders}, hit copy, paste into your AI chat, done.
I've just cloned the DirectoryKit boilerplate. My directory will be about {your niche, e.g. "AI writing tools"}.
Please:
- Update config/site.config.ts with name "{brand name}", tagline "{one-liner}", and contact email "{hello@yourdomain.com}".
- Replace seedCategories in config/directory.config.ts with 5-8 categories that fit my niche.
- Suggest a theme ID from config/themes.config.ts that matches my brand and set it as defaultColorTheme.
- Tell me what to do next (Supabase, Stripe, Resend env vars).
Follow the conventions in CLAUDE.md. Don't touch other files.
What's next
Four steps to launch:
- Requirements — accounts and tools to prepare (5 minutes)
- Getting Access — receive the code after purchase (2 minutes)
- Installation — get it running locally (10 minutes)
- Quick Start — customize it for your brand (15 minutes)
Start with Requirements.