✨ PixFlow Hub Changelog

A warm journey of progress — together 💛

✏️ December 2025 – Version [202507.12] - Full Editor Mode for Templates

✨ New Editor Modes

• ✅ Slots Mode (Default) - Predefined context slots with template prompt (backward compatible)
• ✅ Full Editor Mode - Users write custom prompts from scratch with rich text editor
• ✅ Both Mode (Hybrid) - Users choose their preferred workflow (slots or full)
• ✅ Template-Based Pricing - Template's basePixelCost applies regardless of editor mode
• ✅ @ References Everywhere - Context items work with @ mentions in all modes
• ✅ Backward Compatible - Existing templates default to "slots" mode

🧠 Smart Validation Logic

• ✅ Slots Mode - Required context slots enforced (guided workflow)
• ✅ Full Mode - No validation, complete creative freedom
• ✅ Both Mode - Validates only when user uses slots approach
• ✅ Intent Detection - Automatically detects user's approach (custom prompt vs modifications)
• ✅ Context Flexibility - Text context items are free, image/chain items cost +1 pixel each

🔧 API Enhancements

• ✅ editorMode Field - Added to Template model with three values (slots/full/both)
• ✅ GET /api/templates - Now returns editorMode for all templates
• ✅ Admin CRUD - Full create/read/update/delete support for editorMode
• ✅ Context Generation - Handles all three modes intelligently
• ✅ Cost Estimation - Respects editor mode in cost calculations
• ✅ Template Cache - Includes editorMode field for optimal performance

📚 Comprehensive Documentation

• ✅ Implementation Guide - Complete technical details in FULL_EDITOR_MODE_IMPLEMENTATION.md
• ✅ Quick Reference - Developer-friendly guide in FULL_EDITOR_MODE_QUICK_REFERENCE.md
• ✅ Test Suite - 18 comprehensive test cases in FULL_EDITOR_MODE_TEST_SUITE.md
• ✅ Review Summary - Issues found and fixed in FULL_EDITOR_MODE_REVIEW_AND_FIXES.md
• ✅ API Specification - Updated CONTEXT_AWARE_IMAGE_GENERATION_API.md with examples
• ✅ Swagger Documentation - Complete API schema with enum values and descriptions

🔧 Bug Fixes & Improvements

• ✅ Fixed Missing editorMode - Public templates API now returns editorMode field
• ✅ Fixed Both Mode Validation - Corrected validation logic to detect user's approach
• ✅ Improved Swagger Docs - Added complete schema for editorMode field
• ✅ Enhanced Validation - Smart detection of slots vs full approach in "both" mode
• ✅ Code Quality - All linter checks pass, no TypeScript errors

🤖 November 2025 – Version [202507.11] - Gemini 3 Pro Image Preview Model

🤖 Gemini 3 Pro Image Preview Integration

• ✅ New Model: gemini-3-pro-image-preview - Google's latest Pro tier image generation model
• ✅ Template Support - Admins can assign Gemini 3 Pro as the model provider for templates
• ✅ Image Generator UI - Users can select "Gemini 3 Pro" in the model provider dropdown
• ✅ Image-to-Image API - `/api/generate-image` now accepts `gemini-3-pro` as modelProvider
• ✅ Text-to-Image API - `/api/generate-text-to-image` supports both `gemini` and `gemini-3-pro`
• ✅ Cost Estimation - Pricing configured for Gemini 3 Pro tier ($1.25/1M input tokens, $0.05/image)
• ✅ Admin Dashboard - New option in template creation for Gemini 3 Pro Image Preview
• ✅ Swagger Documentation - Updated API docs with new model provider option

📋 November 2025 – Version [202507.10] - Template Custom Sort

📋 Template Sort Functionality

• ✅ Order Field Exposed to Client - `/api/templates` now returns `order` field for each template
• ✅ Pre-Sorted API Response - Templates returned sorted by order (ascending), then createdAt (descending)
• ✅ Admin Dashboard Controls - Drag & drop reordering already available in Template Management tab
• ✅ Bulk Reorder API - `POST /api/admin/templates/reorder` for programmatic ordering
• ✅ Swagger Documentation - Updated API docs with order field specification
• ✅ Mobile App Ready - Clients can use order field for consistent display across platforms

🔐 January 2025 – Version [202507.9] - Google Direct Authentication API

🔐 Google Direct Authentication API

