ShopMore is a neutral, high-performance, and deeply customizable e-commerce engine designed for merchants who prioritize data ownership and operational sovereignty. Built on a hardened TypeScript substrate, ShopMore provides an industry-leading alternative to SaaS platforms, offering absolute control over the entire commerce lifecycle.
ShopMore adheres to a strict layered architecture (Clean Architecture / DDD) to ensure business logic remains pure, testable, and decoupled from infrastructure.
| Layer | Path | Responsibility |
|---|---|---|
| Domain | src/domain/ |
Pure business logic: models, rules, and repository contracts. Zero dependencies. |
| Core | src/core/ |
Application orchestration: services coordinate domain logic and infrastructure adapters. |
| Infrastructure | src/infrastructure/ |
Adapters for SQLite, API-backed services, and payment processors. |
| UI | src/ui/ |
React 19 components, Next.js pages, and high-fidelity layouts. |
| Plumbing | src/utils/ |
Stateless helpers, formatters, and global constants. |
- Handle-Based Routing: Canonical, SEO-optimized URLs for products and collections.
- Digital Locker: Secure, authenticated access to purchased digital assets via ephemeral signed URLs.
- Support Center: Integrated ticketing and knowledgebase for frictionless customer lifecycle management.
- Trusted Checkout: Hardened payment orchestration with real Stripe integration and idempotency guards.
- Support CRM: Full-stack interaction management with agent collision detection and "Quick Reply" macros.
- Digital Vault: Memory-efficient, streaming-first ingestion for massive digital asset management.
- Inventory Intelligence: Automated stock health tracking, restock recommendations, and supplier management.
- Bulk Operations: High-speed spreadsheet-style editor for mass inventory, price, and metadata updates.
- Sovereign Analytics: Real-time sales, conversion, AOV, and customer LTV insights.
Follow these steps to initialize your sovereign commerce workspace.
- Node.js: 20.x or higher
- npm: 10.x or higher
# Install dependencies, initialize .env, and seed the database
npm run setupTip
The setup script automatically copies .env.example to .env and generates a fresh SESSION_SECRET for you.
# Start development server
npm run dev- Framework: Next.js 15 (App Router) + React 19
- Logic: TypeScript 5+ (Strict Mode)
- Persistence: SQLite via Kysely & better-sqlite3
- Styling: Tailwind CSS 4
- Security: Signed HTTP-only session cookies & Rate-limiting guards
- Monitoring: PRODUCTION_READY_METRICS.md
For deep technical dives and operational guides, refer to the internal Knowledge Ledger:
Tip
Use the Architecture Overview to understand the request lifecycle and Day 2 Operations for a guide on extending the engine.
Note
Industrial Neutrality: ShopMore is designed to be industry-agnostic. While the current workspace includes TCG-focused mock data, the underlying models and services are ready for any vertical (Apparel, Digital Goods, etc.).
MIT © ShopMore Contributors