Join our Discord community:

Wildberry

A comprehensive in-app purchase and subscription management system with a modern React frontend and robust TypeScript backend.

Overview

Wildberry provides a complete solution for managing in-app purchases, subscriptions, and entitlements. It includes:

• Frontend: Modern React application with Material-UI
• Backend: TypeScript-based API with PostgreSQL
• Authentication: JWT-based auth with API key support
• Analytics: Built-in subscription and revenue analytics
• Audit Logs: Comprehensive activity tracking

Getting Started

Prerequisites

• Node.js >= 16
• PostgreSQL >= 15
• npm or yarn

Docker Setup

Development Environment

Run the entire stack in development mode with hot-reloading:

docker compose -f docker-compose.dev.yaml up -d

This will start:

• Frontend: http://localhost:3001
• Backend API: http://localhost:3000
• pgAdmin: http://localhost:5050
• PostgreSQL: localhost:5432

Production Environment

For production deployment:

docker compose up -d

Individual Service Management

Start specific services:

# Start only backend services
docker compose up -d backend postgres

# Start only frontend
docker compose up -d frontend

# Start database management
docker compose up -d postgres pgadmin

View logs:

# All services
docker compose logs -f

# Specific service
docker compose logs -f frontend
docker compose logs -f backend

Rebuild services:

# Rebuild all
docker compose build

# Rebuild specific service
docker compose build frontend
docker compose build backend

Stop services:

# Stop all
docker compose down

# Stop and remove volumes
docker compose down -v

Backend Setup

1. Navigate to the backend directory:

cd back-end

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

4. Start the development server:

# Using Docker (recommended)
docker compose -f docker-compose.dev.yaml up -d

# Without Docker
npm run dev

The backend API will be available at:

• API: http://localhost:3000
• pgAdmin: http://localhost:5050 (when using Docker)
• API Documentation: http://localhost:3000/docs

Frontend Setup

1. Navigate to the frontend directory:

cd front-end

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env

4. Start the development server:

npm start

The frontend will be available at http://localhost:3001

Features

Backend Features

• Authentication & Authorization

  • JWT-based authentication
  • API key management
  • Role-based access control

• App Management

  • Multiple app support
  • Platform-specific configurations
  • Bundle ID validation

• Product Management

  • Subscription and one-time purchase support
  • Price and currency handling
  • Product lifecycle management

• Entitlements

  • Feature-based access control
  • Flexible entitlement mapping
  • Inheritance and grouping

• Offerings

  • Product bundling
  • Dynamic offering configuration
  • A/B testing support

• Analytics

  • Revenue tracking
  • Subscription metrics
  • User behavior analytics

• Audit Logging

  • Comprehensive activity tracking
  • Security event logging
  • Change history

Frontend Features

• Modern UI/UX

  • Material-UI components
  • Responsive design
  • Dark mode support

• Dashboard

  • Revenue metrics
  • Subscription analytics
  • User activity tracking

• Management Interfaces

  • Product management
  • Subscription handling
  • User management

• Mobile-First Design

  • Responsive layouts
  • Touch-friendly interfaces
  • Adaptive components

Development

Running Tests

Backend:

cd back-end
npm test

Frontend:

cd front-end
npm test

API Documentation

• API Documentation
• Architecture Documentation

Contributing

Please read our Contributing Guidelines before submitting pull requests.

Deployment

Backend Deployment

Using Docker:

cd back-end
docker compose up -d

Manual deployment:

cd back-end
npm run build
npm start

Frontend Deployment

cd front-end
npm run build
# Deploy the build directory to your hosting service

License

MIT License - see LICENSE file for details