Skip to main content
Navigation
HomeTechnical ReferenceJournalGitHubGitHub
Sidebar — toggle document categories via the logo
The Craft Safari — E-Commerce Storefront

The Craft Safari — E-Commerce Storefront

October 14, 2025

Overview​

The Craft Safari is a full-featured e-commerce storefront selling Indian handcrafted goods and artisan products — from home decor and textiles to craft tours and art atelier experiences. The store operates in the UAE market with AED pricing and Geidea payment processing.

The architecture is headless WooCommerce — WordPress handles the product catalog, orders, and blog content through its REST API, while Next.js 15 owns all rendering, caching, and the customer experience. A secure proxy layer keeps WooCommerce API credentials on the server, never exposing them to the browser. This project was designed and delivered by Codativity, a leading software agency.


Key Features​

  • Headless WooCommerce with secure proxy: WC credentials are server-side only — all API calls funnel through an allowlisted proxy route
  • Three-layer caching: ISR (10min), server memory (5min), TanStack Query (5s) — tiered for performance and freshness
  • Custom post types: Beyond standard WooCommerce — home-banner, home-promotion, craft-tour, event, workshops for rich content experiences
  • Bunny CDN media offloading: Custom WordPress plugin rewrites attachment URLs to CDN
  • Geidea payment integration: UAE-specific gateway supporting card payments and digital wallets in AED
  • 3D model viewer: @google/model-viewer for interactive product visualization
  • Bootstrap 5 + SCSS: Extensive custom styling framework — not Tailwind — with page-level SCSS modules
  • Yoast SEO integration: WordPress SEO metadata consumed via yoast_head_json for Next.js generateMetadata()
  • Dynamic sitemap: Fetches all products, categories, and blogs from WooCommerce at build time
  • Cookie consent + analytics: GDPR-compliant cookie banner with Google Analytics and Meta Pixel integration