Overview
SwiftCart is a robust, full-stack e-commerce platform engineered utilizing the Next.js 15 App Router and React 19. It effortlessly bridges the gap between buyers and merchants by providing a high-conversion consumer storefront alongside a protected centralized Seller Dashboard.
The application is heavily optimized using advanced web paradigms, including natively integrated Stripe Checkout sessions, Cloudinary media management, and an event-driven architecture utilizing Inngest to dynamically decouple heavy synchronization tasks.
Event-Driven Architecture
Instead of blocking HTTP requests during lengthy operations like identity syncing or mass order creation, SwiftCart utilizes Inngest to queue and process background jobs asynchronously, absolutely guaranteeing a low-latency UI.
Core Features
Storefront & Shopping
- Product Discovery — Browse featured collections, latest arrivals, and utilize the full search/listing engine.
- Advanced Cart — Global cart management allowing instant item additions, quantity updates, and fluid removal.
- Multi-Address — Save and manage multiple secure shipping addresses directly within standard user profiles.
- Order Tracking — Dedicated history hub (
/my-orders) for viewing past purchases and live fulfillment checkpoints.
Merchant Operations
- Role-Guarded Access — Sellers are uniquely authorized via custom
publicMetadata.rolevariables nested securely inside Clerk. - Inventory Control — Add global listings utilizing robust multi-image uploads sent securely to Cloudinary storage.
- Order Insight — Review distinct client orders tied directly to the particular merchant's proprietary product listings.
Checkout Pipelines
- Stripe Hosted Sessions — Utilizing
@stripe/stripe-jsto strictly delegate card collections and webhook responses gracefully. - Cash on Delivery (COD) — Secondary offline checkout flow gracefully bypassing Stripe constraints.
- Automated Sync — Secure webhooks strictly dictate reality—destroying stale orders on failure or finalizing payments unconditionally upon success.
Technology Stack
Framework & UI
Next.js 15, Turbopack, React 19, Tailwind CSS 3, Lucide Icons, and React Hot Toast.
Database & Auth
MongoDB initialized gracefully via Mongoose ODM securely wrapped around strict Clerk identity variables.
Payment Processing
Level 1 PCI DSS compliant Checkout Sessions coupled with intelligent Webhook reconciliation logic.
Event Pipelines
Robust Inngest background environments driving natively decoupled synchronization mechanisms.
Application Flow
Identity & Background Sync
Clerk flawlessly handles authentication sessions alongside strict route middleware. Critical identity milestones (sign-up, updates, deletions) actively trigger isolated Inngest background events writing profile definitions seamlessly mapped onto MongoDB schemas.
Browse & Persist
A universal AppContext provider pulls core MongoDB hierarchies locally. When a consumer mutates their cart volume, context efficiently patches non-blocking mutations straight to /api/cart/update locking active cross-platform capacities accurately.
Secure Checkout
Customers securely maneuver between Stripe or COD endpoints. Stripe deploys a heavily encrypted URL boundary. Following transactions, Stripe blasts a webhook signature directly to /api/stripe intelligently adjusting arrays to payment: true and wiping frontend local carts cleanly.
Merchant Administration
Underlying Node modules accurately evaluate publicMetadata.role === "seller". Successful profiles can modify MongoDB structures definitively, publishing robust product photography bundles universally pushed straight off isolated Cloudinary clusters.
Project Ecosystem
Frequently Asked Questions
Embark on E-Commerce
Ready to explore the marketplace logic? Experience the tailored storefront algorithms and dynamic merchant infrastructure firsthand by visiting the Live Application.
