We engineered this platform out of a simple frustration with modern e-commerce software: it has become overly complicated, vendor-locked, and filled with hidden costs. We built this codebase the way we believe production software should be built — isolated, transparent, and entirely under your control.
The Technical Stack
The core is built on a clean, modern foundation: Next.js, TypeScript (Strict Mode), and a lightweight database abstraction layer. We don't overengineer the stack with trendy, short-lived tools. Every dependency is actively maintained, stable, and chosen to ensure your project doesn't quietly rot over the next few years.
Architectural Integrity
This isn't a collection of third-party plugins bolted together after the fact. Every system — from catalog filtering to the checkout state machine — was designed from day one to operate as a cohesive unit.
Because we deploy regular improvements to the core architecture, minor edge cases can occasionally appear when combined with complex custom setups. If you spot an anomaly or a bottleneck before we do, tell us directly. We value raw engineering feedback and fix bugs immediately rather than letting them sit in a backlog.
Clean Business Model: Predictable Hosting
We don't charge transaction fees, we don't take a cut of your revenue, and we don't lock advanced features behind expensive enterprise tiers. You pay a flat subscription for the software and support — that is it. When your business scales, your costs remain predictable because we believe software providers shouldn't tax your growth.
You retain 100% ownership of your data, infrastructure, and custom code modifications. Administrative tasks like localization, layout tweaks, and shipping rule variations are fully decoupled from the codebase, meaning your non-technical team can manage daily operations without opening a pull request.
Infrastructure: What Belongs to You
Because this is a sovereign, self-hosted system rather than a shared multi-tenant sandbox, you connect your own infrastructure providers. This keeps your operating costs minimal and prevents vendor lock-in.
| Infrastructure Component | What You Provision | Estimated Operating Cost |
|---|---|---|
| Payment Gateway | Stripe or local processor account | Standard per-transaction fee |
| Auth Provider | Google Cloud Console credentials | Free |
| Bot Mitigation | CAPTCHA / Turnstile keys | Free |
| Tag Management | Google Tag Manager container | Free |
| Data Storage | PostgreSQL / MySQL database instance | Free tier available (Supabase/Neon) |
| Transactional Email | SMTP / Mailgun / AWS SES credentials | Free or minimal usage-based cost |
| Microservices (Optional) | Lightweight Node.js instance for courier APIs | Minimal ($5–$10/mo) |
| Domain Name | Custom DNS routing | Standard annual registration |
We provide step-by-step documentation for configuring each environment variable. Setup takes less than 30 minutes.
Core Capabilities
- High-Performance Storefront: SSR-optimized product listing, instant client-side search routing, and custom attribute filters managed directly via the admin panel. Product cards handle variants, real-time inventory checks, and micro-interactions (Quick Buy / Add to Cart) without forcing unnecessary page reloads.
- Deep Product Schemas: Structured product views with isolated blocks for technical specifications, usage documentation, and dynamic related-product recommendation matrices.
- Stock-Aware Checkout: State-synchronized shopping cart that prevents overselling by mapping directly to actual database stock. Features an optimized single-item checkout path alongside standard cart flows, multi-country shipping logic, and automatic guest/authenticated session merging.
- Native Localization: Built-in multi-language translation layer for all public-facing content, categories, and SEO metadata. (Note: The admin interface is currently English-only).
- Performance-First Design: Zero heavy UI frameworks or rendering bloat. The layout is intentionally clean and fast, prioritizing conversion rates and Core Web Vitals over visual noise.
- Developer-Independent Admin: Built-in JSON/Excel bulk data pipelines, dynamic layout configurator, localization manager, and a sandboxed shipping cost simulator based on weight and order thresholds.
- Native SEO Engine: Automated JSON-LD structured data generation for products, dynamic
sitemap.xmlandrobots.txtgeneration, automated Google Merchant XML feeds, and a server-side 301 redirect engine to protect your search index integrity during catalog refactoring. - Built-in Affiliate System: A self-contained referral module. Agents apply through a dedicated portal, and admins approve them manually to issue unique tracking promo codes. The system handles discount validation and maps successful acquisitions directly to the referring agent's ledger.
Production Environment Demo
The most transparent way to evaluate the architecture is to audit a live system in production: neosolvion.cz.
You can also watch a raw, unedited technical walkthrough of the codebase and administrative backend here: Watch the Walkthrough Video.
Ship Specifications
Upon deployment, you receive access to the complete source repository, a comprehensive 22-section deployment manual (covering both daily administration and DevOps setup), and a pre-configured seed database (including a production-ready theme boilerplate, example pages, and sample catalogs) to get your local environment running instantly.
