The project focuses on building a solid backend foundation for products with multiple options and variants, ensuring accurate stock handling and reliable frontend behavior. Cilea prioritizes data correctness, scalability, and clean architecture to support long-term growth.
Many ecommerce systems struggle when products introduce multiple options such as size, color, or material. Stock is often tracked at the wrong level, option availability becomes misleading, and frontend interfaces fail to accurately reflect real inventory states. This leads to poor user experience, overselling issues, and complex maintenance as catalogs grow.
I am responsible for the complete design and development of Cilea. This includes product modeling, inventory logic, backend architecture, and frontend interaction design. I defined the data schemas, implemented variant-driven inventory handling, and designed the option-to-variant resolution logic that ensures frontend behavior always reflects real stock conditions. I also oversee UI/UX decisions to ensure the platform remains intuitive for both administrators and customers.
Cilea is built with a variant-first architecture. Product options define possible selections, while variants represent the actual sellable units. Stock, pricing, and availability are stored exclusively at the variant level. Product-level availability and option states are derived automatically from variants using schema logic and middleware. This approach avoids duplicated data, reduces inconsistencies, and mirrors how large-scale ecommerce platforms handle complex catalogs.
js libraries for interacting with EVMs and Web3 wallets, contracts, and networks.
Solana’s JavaScript SDK for building high-speed dApps and handling transactions on the Solana blockchain.
Standards for hierarchical wallet derivation using mnemonics, enabling secure multi-account HD wallets.
Utility-first CSS framework for rapidly building modern, responsive UIs with custom styling.
React-based framework with built-in SSR, API routes, and full-stack capabilities for scalable apps.
NoSQL document database with Mongoose ORM for easy schema design, queries, and validations.
Core technologies for building the structure, styling, and interactivity of modern web applications.
Auth solution for Next.js applications, supporting credentials, OAuth, social logins, JWT, and session management.
Automated workflows for testing, building, and deploying applications directly from your GitHub repositories.
js libraries for interacting with EVMs and Web3 wallets, contracts, and networks.
Solana’s JavaScript SDK for building high-speed dApps and handling transactions on the Solana blockchain.
Standards for hierarchical wallet derivation using mnemonics, enabling secure multi-account HD wallets.
Utility-first CSS framework for rapidly building modern, responsive UIs with custom styling.
React-based framework with built-in SSR, API routes, and full-stack capabilities for scalable apps.
NoSQL document database with Mongoose ORM for easy schema design, queries, and validations.
Inventory is managed at the variant level, where each variant maintains its own stock, pricing, SKU, and images. Available stock is calculated automatically by subtracting reserved quantities. Product-level stock and option availability are derived dynamically. An option value such as “Size L” is considered out of stock if all variants containing that value have zero available inventory.
The admin workflow begins with creating the core product and defining its options. Variants are then generated automatically from option combinations. Each variant can be individually edited to set stock levels, pricing, SKU, and images. This mirrors proven workflows used by mature ecommerce platforms while maintaining full flexibility for future extensions.
On the frontend, option selection is driven entirely by variant data. When a user selects an option, the interface dynamically enables or disables remaining options based on valid variant combinations. Variant images update automatically based on the selected combination, and purchasing is prevented when stock is unavailable. This ensures the UI always reflects real inventory conditions.
Cilea is currently in active development. Core product schemas, variant logic, inventory calculations, and indexing strategies are implemented. Admin interfaces for managing variants and frontend option-resolution logic are in progress. Future work includes performance optimization, bulk variant editing, and advanced inventory features such as multi-location stock management.
Cilea is being developed as a long-term ecommerce foundation rather than a short-lived MVP. The project focuses on correctness, scalability, and developer control, ensuring that as product complexity increases, the system remains predictable and maintainable. It represents a practical exploration of how modern ecommerce platforms should be structured when data integrity and user experience are treated as first-class concerns.