Aura & Oak Website

#Overview

Aura & Oak is an artisanal, slow-fashion e-commerce platform and back-office management system engineered for quiet luxury. Built on the modern Laravel 13 + Inertia.js v3 + Vue 3 stack, it combines an aspirational editorial storefront with an operational, high-density atelier management suite.

#Core Foundations

• Atelier Storefront: Editorial layout, sweeping typography (Playfair Display & Inter), fluid category and testimonial carousels, responsive mobile navigation, and seamless single-page application checkout.
• Admin Management Suite: Dense operational dashboard with live KPI tracking, order fulfillment queues, inventory threshold alerts, interactive revenue charts, staff access controls, and direct drag-and-drop media uploads.
• Integrated Payments: Frictionless multi-provider checkout featuring Paysasa gateway workflows, webhook signatures, and transactional notifications.
• Type-Safe Routing: Full integration with Laravel Wayfinder, generating typed TypeScript functions for backend routes and controller endpoints.

#Key Features

#Client Storefront

• Editorial Hero Section: High-fashion capsule presentation featuring sustainability hallmarks, live season badges, and conversion-optimized actions.
• Shop & Faceted Filtering: Filter apparel by categories, size, materials, color palettes, and stock availability.
• Interactive Reviews Carousel: Viewport-aware review carousel with smooth horizontal snapping, auto-play with pause-on-hover, and client initial badges.
• Persistent Cart & Mini-Drawer: Real-time optimistic cart operations with stock validation.
• Complete Checkout Flow: Multi-step checkout with address validation, coupon code verification, and guest or account checkout.
• Editorial Journal CMS: Evocative storytelling engine covering textile origins, flax craftsmanship, and slow fashion rituals.

#Atelier Operations Panel

• Operational KPI Dashboard: Real-time metrics for today's orders, revenue, pending fulfillment, low-stock warnings, and revenue timeline charts.
• Direct Image Upload System: Reusable drag-and-drop uploader storing assets to public disk with instant validation (JPEG, PNG, WebP, AVIF up to 10MB) — replacing external image URLs with local storage assets.
• Product & Variant Catalog: Rich variant management (sizes, materials, SKUs, inventory counts, primary covers, and photo galleries).
• Inventory & Reorder Alerts: Stock adjustments, quantity tracking, and low-inventory restock triggers.
• Seasonal Capsules & Collections: Manage curated seasonal lookbooks and storefront showcases.
• Discount & Promotions Engine: Create percentage or fixed-amount discount codes with expiration dates, minimum spend requirements, and usage caps.
• Order Processing & Fulfillment: Track order statuses (Pending, Confirmed, Processing, Delivered, Cancelled) with automated queued order confirmation notifications.
• Staff Roles & Permissions: Role-based access control supporting Admin, Manager, and Fulfillment staff members.

#Technology Stack

#Design System Tokens

The application follows the Atelier Quiet Luxury aesthetic system:

#Installation & Setup

#Prerequisites

• PHP >= 8.2 (tested on PHP 8.5)
• Composer
• Node.js >= 18 & npm
• SQLite or MySQL