findly.tools

Findly.tools boilerplate

Production-ready directory platform that generates revenue from day one.

This isn't a tutorial project—it's the exact codebase that powers a profitable SaaS directory. Clone, customize, deploy.

The platform is currently live and generating revenue. You're getting battle-tested code, not an experiment.

What's included

Revenue streams

  • Subscription tiers — Monthly/yearly plans with customizable limits
  • Advertisement system — Self-service tool promotion with flexible pricing
  • Automatic billing — Stripe handles everything
  • Early bird pricing — Auto-applied discount for first month

Core features

  • OAuth authentication — Google + GitHub (Better Auth)
  • Admin dashboard — Revenue tracking, user management
  • Tool submission — Auto-extract metadata, 5MB image uploads
  • Zero maintenance — Daily cron jobs, webhooks, auto-expiration

Developer experience

  • Easy customization — Centralized configuration system
  • Type-safe — Full TypeScript, Drizzle ORM
  • Modern stack — Next.js 15, React 19, Tailwind CSS
  • One-click deploy — Vercel-optimized with automatic scaling

Business model

  1. Smart approach — First tool submission triggers subscription checkout
  2. Tiered limits — You define tool limits per subscription tier
  3. Advertisement revenue — Boost existing tools or submit new ones
  4. Recurring revenue — Monthly/yearly plans with automatic renewals

Easy Customization - Single Config File

Everything is centralized in lib/constants/config.ts

export const SUBSCRIPTION_PLANS = {
  // Modify these prices for your business
  PRICES_MONTHLY: {
    "starter-monthly": 500,  // $5/month
    "plus-monthly": 1500,    // $15/month
    "max-monthly": 3000,     // $30/month
  },
  
  // Tool limits per plan
  LIMITS: {
    "starter-monthly": 1,    // 1 tool
    "plus-monthly": 5,       // 5 tools
    "max-monthly": 10,       // 10 tools
  },
};

export const ADVERTISEMENT_CONFIG = {
  DAILY_RATES: {
    all: 5,        // $5/day for all pages
    homepage: 4,   // $4/day for homepage only
  },
  DISCOUNT: {
    PER_DAY_PERCENT: 1,  // 1% discount per day
    MAX_PERCENT: 30,     // Maximum 30% discount
  },
};

Change one number → entire platform updates automatically

Professional Architecture

Type-Safe Configuration

  • Centralized business logic in config.ts
  • Type-safe error messages and constants
  • Consistent API responses across all endpoints

Robust Authentication

  • Better Auth with Stripe integration
  • Automatic subscription limit synchronization
  • Real-time plan updates and downgrades

Smart Business Logic

  • Automatic tool activation/deactivation
  • Subscription upgrade/downgrade handling
  • Advertisement boost system with conflict resolution

Admin Operations

  • Real-time MRR and churn rate calculations
  • User management and analytics
  • Advertisement campaign monitoring

Revenue Features

Subscription Management

  • Plan limits automatically enforced
  • Tool selection and rebalancing
  • Upgrade/downgrade flows
  • Cron job enforcement for expired subscriptions
  • Boost existing tools or submit new ones
  • Flexible placement options (homepage/all pages)
  • Discount system based on duration
  • Automatic expiration and cleanup

Business Intelligence

  • MRR tracking with plan-based calculations
  • Churn rate monitoring
  • User analytics and growth metrics
  • Discord notifications for all business events

Business Model Examples

Example 1: SaaS Tools Directory

  • Starter: 1 tool → $19/month
  • Pro: 5 tools → $49/month
  • Business: 15 tools → $99/month

Example 2: Local Business Directory

  • Basic: 1 listing → $9/month
  • Premium: 3 listings → $24/month
  • Enterprise: 10 listings → $79/month

Example 3: Job Board

  • Starter: 1 job → $29/month
  • Growth: 5 jobs → $79/month
  • Scale: 20 jobs → $199/month

Enterprise-Ready Features

Security & Validation

  • Cloudflare Turnstile protection
  • Comprehensive input validation
  • SQL injection prevention
  • Rate limiting and abuse protection

Performance & Scalability

  • Optimized database queries
  • Efficient caching strategies
  • CDN integration for images
  • Auto-scaling with Vercel

Ready for Production

This boilerplate is already powering live, profitable directories. You get:

  • Tested business model — Proven revenue streams
  • Production code — No experimental features
  • Scalable architecture — Handles growth automatically
  • Complete documentation — Setup guides and customization
  • Ongoing updates — New features and improvements

Build your directory business.