https://github.com/g4eva-dev/v-scent
https://github.com/g4eva-dev/v-scent
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/g4eva-dev/v-scent
- Owner: G4EVA-dev
- Created: 2025-06-10T04:22:53.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-10T04:43:28.000Z (about 1 year ago)
- Last Synced: 2025-06-10T05:27:09.398Z (about 1 year ago)
- Language: TypeScript
- Homepage: https://v-scent.vercel.app
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# V-Scent Aura
## Overview
V-Scent Aura is a luxury perfume brand website that showcases a collection of unique fragrances. The website is built using Next.js and features a modern, responsive design with interactive elements.
## Features
- **Homepage**: Features a dynamic image carousel that cycles through product images.
- **About Page**: Includes a brief history of the brand and a 3D text animation using Three.js.
- **Products Page**: Displays a collection of perfumes with detailed descriptions and images.
- **Contact Page**: Provides a form for users to get in touch with the brand.
- **Responsive Design**: The website is fully responsive, ensuring a seamless experience on both desktop and mobile devices.
- **Mobile Navigation**: A hamburger menu for easy navigation on mobile devices.
## Technologies Used
- **Next.js**: A React framework for building server-rendered applications.
- **React**: A JavaScript library for building user interfaces.
- **Three.js**: A JavaScript 3D library used for creating the 3D text animation.
- **GSAP**: A JavaScript animation library for creating smooth animations.
- **Tailwind CSS**: A utility-first CSS framework for styling the website.
## Getting Started
1. **Clone the Repository**:
```bash
git clone https://github.com/yourusername/v-scent-aura.git
cd v-scent-aura
```
2. **Install Dependencies**:
```bash
npm install
```
3. **Run the Development Server**:
```bash
npm run dev
```
4. **Open the Browser**: Navigate to `http://localhost:3000` to view the website.
## Project Structure
- `app/`: Contains the main application code, including pages and components.
- `components/`: Reusable components used across the application.
- `public/`: Static assets such as images and fonts.
- `types/`: TypeScript type definitions.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Acknowledgments
- Thanks to all contributors who have helped in the development of this project.
- Special thanks to the open-source community for the tools and libraries used in this project.