sofyansolutions/kasapro-frontend repository overview

⁠Kasapro Frontend Web Application

Kasapro Frontend is the web application for Kasapro POS system, built with Next.js 14, React 18, and TypeScript. Part of the Kasapro POS suite designed for UMKM (small and medium enterprises) in Indonesia.

⁠Quick Start

# Pull the image
docker pull sofyansolutions/kasapro-frontend:latest

# Or use specific version
docker pull sofyansolutions/kasapro-frontend:v1.0.0

⁠Usage

This image is designed to be used as part of the complete Kasapro stack. For standalone usage, see the configuration section below.

⁠With Docker Compose (Recommended)

services:
  frontend:
    image: sofyansolutions/kasapro-frontend:${ERP_VERSION:-latest}
    environment:
      - NEXT_PUBLIC_API_URL=https://localhost:9443/api
    depends_on:
      - backend

See the complete installation guide⁠ for full docker-compose setup.

⁠Configuration

⁠Required Environment Variables

• NEXT_PUBLIC_API_URL - Backend API URL
  • Format: https://domain:port/api or http://domain:port/api
  • Example: https://localhost:9443/api

⁠Optional Environment Variables

• NODE_ENV - Node environment (default: production)
• NEXT_TELEMETRY_DISABLED - Disable Next.js telemetry (default: 1)

⁠Features

• Progressive Web App (PWA) - Installable on mobile and desktop
• Offline Mode - Continue working without internet connection
• Mobile Responsive - Works on tablets and smartphones
• Modern UI - Built with Tailwind CSS
• TypeScript - Type-safe codebase
• Production Optimized - Optimized builds for production

⁠PWA Installation

The frontend can be installed as a Progressive Web App:

1. Open the application in a supported browser (Chrome, Edge, Safari)
2. Look for the install prompt or use browser menu
3. Install to home screen/desktop
4. Launch like a native app

⁠Offline Mode

Kasapro supports offline mode for POS operations:

• Transactions can be created offline
• Data syncs when connection is restored
• Works seamlessly with backend API

⁠Ports

• 3100 - HTTP web server (default)

⁠Volumes

No volumes are required. The application is fully self-contained.

⁠Dependencies

• Backend API service (required)
• Modern web browser with JavaScript enabled

⁠Browser Support

• Chrome/Edge (latest)
• Firefox (latest)
• Safari (latest)
• Mobile browsers (iOS Safari, Chrome Mobile)

⁠Tags

• latest - Latest stable release
• v1.0.0, v1.1.0, etc. - Versioned releases
• sha-abc123 - Development builds (commit SHA)

⁠Full Documentation

For complete installation guide, configuration options, and troubleshooting:

• GitHub Repository: on progress
• Documentation: on progress
• Quick Start Guide: See sofyansolutions/kasapro repository

⁠Related Images

• sofyansolutions/kasapro-backend - Backend API service
• sofyansolutions/kasapro-nginx - Nginx reverse proxy with SSL

⁠Support

• Website: on development
• Support Email: [email protected]⁠
• Documentation: on development

⁠License

See the main Kasapro repository for license information.

Made with ❤️ for UMKM Indonesia

Kasapro - Kasa Professional untuk Toko Anda