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.
- 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.
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.
A dedicated, password-protected administration dashboard connected directly to MongoDB Atlas:
- Master Password Gate: Protected by credential verification (default:
etherea2026, configurable viaADMIN_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.
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.
- Framework: Next.js 15+ (App Router)
- Language: TypeScript
- Styling: Tailwind CSS
- Database: MongoDB Atlas with official Node.js driver and resilient fallback
- Icons: Lucide React
- Visual Effects: Canvas Confetti
- Typography: Cormorant Garamond (Editorial Serif) & Inter (Clean Sans-Serif) via
next/font/google
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
| 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 |
- Node.js 18+ installed
- MongoDB connection string (local or MongoDB Atlas)
-
Clone the repository:
git clone https://github.com/mirazahmeed/etherea.git cd etherea -
Install dependencies:
npm install
-
Configure Environment Variables: Create a
.env.localfile in the root directory:MONGODB_URI=your_mongodb_connection_string MONGODB_DB=etherea
-
Run the development server:
npm run dev
Open http://localhost:3000 in your browser.
-
Build for production:
npm run build npm run start
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
POSTrequest to/api/seed:curl -X POST http://localhost:3000/api/seed -H "Content-Type: application/json" -d '{"force": true}'
This project is licensed under the MIT License. Crafted with pure botanical care.