Dukarun

AI-powered point-of-sale system for modern small businesses

Dukarun helps shopkeepers ditch manual data entry and expensive barcode scanners. Use your phone's camera to instantly recognize products, process sales, and manage inventory—all powered by custom AI trained on your products.

Quick Start

First time? Run npm i at the project root first.

# 1. Install dependencies (required first time)
npm i

# 2. Start development (docker + all services)
npm run dev

# Troubleshooting?
npm run setup

Quick Links

• 🚀 Setup & Deployment - Get started, deploy anywhere

• 🆕 Fresh Setup - First-time installation guide

• 🏗️ Architecture - System design and decisions

• 📚 All Docs - Topic index and source-code entry points

• 🗺️ Roadmap - Planned features

• Frontend Architecture - Angular app structure

• POS Guide - Point-of-sale workflow

• Feature Catalog - Customer-facing capabilities

Current Status

Version: 2.0 (Active Development)
Stack: Angular + Vendure + PostgreSQL
V1 Archive: See V1 Migration

Core Features

• 🎯 AI Product Recognition - Camera and barcode product lookup
• 💰 POS (Sell) - Checkout, payments, cashier flow
• 📦 Products & stock - Catalog, variants, stock adjustments
• 📊 Sales, orders, payments - Orders, payments, credit
• 👥 Customers & suppliers - Unified people, statements, purchases
• 📒 Accounting - Ledger, expenses, transfers, reconciliation
• ✅ Approvals - User and channel approval flows
• 🏪 Multi-location - Stock locations, channel-scoped data
• 📱 Mobile-first - Responsive dashboard
• 💬 WhatsApp alerts - Shift and balance notifications to admins and customers

Tech Stack

Component	Technology
Frontend	Angular 19 + daisyUI + Tailwind CSS
Backend	Vendure (NestJS) + TypeScript
Database	PostgreSQL 16
Cache	Redis 7
ML	On-device image embeddings
Deployment	Container images (platform-agnostic)

Project Structure

dukarun/
├── assets/           # Brand assets (logos in assets/logo/)
├── backend/          # Vendure server & worker
├── frontend/         # Angular SPA
├── configs/          # Shared configuration
└── docs/             # Documentation & assets

Getting Started

# Clone repository
git clone https://github.com/yourusername/dukarun.git
cd dukarun

Next: See INFRASTRUCTURE.md for complete setup instructions, including Docker Compose configuration, network architecture, and deployment guides.

Contributing

This is currently a private project. For questions or contributions, contact the maintainers.

License

Proprietary - All rights reserved

---

Built with ❤️ for African small businesses