Documentation v1.0

Junify Documentation

Complete guide to building, deploying, and scaling your e-commerce platform with Junify. From quick setup to advanced customization - everything you need to succeed.

Overview

Multi-Tenant SaaS

Junify enables businesses to create and manage their own online stores with complete data isolation and enterprise-grade security.

  • Complete tenant isolation
  • Row Level Security (RLS)
  • Custom domains support
Payment Processing

Integrated African payment providers with automated fee distribution and compliance features.

  • Hubtel & Paystack integration
  • Automated platform fees
  • Mobile money support
Technology Stack
Built with modern, scalable technologies for enterprise-grade performance

Frontend

Next.js 15TypeScriptTailwind CSSRadix UI

Backend

SupabasePostgreSQLRow Level Security

Integration

HubtelPaystackBrevo Email

Quick Start

Local Development
Get Junify running locally in under 5 minutes

1. Get Access

Contact the project administrator for repository access and setup instructions. This is a private repository.

bash
# After getting access, install dependencies
cd junify-saas
npm install

2. Environment Setup

env
# Copy environment template
cp .env.example .env.local

# Configure your environment variables
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Payment Providers
HUBTEL_CLIENT_ID=your_hubtel_id
PAYSTACK_SECRET_KEY=your_paystack_key

# Email Service
BREVO_API_KEY=your_brevo_key

3. Database Setup

bash
# Run database migrations
npx supabase db push

# Apply RLS policies
psql -h your-host -d postgres -U postgres -f scripts/001_create_core_schema.sql

4. Start Development Server

bash
npm run dev

Architecture

Multi-Tenant Design

Junify uses a shared database with tenant isolation through Row Level Security (RLS) and JWT-based authentication.

Complete data isolation
PostgreSQL with RLS
JWT-based tenant context
Scalable Infrastructure

Built on modern serverless architecture for automatic scaling and optimal performance.

Serverless functions
Edge deployment
Auto-scaling
System Architecture Diagram
High-level overview of Junify's architecture

Architecture diagram would be displayed here

Frontend → API Routes → Supabase → Payment Providers

API Reference

Authentication Endpoints
Manage user authentication and tenant access

POST /api/auth/signup

Create a new user account

bash
curl -X POST /api/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "securepassword",
    "firstName": "John",
    "lastName": "Doe"
  }'

POST /api/auth/login

Authenticate user and get access token

bash
curl -X POST /api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "securepassword"
  }'

Deployment

Production Checklist
Environment variables configured
Database migrations applied
RLS policies enabled
Payment providers configured
Email service tested
Domain and SSL configured
Performance Optimization
Image optimization enabled
Database connection pooling
CDN for static assets
Rate limiting configured
Environment Variables Reference
Complete list of required environment variables
env
# Core Configuration
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# App Configuration
NEXT_PUBLIC_APP_URL=https://yourdomain.com
ENCRYPTION_KEY=your_32_char_encryption_key

# Payment Providers
HUBTEL_CLIENT_ID=your_hubtel_client_id
HUBTEL_CLIENT_SECRET=your_hubtel_client_secret
HUBTEL_MERCHANT_ID=your_hubtel_merchant_id

PAYSTACK_PUBLIC_KEY=pk_live_your_key
PAYSTACK_SECRET_KEY=sk_live_your_key

# Email Service
BREVO_API_KEY=your_brevo_api_key

# Optional: Additional Services
STRIPE_PUBLIC_KEY=your_stripe_public_key
STRIPE_SECRET_KEY=your_stripe_secret_key

Frequently Asked Questions

Ready to Get Started?

Join thousands of businesses already using Junify to power their e-commerce operations