• ✅ New Endpoint: /api/auth/google-direct - Direct Google authentication for mobile apps
• ✅ ID Token Support - Accepts Google ID tokens from client-side Google Sign-In SDK
• ✅ Access Token Support - Alternative authentication using Google access tokens
• ✅ Server-Side Verification - Secure token verification using google-auth-library
• ✅ JWT Token Generation - Returns access token (1 hour) and refresh token (7 days)
• ✅ User Management - Automatic user creation/update with welcome bonus (5 pixels)
• ✅ Mobile App Optimized - CORS headers configured for React Native and Expo apps
• ✅ Swagger Documentation - Complete API documentation with request/response examples
• ✅ Error Handling - Comprehensive error responses with error codes
• ✅ Domain Tracking - Tracks which apps/domains users sign in from
• ✅ No Redirects Required - Eliminates need for OAuth redirects, WebViews, or popups
• ✅ PKCE Not Needed - Simplified flow perfect for mobile app authentication

📚 Implementation Details

• ✅ Package Added - google-auth-library (v10.5.0) for Google token verification
• ✅ Endpoint Location - src/pages/api/auth/google-direct.ts
• ✅ Environment Variables - Uses GOOGLE_CLIENT_ID and OAUTH_JWT_SECRET (or NEXTAUTH_SECRET)
• ✅ User Flow - Matches existing NextAuth user creation logic for consistency
• ✅ Welcome Bonus - New users receive 5 free pixels automatically
• ✅ Documentation - Complete guide available in GOOGLE_DIRECT_AUTH_API.md

💳 November 16, 2025 – Version [202507.8] - Stripe Payment Fixes & Invoice API

💳 Stripe Payment System Enhancements

• ✅ Mobile App Redirect Handler - Created payment redirect page for proper deep link handling
• ✅ Enhanced Webhook Support - Added support for async payment events (pending payments)
• ✅ Payment Status Checking - New endpoint to check payment status without processing
• ✅ Payment Verification - Manual payment verification endpoint for pending transactions
• ✅ Better Pending Payment Handling - Improved logging and error messages for pending payments
• ✅ Mobile App Detection - Automatic detection and proper redirect handling for mobile apps

📋 Invoice & Payment History API

• ✅ Get User Invoices Endpoint - GET /api/invoices with pagination and filtering
• ✅ Payment Status Check - POST /api/stripe/check-payment-status for real-time status
• ✅ Invoice Filtering - Filter by status (pending, completed, failed, refunded) and type
• ✅ Pagination Support - Efficient handling of large invoice lists with page/limit
• ✅ Payment Intent Details - Detailed payment information including charges and status
• ✅ User-Scoped Access - Users can only view their own invoices and payment status
• ✅ Invoice Model Update - Added support for stripe_purchase type (backward compatible)

🔧 Bug Fixes & Improvements

• ✅ Stripe Webhook Events - Added checkout.session.async_payment_succeeded and checkout.session.async_payment_failed handlers
• ✅ Invoice Creation - Fixed invoice creation to properly set paymentProvider and paymentCurrency fields
• ✅ Mobile Redirect Flow - Fixed redirect handling for mobile apps using deep links
• ✅ Payment Status Messages - Added helpful action messages (wait, needs_processing, completed, failed)

🚀 October 21, 2025 – Version [202507.7] - Apple Sign-In & NextFrame Complete

🔗 Landing Page Updates

• ✅ VPN Service Added - Added VPN access link (ams.devboy.ir) to Development section landing items below Bugsink

🍎 Apple Sign-In Implementation

• ✅ Complete Apple Sign-In Integration - Production-ready Apple authentication for iOS
• ✅ App Store Compliance - Required for App Store Review Guidelines 4.8 (apps using social login)
• ✅ JWT Token Generation - Automated Apple client secret generation with ES256 algorithm
• ✅ Server-Side Verification - Secure Apple ID token verification and user account creation
• ✅ Privacy-First - Email relay support with minimal data collection
• ✅ User Model Enhancement - Added appleId field with unique indexing
• ✅ NextAuth Integration - Seamless integration with existing authentication system
• ✅ Comprehensive Documentation - Setup guide, quick reference, and implementation summary

🎨 NextFrame Complete with 50+ Templates

• ✅ 50+ AI Templates - Across 4 major categories:
• • Social & Trendy (20+): Instagram, TikTok, YouTube, Twitter, LinkedIn, Facebook styles
• • Product & Fashion (10): High-fashion, editorial, street style, luxury aesthetics
• • Daily Use (10): Blog banners, invitations, greeting cards, presentations
• • Aesthetic (10+): Fantasy, sci-fi, artistic themes, vintage, modern art
• ✅ Template System Enhancements - Category navigation, tag filtering, compare slider

🎥 Video Support & Media Features

