Skip to content

Repository files navigation

🌿 Vapora

A modern, responsive e-commerce platform for tobacco products built with Next.js App Router.

Next.js TypeScript Tailwind CSS shadcn/ui License: MIT

🔗 Live Demo: vapora.pepedemo.ir


✨ Features

  • 🛒 Product Catalog – Browse tobacco products with detailed listings and filtering
  • Customer Reviews – Integrated review system for product feedback
  • 🎨 Theme Switching – Light/Dark mode support with persistent preference
  • 📱 Fully Responsive – Mobile-first design optimized for all screen sizes
  • 🎭 Animated Sections – Smooth transitions and micro-interactions for enhanced UX
  • 📞 Contact Capabilities – Built-in contact form and inquiry system
  • 🧩 Component Library – Comprehensive shadcn/ui-based component architecture
  • Performance Optimized – Server Components, image optimization, and code splitting

🛠️ Tech Stack

Category Technology
Framework Next.js (App Router)
Language TypeScript
Styling Tailwind CSS + shadcn/ui
UI Components shadcn/ui + Radix Primitives
Deployment Custom Domain
License MIT

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm / yarn / pnpm / bun

Installation

# Clone the repository
git clone https://github.com/foadEbrahimi/Vapora.git
cd Vapora

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:3000 to view the application.

Available Scripts

Command Description
npm run dev Start development server with hot reload
npm run build Create optimized production build
npm run start Start production server
npm run lint Run ESLint checks

📁 Project Structure

Vapora/
├── public/          # Static assets & images
├── src/
│   ├── app/         # Next.js App Router pages & layouts
│   ├── components/  # Reusable UI components (shadcn/ui)
│   ├── lib/         # Utility functions & helpers
│   └── styles/      # Global styles & Tailwind config
├── components.json  # shadcn/ui configuration
├── next.config.mjs  # Next.js configuration
└── package.json     # Dependencies & scripts

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

Copyright © 2026

👨‍💻 Author

Foad Ebrahimi
Frontend Developer | React & Next.js Ecosystem

LinkedIn Telegram Email


Built with ❤️ by Foad Ebrahimi & Nyx-Studio

About

A Next.js e-commerce web application for tobacco product sales. Built with TypeScript and Tailwind CSS, featuring a modern, responsive UI with product listings, customer reviews, and contact capabilities. Includes animated sections, theme switching support, and a comprehensive component library for seamless user experience.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages