Directory SaaS Platform

Overview

A production-ready SaaS foundation for building directory and marketplace platforms — built so teams can skip months of boilerplate and start building product-specific features on day one. Multi-tenant, AI-ready, and engineered with enterprise patterns throughout.

What Was Built

Three Frontend Applications

• Client Portal — End-user directory browsing, search, and listing detail views
• Provider Dashboard — For businesses listing their services — profile management, booking/inquiry handling, analytics
• Admin Panel — Platform-level controls: tenant management, content moderation, billing, and observability

All three built with React, Vite, Tailwind CSS 4, and shadcn/ui.

Backend Platform (NestJS + Prisma)

• Multi-tenancy from day one — Subdomain-based tenant resolution, PostgreSQL Row-Level Security, tenant-scoped data throughout
• Enterprise auth — JWT + refresh token rotation, 3 user types (client, provider, admin), RBAC with granular permissions
• AI-powered search — Vercel AI SDK with Anthropic/OpenAI, SSE streaming, tool system for AI-assisted directory search
• Hybrid search — Meilisearch for full-text + pgvector for semantic/similarity search
• Background jobs — BullMQ with 6 named queues and a Bull Board monitoring dashboard
• Observability — Structured logging, error tracking, and health endpoints

Quality Infrastructure

• 729 unit tests — Jest with factory patterns, covering all critical business logic
• E2E test infrastructure — Full API test setup for integration scenarios
• Multi-stage Docker builds — Coolify-ready compose files for one-command deployment

Technical Highlights

Capability	Implementation
Multi-tenancy	PostgreSQL RLS + subdomain routing
AI Search	pgvector + Meilisearch hybrid
Auth	JWT, refresh rotation, 3 user types
Jobs	BullMQ, 6 queues, Bull Board
Testing	729 tests, Jest + factories
Deploy	Docker, Coolify-ready

Use Cases

This platform foundation has been used to build:

• Professional services directories (lawyers, doctors, consultants)
• B2B marketplace platforms
• Community-based listing platforms

Outcome

Teams using this foundation skip 3–4 months of architecture and boilerplate work and ship product features from week one. The multi-tenant foundation, tested codebase, and production Docker setup remove the most time-consuming early-stage engineering challenges.