• ✅ Video Template Support - Video thumbnails for NextFrame AI templates
• ✅ Auto-Play on Visibility - Smart 35% visibility threshold for center detection
• ✅ Improved Video Zoom - Fill container like image cover mode
• ✅ Enhanced Scrolling - 220px bottom padding for extra scroll space
• ✅ NextFrame Video Migration - Complete migration support for video templates

🔄 User Experience Enhancements

• ✅ Pull-to-Refresh - Web-compatible implementation in library tab with native feel
• ✅ Profile Page Reorganization - Lazy loading, pagination for pixel usage history
• ✅ Image Generation Progress - Smooth progress animation with visual feedback
• ✅ Cross-Platform Download - CORS fallback, clipboard support (web), media library (mobile)
• ✅ React Hydration Fix - Resolved Error #418 for consistent SSR/CSR rendering

🍪 Cookie Consent & Privacy

• ✅ GDPR/CCPA/PECR Compliant - Full cookie consent system
• ✅ Granular Categories - Essential, Analytics, Preferences cookies
• ✅ Consent Banner & Modal - Beautiful UI with preference management
• ✅ Persistent Storage - User preferences saved across sessions
• ✅ Privacy Policy Integration - Complete privacy documentation

💳 Stripe Admin Dashboard

• ✅ Stripe Tab in Admin Dashboard - New dedicated Stripe management section
• ✅ Latest Invoices & Transactions - View recent invoices and balance transactions with full details
• ✅ Revenue Statistics - Total revenue, successful/failed payments, customer counts, and API usage metrics
• ✅ Account Balance Display - Available and pending balances by currency
• ✅ API Events Tracking - Breakdown of Stripe API events by type (webhooks, payments, etc.)
• ✅ Mode Indicator - Clear display of Test vs Live mode
• ✅ Admin-Only Access - Secure endpoints with admin authentication required
• ✅ Real-Time Data - Refresh button to fetch latest Stripe data on demand
• ✅ Comprehensive Tables - Detailed invoice and transaction tables with status indicators and links

🔧 Bug Fixes & Improvements

• ✅ iOS Build Fixes - Swift bridging, ExpoAppDelegate scope, expo-file-system v17 compatibility
• ✅ Web Build Fixes - CSP conflicts with Google Analytics resolved
• ✅ Firebase Integration - iOS Firebase compatibility fixes
• ✅ Network Improvements - Android CORS, retry with exponential backoff
• ✅ Template Processing - Edge case fixes and validation improvements

🔍 October 2025 – Version [202507.5] - Error Monitoring & Resilience

📋 Standardized Error Code System

• ✅ 55+ Error Codes Across 9 Categories:
• • AUTH_1xxx: Authentication & Authorization (5 codes)
• • DB_2xxx: Database Errors (6 codes) - MongoDB connection, query, timeout
• • STORAGE_3xxx: Storage Errors (5 codes) - S3 upload, download, connection
• • UPLOAD_4xxx: File Upload Errors (7 codes) - Size, type, compression, corruption
• • VALID_5xxx: Validation Errors (9 codes) - Required fields, formats, parameters
• • GEN_6xxx: Image Generation Errors (6 codes) - Failed generation, insufficient pixels
• • API_7xxx: External API Errors (9 codes) - OpenAI, Gemini, rate limits
• • SERVER_8xxx: Server Errors (4 codes) - Internal, configuration, maintenance
• • NET_9xxx: Network Errors (4 codes) - Connection refused, timeout, DNS
• ✅ Enhanced Error Response Format - Structured errors with code, details, timestamp, requestId, retryable flag, and retry delay
• ✅ Intelligent Error Mapping - Automatic detection, categorization, and contextual troubleshooting guidance
• ✅ Complete Swagger Documentation - All 55+ error codes documented with HTTP status mapping and examples

🔌 Enhanced Connection & Resilience

• ✅ MongoDB Connection Enhancements - Health checks, exponential backoff (5 retries), optimized timeouts (10s/45s/15s)
• ✅ Connection Pool Optimization - Min 2, Max 10 connections with 10-second heartbeat monitoring
• ✅ S3 Storage Enhancements - Environment validation, 30-second timeouts, 3 automatic retries
• ✅ Request ID Tracking System - Unique identifier for every API request in logs, errors, and database records
• ✅ Enhanced API Error Handling - Request IDs in all responses, detailed validation, automatic pixel refunds on failures
• ✅ Comprehensive Logging - Full request lifecycle tracking at every processing step
• ✅ Graceful Degradation - Automatic reconnection, retry logic, and fallback mechanisms

📱 Progressive Web App (PWA)

