Blog / AI Automation

Introducing Swiss Directory: A Premium Next.js Starter Kit for People Who Refuse to Build Ugly Directories

Schuyler WhetstoneJul 18, 20257 min read

TL;DR: Swiss Directory is a premium Next.js 16 starter kit for building beautiful, scalable directory sites. Built on React 19, Tailwind CSS v4, Notion as a headless CMS, and Neon Postgres — with a design-first approach rooted in Swiss/International Typographic Style. Manage all content in Notion, deploy on Vercel, and stop building ugly directories.

Why Most Directory Sites Look Terrible

Let's be honest: the directory template market is a wasteland.

Search "directory template" on any marketplace and you'll find hundreds of results that all look the same — generic Bootstrap cards, uninspired layouts, and color schemes that scream "I downloaded this at 2 AM and changed the logo." They're functional. They're forgettable. And they make your brand look like a side project even when it isn't.

The problem isn't technical. Modern web frameworks make building directories straightforward. The problem is design. Nobody is building directory templates with real design principles. They're building them with "good enough" defaults and calling it done.

Swiss Directory exists because we believe directory sites should look like brands, not templates.

What Is Swiss Directory?

Swiss Directory is a production-ready Next.js starter kit for building directory websites. But calling it a "starter kit" undersells it — it's a complete, opinionated system for creating directories that are genuinely beautiful.

The name comes from the Swiss/International Typographic Style — a design philosophy born in 1950s Switzerland that emphasizes strict grids, precise typography, intentional whitespace, and content-first layouts. It's the design language behind some of the most iconic visual identities in history, and it's criminally underused in web development.

The Tech Stack

Swiss Directory is built on a modern, production-tested stack:

  • Next.js 16 — The latest version with React Server Components, server actions, and optimized performance
  • React 19 — Concurrent features, improved Suspense, and the latest React primitives
  • Tailwind CSS v4 — Utility-first CSS with the newest engine for faster builds and smaller bundles
  • Better-Auth — Authentication that actually works without fighting it
  • Notion as CMS — All content management happens in Notion via the API. No clunky admin dashboards.
  • Neon Postgres — Serverless PostgreSQL for the database layer (user data, analytics, etc.)
  • Vercel — One-click deployment with edge functions and automatic scaling

Why Notion as a CMS?

This is the decision that raises the most eyebrows — and the one we're most confident about.

Traditional CMS options (WordPress, Contentful, Sanity) add complexity, cost, and a learning curve. Notion eliminates all three:

  • You already know how to use it — No training needed for content updates
  • It's free for personal use — No CMS subscription fees
  • It's collaborative — Multiple people can edit content simultaneously
  • It's structured — Databases give you schema enforcement without building custom admin interfaces
  • It's fast to update — Change a property in Notion, and it's reflected on your site

The workflow is simple: create entries in your Notion databases (tools, stacks, blog posts), and Swiss Directory pulls them via the Notion API and renders them beautifully.

What's Included

Tools Directory

The core feature — a searchable, filterable directory of tools, products, or resources:

  • Category-based navigation — Browse by category with clean, grid-based layouts
  • Search — Full-text search across tool names, descriptions, and tags
  • Filtering — Filter by category, pricing model, platform, or custom attributes
  • Detail pages — Rich tool profiles with descriptions, screenshots, pricing, and links
  • Featured listings — Highlight premium or sponsored entries

All managed through a Notion database. Add a new tool? Create a row in Notion. Update pricing? Edit the property. It's live.

Curated Stacks

Grouped collections of tools that work well together:

  • Stack pages — Themed collections like "The Solopreneur Stack" or "The AI Content Creation Stack"
  • Tool relationships — Each stack references tools from the main directory
  • Use case descriptions — Context for why these tools work together
  • Comparison tables — Side-by-side feature comparisons within a stack

Blog Engine

A full blog system, also powered by Notion:

  • Rich content — Full Notion block support (headings, lists, callouts, code blocks, images, embeds)
  • Categories and tags — Organized content with filtered views
  • SEO optimization — Automatic meta tags, Open Graph images, and structured data
  • Reading time estimates — Calculated automatically from content length

Authentication

Built-in auth powered by Better-Auth:

  • Social login — Google, GitHub, or custom OAuth providers
  • Email/password — Traditional authentication with secure password handling
  • Protected routes — Gate premium content or features behind authentication
  • User profiles — Basic profile management out of the box

Design System

50+ pre-built components following Swiss design principles:

  • Typography components — Headings, body text, captions, all on a strict typographic scale
  • Layout components — Grid systems, containers, and spacing utilities
  • UI components — Cards, buttons, badges, navigation, forms
  • Dark mode — Full dark mode support with carefully chosen color mappings
  • Responsive design — Every component works across all screen sizes

