8000 GitHub - mirazahmeed/etherea · GitHub
[go: up one dir, main page]

Skip to content
mirazahmeedPublic

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

✦ ETHEREA — Luxury Botanical Skincare

Embrace Your Natural Radiance — Pure, artisanal botanical formulations crafted with high-performance botanical actives, sustainably sourced and housed in recyclable luxury packaging.

An editorial, high-end botanical skincare e-commerce platform built with Next.js 15+ App Router, TypeScript, Tailwind CSS, and MongoDB Atlas. Designed with a luxurious, serene editorial aesthetic featuring subtle blush (#F6DDE1) and mint (#CFEFE7) palettes, serif typography (Cormorant Garamond), organic shapes, and a complete separation between customer and administrative workflows.


✨ Key Features

🌿 Luxury Editorial Storefront

  • Visual Design: Centered editorial canvas with rounded corners (rounded-[36px]), ambient shadows, organic floati B6EA ng jars with radial blending masks, and clean typography.
  • Hero & S-Wave Banner: Hero presentation with floating botanical jar, stats counter (98% natural origin, 100% vegan), and an organic S-wave ribbon banner celebrating natural radiance.
  • Dynamic Collections Filter: Real-time filtering by category (All Formulations, Best Sellers, Facial Radiance, Lip Care Rituals, Body & Bath, Overnight Renewal) with live product count badges.
  • Interactive Product Highlights: Custom SVG curved connector diagram highlighting active ingredients (Marine Collagen, Cold-Pressed Rosehip, Botanical Hyaluronic Acid, Organic Jojoba Oil).
  • Global Glow Routine: Step-by-step skincare ritual with editorial photography, swatch details, and application instructions.
  • Quick-View & Search: Modal with full ingredient transparency, size selection, and instant debounced search filtering.
  • Botanical Bag (Cart Drawer): Slide-out drawer with complimentary carbon-neutral shipping threshold progress stepper, item quantity controls, and celebratory confetti upon checkout.

👤 Customer Profile Section (/profile)

A dedicated, serene portal for customers and VIP members:

  • Member Overview: High-resolution avatar, customer identity (Elena Vance), VIP Member badge, email, and contact details.
  • Radiance Rewards: Live loyalty points balance (1,250 Points / $25.00 voucher value) and member tier perks (✦ Botanical Sanctuary VIP Member).
  • Editable Shipping Coordinates: Address management with instant persistence to MongoDB via PUT /api/customer.
  • Order History & Tracking: Filter orders by status (All, In Transit, Delivered, Processing), view delivery carriers, and copy live tracking numbers.
  • Botanical Ritual Receipt Modal: Itemized receipts displaying purchased items, quantities, subtotals, complimentary shipping calculations, and delivery addresses.

🛡️ Secure Store Admin Portal (/admin)

A dedicated, password-protected administration dashboard connected directly to MongoDB Atlas:

  • Master Password Gate: Protected by credential verification (default: etherea2026, configurable via ADMIN_PASSWORD).
  • Customer Orders Management: Real-time order fulfillment tracker with status dropdown updates (Handcrafted in Lab → In Transit → Delivered) synchronizing instantly with MongoDB.
  • Products Catalogue Management: Live inventory controls, instant in-stock / sold-out toggles, live price modifications, and an "Add Botanical Product" modal.
  • Collections Management: Overview and creation of curated botanical collections.
  • MongoDB Health & Seeder: Live connection indicator (MongoDB Live • etherea), real-time collection document counts, one-click database seeder, and master session locking.

🧪 Buyer & Client Testing Sandbox (/testing-admin)

A dedicated testing environment built specifically for project buyers, client reviews, and UI testers:

  • Zero Production Risk: Runs entirely on client-side browser localStorage — completely isolated so experiments will never alter the live MongoDB database or public storefront.
  • Full Catalogue Simulation: Testers can add new products, edit pricing, toggle stock, and delete items.
  • Simulated Orders & Fulfillment: Test status changes and tracking updates.
  • One-Click Reset: "Reset Sandbox to Default Catalogue" button instantly clears local experiments and restores pristine demo data.

🛠️ Technology Stack


📁 Architecture & File Structure

cosmetics-store/
├── public/
│   └── images/
│       ├── editorial/       # High-res textures, swatches, and radiant portrait photography
│       └── products/        # Botanical creams, serums, lip balms, and jars
├── src/
│   ├── app/
│   │   ├── admin/           # Secured Store Admin Portal (/admin)
│   │   ├── testing-admin/   # Buyer Testing Sandbox (/testing-admin)
│   │   ├── profile/         # Dedicated Customer Profile & Orders (/profile)
│   │   ├── management/      # Legacy redirect to /admin
│   │   ├── api/             # App Router REST Endpoints
│   │   │   ├── admin/       # Master session auth verification
│   │   │   ├── cart/        # Session-based cart persistence
│   │   │   ├── collections/ # Collections catalogue & counts
│   │   │   ├── customer/    # Customer profile & shipping coordinates
│   │   │   ├── db-status/   # MongoDB health check & counts
│   │   │   ├── orders/      # Order creation & retrieval
│   │   │   │   └── [id]/    # Order status update & receipt details
│   │   │   ├── products/    # Product catalogue CRUD & stock toggles
│   │   │   │   └── [id]/    # Single product update & delete
│   │   │   ├── seed/        # Database seeder
│   │   │   └── wishlist/    # Session-based wishlist persistence
│   │   ├── layout.tsx       # Root layout with Cormorant & Inter fonts
│   │   └── page.tsx         # Complete editorial landing page
│   ├── components/
│   │   ├── ecommerce/       # CartDrawer, ProductCard, QuickViewModal, SearchModal
│   │   ├── layout/          # Header (with profile/admin navigation), Footer
│   │   ├── sections/        # Hero, CurvedWaveBanner, BestSellers, ProductHighlights, etc.
│   │   └── ui/              # Toast notifications
│   ├── context/
│   │   └── CartContext.tsx  # Global state synchronizing with MongoDB
│   ├── data/
│   │   ├── products.ts      # Botanical products fallback catalogue
│   │   └── faq.ts           # Botanical FAQ data
│   └── lib/
│       └── db/
│           ├── models.ts    # TypeScript MongoDB document interfaces
│           ├── mongodb.ts   # MongoDB Atlas client with resilient in-memory fallback
│           └── seed.ts      # Seeding logic for catalogue and orders
└── README.md

🔌 REST API Reference

Endpoint Methods Description
/api/db-status GET Reports live MongoDB connection status and document counts
/api/seed POST Seeds or resets the botanical catalogue and initial orders
/api/products GET, POST Lists all products with search/collection filters; creates new products
/api/products/[id] GET, PUT, DELETE Single product operations (live in-stock toggle, price update, deletion)
/api/collections GET, POST Lists collections with live product counts; creates new collections
/api/cart GET, POST, DELETE Retrieves, adds/updates, and clears persistent cart items for sessions
/api/wishlist GET, POST Retrieves and toggles wishlist favorites per session
/api/customer GET, PUT Retrieves and updates customer coordinates and profile information
/api/orders GET, POST Retrieves customer/store orders and persists new checkouts
/api/orders/[id] GET, PUT Retrieves order receipt and updates fulfillment status

🚀 Getting Started

Prerequisites

  • Node.js 18+ installed
  • MongoDB connection string (local or MongoDB Atlas)

Installation

  1. Clone the repository:

    git clone https://github.com/mirazahmeed/etherea.git
    cd etherea
  2. Install dependencies:

    npm install
  3. Configure Environment Variables: Create a .env.local file in the root directory:

    MONGODB_URI=your_mongodb_connection_string
    MONGODB_DB=etherea
  4. Run the development server:

    npm run dev

    Open http://localhost:3000 in your browser.

  5. Build for production:

    npm run build
    npm run start

🌿 Seeding the Database

To seed initial botanical formulations and sample orders:

  • Navigate to http://localhost:3000/admin and click the MongoDB Health & Seed tab.
  • Click "Seed Botanical Catalogue" to automatically insert products, collections, customer records, and initial orders.
  • Or make a POST request to /api/seed:
    curl -X POST http://localhost:3000/api/seed -H "Content-Type: application/json" -d '{"force": true}'

📄 License

This project is licensed under the MIT License. Crafted with pure botanical care.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0