• ✅ Complete PWA Functionality - Installable on desktop and mobile with native app experience
• ✅ Professional Icon Set - 11 icon sizes (72px to 512px) with gradient design and camera branding
• ✅ Service Worker & Caching - Cache-first for fonts (365 days), Stale-while-revalidate for assets (24 hours), Network-first for APIs
• ✅ Smart Install Prompt - Auto-detection with 3-second delay, session memory, and gradient UI
• ✅ PWA Manifest - Standalone mode with app shortcuts (Generate Image, My Gallery)
• ✅ Comprehensive Meta Tags - iOS, Android, Open Graph, Twitter Cards, and Microsoft tiles
• ✅ Cross-Platform Support - Chrome, Safari, Firefox, Opera with full or partial support
• ✅ Offline Functionality - Cached assets work offline with background updates

✏️ Rich Text Editor & AI Assistant

• ✅ Professional TipTap Editor - Rich formatting (bold, italic, strikethrough), headings (H1-H3), lists, blockquotes
• ✅ Character & Word Count - Real-time tracking with 4000 character limit
• ✅ AI-Powered Prompt Assistant - 5 AI actions powered by Gemini 2.0 Flash Exp
• • Improve Action: Enhances prompts with better descriptors
• • Expand Action: Adds details while maintaining core concept
• • Simplify Action: Removes redundancy, keeps essentials
• • Brainstorm Action: Generates 3-5 creative variations
• • Chat Mode: Interactive conversation for custom guidance
• ✅ Beautiful Gradient UI - Blue-purple AI button, chat-style interface, smooth animations
• ✅ Template Management Integration - One-click access from admin dashboard template editor
• ✅ Dedicated API Endpoint - /api/admin/ai-assistant with full Swagger documentation

🎉 October 2025 – Version [202507.4] - NextFrame Launch

🎬 NextFrame Platform & Mobile App (v202507.4)

• ✅ NextFrame Platform Launch - Live at nextframe.video and api.nextframe.video
• ✅ Google Play Store Submission - Android app submitted for review (October 2025)
• ✅ OTA Updates System - Expo Updates for seamless app updates without store approval
• ✅ Google Analytics Integration - GA4 tracking with opt-out, respects cookie preferences
• ✅ 50+ NextFrame Templates - Social, Fashion, Product, and Aesthetic categories
• ✅ Template Features - Carousel, category navigation, tag filtering, compare slider
• ✅ Mobile App Features - Camera, gallery upload, filters, enhancement tools, generation history
• ✅ OAuth2 + PKCE - Secure mobile authentication with refresh token support
• ✅ Pixel Credit System - Real-time balance tracking with pagination
• ✅ React Native Stack - Expo SDK 54, React 19.1.0, React Native 0.81.4
• ✅ File-Based Routing - Expo Router 6.0 with tab navigation (Images, Library, Profile)
• ✅ Technical Stack - Firebase Auth, react-native-iap

✅ Security Enhancements (October 2025)

• ✅ Production-Safe Logging - Zero production logs with sensitive data sanitization
• ✅ Rate Limiting System - Redis-based rate limiting (strict, standard, image generation tiers)
• ✅ Input Validation Library - Comprehensive validation utilities (email, MongoDB, XSS prevention)
• ✅ Security Headers - Protection against clickjacking, XSS, MIME sniffing
• ✅ Health Check Endpoint - System monitoring with MongoDB and Redis connectivity checks
• ✅ Enhanced Database Resilience - Retry logic, graceful degradation, safe wrapper functions
• ✅ Separated JWT Secrets - OAuth and NextAuth secrets isolated for better security
• ✅ 25/25 Vulnerabilities Fixed - Complete security audit resolved

✅ Previously Completed Features

• ✅ Pixel Credit System - Complete credit management with magic links and invoices
• ✅ Rich Text Editor & AI Assistant - TipTap editor with Gemini AI prompt improvement
• ✅ 3D Steampunk Gallery - Interactive Three.js landing page
• ✅ Admin Dashboard - Comprehensive admin interface with template management, user statistics, and system monitoring
• ✅ Template Management API - Full CRUD operations for templates with image upload, reordering, and status management
• ✅ Enhanced Upload System - Improved file upload with compression, template processing, and NextFrame integration
• ✅ Swagger API Documentation - Complete API documentation with interactive Swagger UI interface
• ✅ Cost Tracking System - Detailed cost estimation and tracking for AI image generation with token usage monitoring
• ✅ Image Processing Utilities - Advanced image manipulation, compression, and format conversion capabilities
• ✅ Admin Authentication - Role-based access control for admin features and dashboard
• ✅ Template Image Upload - Support for template thumbnails with S3 integration
• ✅ Drag & Drop Reordering - Interactive template reordering in admin dashboard
• ✅ Search and Filtering - Advanced search and filtering capabilities for templates
• ✅ Enhanced Image Generation Schema Migration (41 records migrated)
• ✅ Comprehensive cost tracking with detailed breakdowns
• ✅ Enhanced response data capture (tokens, dimensions, response time)
• ✅ Improved cost estimation precision using image complexity
• ✅ Backward compatibility maintained for existing data
• ✅ pix-ai-app setup on web & expo with react-native
• ✅ meilisearch setup
• ✅ password manager setup
• ✅ N8N Setup
• ✅ Coolify Setup
• ✅ Domains page implementation
• ✅ Draw.io Infrastructure Architecture
• ✅ CloudFlare DNS set base with bij.pixflow.net
• ✅ Vercel setup
• ✅ GitHub Issues page
• ✅ Added API documentation endpoint
• ✅ Implemented Swagger API documentation
• ✅ Created changelog page
• ✅ Added MDX support
• ✅ Initial Repo Setup

