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
- Smart approach — First tool submission triggers subscription checkout
- Tiered limits — You define tool limits per subscription tier
- Advertisement revenue — Boost existing tools or submit new ones
- 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
Advertisement System
- 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.