Admin Dashboard | ShipSaaS Documentation | ShipSaaS - Launch your SaaS with AI in days

The boilerplate includes a comprehensive admin dashboard for managing subscription plans, monitoring customer subscriptions, and analyzing payment data.

Universal Feature: This admin dashboard works with both Better Auth and Custom Boilerplate payment systems. You can manage all subscriptions and customers from the same interface regardless of how they were created.

Perfect for: Complete business management with plan configuration, customer oversight, revenue tracking, and operational analytics.

Admin Dashboard Overview

The admin dashboard is accessible at /admin/ (requires ADMIN role) and includes specialized sections for payment management:

Location: /admin/plans/Features:

Create and edit subscription plans
Configure pricing and billing cycles
Set feature limits and restrictions
Manage plan availability
Sync with Stripe products/prices

Plan Configuration:

Monthly/yearly pricing options
Feature toggles and limits
User seat management
Trial period settings

Admin Plans Management Interface:

Plan Limits Configuration: Plan limits configuration interface

Plan Management Interface

Creating Subscription Plans

Plan Creation Process:

Basic Plan Information

Configure core plan details:

// Plan structure (conceptual)
interface PlanConfiguration {
  name: string              // "Professional Plan"
  code: string             // "pro-monthly"
  description: string      // Plan description
  isActive: boolean       // Plan availability
  isRecurring: boolean    // One-time vs recurring
}

Pricing Configuration

Set up pricing structure:

interface PricingConfiguration {
  monthlyPrice: number     // Monthly subscription price
  yearlyPrice: number      // Annual subscription price
  currency: string         // "USD", "EUR", etc.
  trialDays: number       // Free trial period
  setupFee?: number       // One-time setup cost
}

Feature Limits

Define plan limitations:

interface PlanLimits {
  maxUsers: number         // User seat limit
  maxProjects: number      // Project limit
  maxStorage: number       // Storage in GB
  apiCalls: number        // Monthly API call limit
  features: string[]      // Available features
}

Stripe Integration

Connect with Stripe products:

Link to Stripe Product ID
Associate with Price IDs (monthly/yearly)
Configure billing intervals
Set up metered billing (if applicable)

Plan Management Features

Plan Operations:

Editable Properties:

Plan name and description
Feature availability toggles
Usage limits and quotas
Plan visibility (public/private)
Marketing copy and benefits

Change Management:

Version control for plan changes
Grandfathering existing customers
Migration tools for plan updates
A/B testing different plan configurations

Subscription Analytics

Revenue Dashboard

Key Metrics:

Monthly Recurring Revenue (MRR)
Annual Recurring Revenue (ARR)
Customer Lifetime Value (CLV)
Churn rate and retention
Revenue by plan type

Visual Analytics:

Revenue trend charts
Plan popularity metrics
Geographic revenue distribution
Cohort analysis
Subscription growth rates

Customer Analytics

Subscription Metrics:

New subscriptions per period
Subscription upgrades/downgrades
Cancellation reasons
Trial conversion rates
Payment success rates

Customer Insights:

Customer acquisition cost
Time to first payment
Feature usage by plan
Support ticket correlation
User engagement scores

Payment Management Tools

Failed Payment Resolution

Payment Failure Handling:

Failure Detection

Automatic identification of:

Declined credit cards
Insufficient funds
Expired payment methods
Bank authentication failures
Fraud prevention blocks

Customer Communication

Automated notification workflows:

Email payment failure alerts
In-app payment reminders
SMS notifications (if configured)
Grace period notifications
Final warning messages

Recovery Actions

Admin tools for recovery:

Manual payment retry
Payment method updates
Subscription pause options
Customer outreach tools
Dunning management

Account Management

Flexible account handling:

Graceful service degradation
Feature restriction scheduling
Account suspension workflows
Data retention policies
Reactivation procedures

Refund Processing

Refund Management:

Partial and full refunds
Refund reason tracking
Automatic credit applications
Stripe refund integration
Customer refund history

Refund Workflows:

Admin-initiated refunds
Customer self-service refunds
Automatic refund rules
Refund approval processes
Financial reporting integration

Customer Support Integration

Subscription Support Tools

Customer Account Access:

Complete subscription history
Payment method information
Usage and billing details
Feature access levels
Support ticket correlation

Support Actions:

Subscription modifications
Payment issue resolution
Plan change assistance
Billing inquiry handling
Account troubleshooting

Communication Tools

Customer Outreach:

Targeted email campaigns
Subscription health notifications
Renewal reminders
Upgrade suggestions
Win-back campaigns

Operational Management

Plan Performance Monitoring

Plan Analytics:

Plan conversion rates
Revenue per plan
Customer satisfaction by plan
Feature utilization rates
Support ticket volume by plan

Business Intelligence

Strategic Insights:

Market segmentation analysis
Pricing optimization recommendations
Feature development priorities
Customer success metrics
Competitive positioning data

Security & Compliance

Data Protection

Security Measures:

PCI DSS compliance
Data encryption at rest
Secure API communications
Access control and logging
Regular security audits

Compliance Management

Regulatory Compliance:

GDPR data protection
SOX financial controls
PCI DSS requirements
Regional tax compliance
Audit trail maintenance

Admin Access Control

Role-Based Access

Admin Role Requirements:

// Admin dashboard access control
interface AdminAccess {
  role: 'ADMIN' | 'SUPER_ADMIN'
  permissions: {
    viewPlans: boolean
    editPlans: boolean
    viewSubscriptions: boolean
    manageCustomers: boolean
    processRefunds: boolean
    viewAnalytics: boolean
  }
}

Audit Logging

Activity Tracking:

All admin actions logged
Plan change history
Customer account modifications
Payment processing actions
System configuration changes

Testing Admin Features

Access Admin Dashboard

Ensure user has ADMIN or SUPER_ADMIN role
Navigate to /admin/
Verify access to payment sections

Test Plan Management

Create a test subscription plan
Configure pricing and features
Sync with Stripe products
Test plan visibility on frontend

Monitor Test Subscriptions

Create test subscriptions
View in admin subscription monitor
Test manual subscription modifications
Verify webhook data synchronization

Test Analytics and Reporting

Generate test transaction data
Verify analytics calculations
Test export and reporting features
Check data accuracy and completeness

Complete admin dashboard ready! You have full control over subscription plans, customer management, and payment operations with comprehensive analytics and monitoring tools.