💳 Payment & Credit System

• ✅ Pixel Credit System - Complete credit management infrastructure
• ✅ Credit balance tracking and history
• ✅ Credit consumption for image generation (1 pixel per image)
• ✅ Magic link distribution for promotional pixels
• ✅ Invoice system with transaction tracking
• ✅ Automatic refunds on generation failures
• ⏳ Stripe Integration - Payment processing (planned v202507.5)
• ⏳ Stripe webhook handling for payment events
• ⏳ Payment method management (cards, digital wallets)
• ⏳ Subscription billing and management
• ⏳ Purchasing Methods - Multiple payment options
• ⏳ One-time pixel purchases
• ⏳ Monthly/yearly subscription plans
• ⏳ Pay-per-use pricing model
• ⏳ Enterprise billing and invoicing
• ⏳ Promotional codes and discounts

📱 Mobile App Status

• ✅ Android App - Submitted to Google Play Store (October 2025, under review)
• ✅ Complete app bundle with release signing and store listing
• ✅ Android-specific UI/UX adaptations and performance optimization
• ✅ iOS App - Ready for build and submission!
• ✅ Apple Sign-In integration complete (App Store Guidelines 4.8 compliant)
• ✅ iOS IAP server infrastructure ready for StoreKit 2 integration
• ✅ All iOS build fixes applied (Swift bridging, ExpoAppDelegate, expo-file-system v17)
• ✅ Firebase Authentication with Auth Guard
• ✅ 150+ comprehensive documentation files
• ⏳ iOS build creation and App Store submission (next step)
• ✅ Completed Cross-Platform Features
• ✅ 50+ AI templates across 4 categories
• ✅ Video template support with auto-play
• ✅ Pull-to-refresh with native feel
• ✅ Progressive Web App (PWA) support
• ✅ Cookie consent system (GDPR/CCPA/PECR)
• ✅ Cross-platform image download
• ✅ OAuth2 + PKCE authentication
• ✅ Pixel credit system with pagination
• ✅ OTA updates for instant app updates
• ⏳ Upcoming Features
• ⏳ iOS App Store launch (Q1 2026)
• ⏳ StoreKit 2 client integration for iOS IAP
• ⏳ Android IAP with Google Play Billing (Q1 2026)
• ⏳ Biometric authentication (Touch ID/Face ID)
• ⏳ Push notifications for generation completion

🚀 Planned Features (v202507.8+)

• 🔲 iOS App Store Launch - Build creation and App Store submission (November 2025)
• 🔲 StoreKit 2 Client Integration - iOS IAP client implementation (HIGH PRIORITY)
• 🔲 Android IAP - Google Play Billing integration (HIGH PRIORITY)
• 🔲 Video-to-Next-Frame - Generate images from video frames (HIGH PRIORITY)
• 🔲 Stripe Payment Integration - Complete payment processing for web (HIGH PRIORITY)
• 🔲 Social Features - Image sharing and community features
• 🔲 Multi-language Support - Internationalization and localization
• 🔲 Advanced Templates - AI-powered template suggestions
• 🔲 Batch Processing - Multiple image generation in single request
• 🔲 Android CI/CD
• 🔲 Apple CI/CD
• 🔲 Clarity Docs
• 🔲 Clarity
• 🔲 Apple OAUTH Docs
• 🔲 Apple OAUTH
• 🔲 Google OAUTH Docs
• 🔲 Google OAUTH
• 🔲 stepfun x edit Setup
• 🔲 Comfy UI Setup
• 🔲 Novu Setup
• 🔲 Clerk Setup

Every box ticked brings us closer to the vision. Thank you for being part of this! 💛