A comprehensive customer retention platform that helps businesses identify at-risk customers and automate recovery workflows to reduce churn.
Churn Saver is an intelligent customer retention platform designed to help businesses proactively identify customers at risk of churning and implement automated recovery strategies. Our platform combines real-time analytics, AI-powered insights, and automated workflows to maximize customer retention and lifetime value.
- Automated Churn Detection: AI-powered algorithms identify customers at risk of churning based on usage patterns and behavior
- Intelligent Recovery Workflows: Automated multi-channel recovery sequences with personalized incentives
- Real-time Analytics Dashboard: Comprehensive KPIs and insights into retention metrics
- Flexible Incentive Management: Configurable incentive programs with budget tracking and ROI analysis
- Seamless Integrations: Native integration with Whop API and other popular platforms
- Enterprise-grade Security: Role-based access control, data encryption, and GDPR compliance
- Increase Retention Rate: Average recovery rate of >25% for at-risk customers
- Maximize ROI: Average return on incentive investment of >300%
- Reduce Time to Recovery: Average recovery time of <7 days from trigger to success
- Scalable Solution: Built to handle enterprise-level customer volumes
- Runtime: Node.js 18+
- Framework: Next.js 14 (App Router)
- Database: PostgreSQL 15+ with Prisma ORM
- Cache: Redis 6+
- Message Queue: Built-in (Redis-based)
- Framework: Next.js 14 with React 18
- Styling: Tailwind CSS
- UI Components: Radix UI + shadcn/ui
- State Management: React hooks + Context
- Hosting: Vercel (serverless functions, edge network)
- Database: Supabase (PostgreSQL with RLS)
- Monitoring: Vercel Analytics, Supabase Dashboard
- CI/CD: GitHub Actions + Vercel
- Payment Processing: Whop API
- Email Delivery: SMTP/Postmark
- AI Services: OpenRouter (Gemini, GPT)
- Analytics: Custom events + DataDog
Before you begin, ensure you have the following installed:
- Node.js: Version 18.x or higher
- pnpm: Version 9.15.9 or higher (package manager)
- PostgreSQL: Version 14.x or higher
- Git: Version 2.x or higher
- GitHub account: For repository access and collaboration
-
Clone the Repository
git clone https://github.com/your-org/churn-saver.git cd churn-saver -
Install Dependencies
# Install dependencies using pnpm pnpm install -
Environment Setup
# Copy the environment template cp .env.example .env.local # Edit .env.local with your configuration # You'll need to configure database connection, API keys, etc.
-
Database Setup
# Start PostgreSQL (using Docker recommended) docker-compose up -d postgres # Run database migrations pnpm run db:migrate # Seed development data (optional) pnpm run db:seed
-
Start the Application
# Start the development server pnpm dev -
Access the Application
- Open your browser and navigate to
http://localhost:3000 - The application should now be running locally
- Open your browser and navigate to
Churn Saver follows a monorepo structure with clear separation of concerns:
churn-saver/
├── apps/ # Application packages
│ └── web/ # Main Next.js web application
│ ├── src/ # Source code
│ ├── public/ # Static assets
│ ├── docs/ # Application-specific documentation
│ └── test/ # Test files
├── docs/ # Main documentation
│ ├── api/ # API documentation
│ ├── deployment/ # Deployment guides
│ ├── features/ # Feature documentation
│ ├── getting-started/ # Setup and installation guides
│ └── security/ # Security documentation
├── infra/ # Infrastructure and configuration
│ ├── migrations/ # Database migrations
│ └── docs/ # Infrastructure documentation
├── supabase/ # Supabase configuration
├── tasks/ # Build and deployment tasks
├── .github/ # GitHub workflows and templates
└── CONTRIBUTING.md # Contribution guidelines
apps/web/: Main Next.js application with all source codedocs/: Comprehensive documentation covering all aspects of the platforminfra/migrations/: Database schema migrationsapps/web/src/server/services/: Business logic and service implementationsapps/web/src/components/: React components organized by featureapps/web/src/lib/: Utility libraries and integrations
We maintain comprehensive documentation to help you get started and make the most of Churn Saver:
- Developer Documentation - Complete developer guide
- Getting Started Guide - High-level platform introduction
- Setup Guide - Complete local development setup
- REST API Reference - Complete API reference with examples
- Webhooks Documentation - Real-time event notifications
- Authentication Guide - API security and access control
- Development Workflow - Development setup and workflow
- Component Library - UI components and usage
- Database Schema - Database structure and relationships
- Production Deployment - Complete production setup
- Security Configuration - Security best practices
- Monitoring Setup - Observability and alerting
We welcome contributions from the community! Please follow our guidelines to ensure a smooth contribution process:
- Read our Contributing Guide - Detailed guidelines for contributors
- Fork the Repository - Create your own fork to work on
- Create a Feature Branch - Use descriptive branch names
- Make Your Changes - Follow our coding standards and conventions
- Submit a Pull Request - Include tests and documentation updates
Please read and follow our Code of Conduct to ensure a welcoming and inclusive environment for all contributors.
- Ensure your code follows our coding standards
- Include tests for new functionality
- Update documentation as needed
- Use conventional commit messages
- Request appropriate code reviews
This project is licensed under the MIT License. See the LICENSE file for details.
MIT License
Copyright (c) 2025 Churn Saver
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
| Metric | Target | Description |
|---|---|---|
| Recovery Rate | >25% | Percentage of at-risk customers successfully retained |
| Time to Recovery | <7 days | Average days from trigger to successful recovery |
| ROI | >300% | Return on incentive investment |
| Uptime | 99.9% | System availability SLA |
| Response Time | <200ms | API response time (p95) |
- Documentation: This site (comprehensive guides and API reference)
- GitHub Issues: Bug reports and feature requests
- GitHub Discussions: General questions and community support
- Status Page: status.churnsaver.com
- Incident Response: 24/7 on-call engineering team
- Security Issues: security@churnsaver.com (responsible disclosure)
- Sales: sales@churnsaver.com
- Customer Success: success@churnsaver.com
- Training: training@churnsaver.com
Questions? Check our documentation or create a GitHub Discussion.
Found an issue? Please report it so we can improve the platform.