🚀 HoloStore - Modern E-commerce with Astro

HoloStore is a high-performance, full-stack e-commerce platform built with Astro 6, React 19, and Tailwind CSS 4. It leverages Drizzle ORM and PostgreSQL for robust data management, providing a seamless shopping experience with server-side rendering and dynamic interactivity.

---

🛠️ Tech Stack

• Framework: Astro 6.x (SSR mode)
• Frontend Library: React 19.x
• Styling: Tailwind CSS 4.x
• ORM: Drizzle ORM
• Database: PostgreSQL (via postgres driver)
• State Management: Nanostores (Persistent state)
• Animations: Framer Motion
• Authentication: JWT-based via jose
• Validation: Zod

---

✨ Key Features

• 🛒 Dynamic Product Catalog: Fast, SEO-friendly product listings.
• 📂 Categorized Browsing: Filter products by Men's, Women's, and Accessories.
• 🔐 Authentication System: Secure user login and profile management.
• 🛡️ Admin Dashboard: Manage products and view store analytics.
• 🏃 Blazing Fast Performance: Zero-JS by default, hydrated only where needed.
• 📱 Responsive Design: Fully optimized for mobile and desktop using Tailwind CSS.
• ✨ Smooth Interactions: Micro-animations powered by Framer Motion.

---

🚀 Getting Started

Prerequisites

• Node.js: v22.12.0 or higher
• PostgreSQL: A running database instance

Installation

1. Clone the repository:

   git clone <repository-url>
   cd holostore-astrobuild
   

2. Install dependencies:

   npm install
   

3. Environment Setup: Create a .env file in the root directory and add your connection string:

   DATABASE_URL=postgres://user:password@localhost:5432/holostore
   

4. Initialize Database:

   # Generate Drizzle migrations
   npm run db:generate
   
   # Push the schema to your database
   npm run db:push
   
   # Seed the database with initial products and an admin user
   npm run db:seed
   

---

📖 Available Scripts

Command	Action
npm run dev	Starts the development server at localhost:4321.
npm run build	Builds the project for production.
npm run preview	Previews the production build locally.
npm run db:generate	Generates SQL migrations from the Drizzle schema.
npm run db:push	Synchronizes the database schema with the Drizzle schema.
npm run db:seed	Populates the database with sample products and users.

---

📂 Project Structure

/
├── drizzle/            # Database migrations and logs
├── public/             # Static assets (images, fonts, etc.)
├── src/
│   ├── components/     # React & Astro components
│   ├── db/             # Drizzle schema and queries
│   ├── layouts/        # Page layouts
│   ├── lib/            # Utility functions and shared logic
│   ├── pages/          # File-based routing (Index, Login, Admin, etc.)
│   ├── store/          # Nanostores for state management
│   └── styles/         # Global styles and Tailwind config
├── astro.config.mjs    # Astro configuration
└── drizzle.config.ts   # Drizzle configuration

---

🛡️ License

Built with ❤️ by the Paras Sharma [prs4902].