The Design Philosophy

Swiss Directory isn't just a functional template — it's an opinionated design system. Here's what makes it different:

Strict Grid System

Every element is placed on a mathematical grid. Nothing is eyeballed. Nothing is "close enough." This creates the visual order and predictability that makes Swiss design feel so clean.

Typography-Driven Layout

Content is king, and typography is how content speaks. Swiss Directory uses a strict typographic scale with intentional hierarchy:

  • Headings establish structure
  • Body text is optimized for reading (16-18px, comfortable line height)
  • Captions and metadata provide context without competing for attention

Intentional Whitespace

Most templates are afraid of empty space. Swiss Directory embraces it. Whitespace isn't wasted space — it's breathing room that makes content more readable and layouts more elegant.

Contrast and Color

The default palette is deliberately restrained — primarily black, white, and one accent color. This isn't because we're boring. It's because restraint creates impact. When everything is colorful, nothing stands out. When your accent color is used sparingly, it commands attention.

Who Swiss Directory Is For

Perfect for:

  • Solopreneurs building niche directory sites (AI tools, SaaS products, local businesses)
  • Content creators who want a professional platform for curated recommendations
  • Agencies building directory sites for clients who need Notion-managed content
  • Developers who want a production-ready starter with strong design defaults
  • Anyone tired of directories that look like every other directory

Not ideal for:

  • Non-developers who need a completely no-code solution (you'll need to run npm install and deploy)
  • Enterprise teams needing complex role-based access control (Better-Auth covers basics, not enterprise RBAC)
  • Sites requiring real-time data (Notion API has rate limits; consider caching strategies for high-traffic sites)

Getting Started

Prerequisites

  • Node.js 18+
  • A Notion account with API integration set up
  • A Neon Postgres database (free tier works for getting started)
  • A Vercel account for deployment
  • A Google Cloud Console project (for OAuth, if using social login)

Setup (30 Minutes)

  1. Clone the repository — git clone and npm install
  2. Configure Notion — Duplicate the template databases into your workspace and connect the API
  3. Set environment variables — Notion API key, Neon connection string, auth secrets
  4. Run locally — npm run dev and verify everything connects
  5. Deploy — Push to Vercel with one click

The documentation walks through each step with screenshots. If you can follow a recipe, you can deploy Swiss Directory.

Day-to-Day Content Management

Once deployed, all content management happens in Notion:

  • Add a tool → Create a new row in the Tools database
  • Update a description → Edit the page content in Notion
  • Publish a blog post → Change the status property to "Published"
  • Create a stack → Add entries to the Stacks database and link related tools

No code changes needed for content updates. No deployments. No waiting.

What You Get

  • Complete source code — Full Next.js 16 project with TypeScript
  • 50+ components — Production-ready UI components following Swiss design
  • Notion CMS integration — Pre-configured database templates and API integration
  • Authentication — Better-Auth setup with social and email login
  • Dark mode — Full dark/light mode with system preference detection
  • SEO optimization — Meta tags, Open Graph, structured data, sitemap generation
  • Documentation — Setup guide, customization reference, and architecture overview
  • Lifetime updates — All future updates included with purchase

The Bottom Line

Swiss Directory exists for one reason: directory sites deserve better design.

If you're building a directory and you want it to look like a brand — not a Bootstrap template — Swiss Directory gives you a production-ready foundation with design principles baked in.

Manage everything in Notion. Deploy on Vercel. Look like you hired a design team.


Frequently Asked Questions

What tech stack does Swiss Directory use?

Next.js 16, React 19, Tailwind CSS v4, Better-Auth for authentication, Notion as a headless CMS, and Neon Postgres for the database layer. Deployed on Vercel.

Do I need to know how to code to use Swiss Directory?

You'll need basic familiarity with running a Next.js project (clone, install, deploy). But all content management happens in Notion — no code required for day-to-day updates.

What makes Swiss Directory different from other directory templates?

Design. Most directory templates are generic Bootstrap clones. Swiss Directory implements International Typographic Style principles — strict grids, precise typography, and intentional contrast — so your directory looks like a brand, not a side project.

Can I use Swiss Directory for any type of directory?

Yes. While the default configuration is built around AI tools and stacks, the architecture is completely customizable for any niche — SaaS tools, local businesses, creator resources, you name it.


Related Reading


Want to Build More Than a Directory?

AigencyAutomata helps solopreneurs and creators build Notion-powered web products — from directory sites to client portals to content engines.

👉 Explore our services or reach out at inquiry@aigencyautomata.com.