Quark Commerce — Installation Guide
Quark Commerce is a headless e-commerce platform built with ASP.NET 10 and PostgreSQL. It provides a full-featured REST API consumed by two separate frontend applications:
- Storefront — customer-built frontend application (any tech stack: React, Vue, Angular, Next.js, mobile, etc.)
- Backoffice — admin panel built with Angular + PrimeNG (included)
Architecture Overview
API Structure
The API exposes two route families:
| Prefix | Audience | Auth |
|---|---|---|
api/storefront/* | Customer-facing storefronts | JWT (some endpoints public) |
api/admin/* | Backoffice admin panel | JWT + Admin role + ABAC |
Key Features
- Multi-store — multiple stores with independent settings from a single deployment
- Multi-language — localized content for all entities (products, categories, attributes, etc.)
- Multi-currency — per-store currency with automatic price resolution
- Product variants — configurable attributes (color, size) with SKU-level management
- Dual category system — Master categories (internal) + Sales categories (storefront-facing)
- Promotions — automatic rule-based promotions (8 types) + code-based discounts
- Inventory — multi-warehouse stock management with fulfillment workflow
- Supply chain — purchase orders, goods receipts, demand planning with AI suggestions
- CMS — page builder with content blocks, navigation menus
- SEO — multi-language slug system for products, variants, and categories
- Event system — transactional outbox + RabbitMQ for async event publishing
- Licensing — RSA-4096 signed license validation
- AI assistant — multi-provider chat (Ollama, OpenAI, Claude, Azure OpenAI)
- GDPR — data export, deletion, consent tracking
- Notifications — email/SMS via configurable providers (SMTP, Twilio, etc.)