Skip to content

k3lly003/Construct-KVV

 
 

Repository files navigation

text

🚧 Construction E-commerce Platform 🏗️

build dependencies license version last commit

A professional platform for procurement of construction materials, tools, and services.


✨ Key Features

  • Extensive Product Catalog: Browse a comprehensive range of construction materials, tools, and equipment.
  • Detailed Product Information: View product specifications, supplier details, and high-quality images.
  • Role-based Dashboard: Tailored interfaces for sellers, constructors, technicians, and architects.
  • Intuitive User Interface: Built with modern UI libraries for smooth and efficient navigation.
  • Shopping Cart: Add, review, and update items before securing your order.
  • Secure Checkout: Integrated with Stripe for reliable and safe payments.
  • Optimized Performance: Powered by Next.js and React Query for fast, dynamic experiences.
  • Smooth Interactions: Enhanced transitions and feedback using Framer Motion.

Visual Suggestion: Include a platform logo and GIF/video showcasing a user adding products to the cart or browsing the catalog.


🚀 Technologies Used

  • Framework: Next.js (React)
  • State Management: Zustand
  • UI Components: shadcn/ui (Tailwind CSS based)
  • Styling: Tailwind CSS & Styled Components
  • Animations: Framer Motion
  • Data Fetching: React Query
  • Payment Integration: Stripe

Visual Suggestion: Add technology logos as a banner or grid.


⚙️ Getting Started

Prerequisites

  • Node.js (version ≥ 16)
  • npm or yarn

Installation

  1. Clone the repository: git clone https://github.com/k3lly003/Construct-KVV

  2. Navigate to the project directory: cd YOUR_REPOSITORY_NAME

  3. Install dependencies: npm install or yarn install

  4. Configure environment:

  • Create a .env.local file and add your Stripe publishable key:
    NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_public_key
    
  1. Run the development server: npm run dev or yarn dev

text 6. Open http://localhost:3001 to view the app.

Visual Suggestion: Screenshot of the app running in the browser or the initial project dashboard.


🖼️ Visual Showcase

  • Homepage:
    alt text

  • Product Listing:
    alt text

  • Register as a pro Page:
    alt text

  • Shopping Cart:
    Checkout experience, Stripe payment visual, and total calculation.


🤝 Contributing

Contributions are welcome! Please read the CONTRIBUTING.md for guidelines and best practices.


📄 License

This project is licensed under the MIT License.


About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.7%
  • Other 0.3%