Skip to content

A modern web-based bookstore built with React, Firebase, and Tailwind CSS. Features user authentication, book browsing, shopping cart, wishlist, and review system.

Notifications You must be signed in to change notification settings

Rajawialqhtani/read-n-rave

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š Read'n'Rave

A Modern Web-Based Bookstore Experience

Live Demo React Firebase Tailwind CSS

🌟 Overview

Read'n'Rave is a modern web-based bookstore designed to enhance the online reading experience. Developed as part of an Agile Software Development course at Princess Nourah University, this application allows users to explore books, manage purchases, and engage with the reading community through reviews and ratings.

✨ Features

  • πŸ” User Authentication - Secure login and registration using Firebase
  • πŸ“– Book Discovery - Real-time search and advanced filtering options
  • πŸ›’ Shopping Cart - Add books to cart and manage purchases
  • ❀️ Wishlist Management - Save books for later
  • ⭐ Reviews & Ratings - Read and write book reviews with star ratings
  • πŸ“± Responsive Design - Optimized for all screen sizes and devices
  • 🎨 Modern UI - Clean, user-friendly interface with smooth interactions

πŸš€ Live Demo

Experience Read'n'Rave live: https://v0-readn-rave-website.vercel.app/

πŸ› οΈ Tech Stack

Technology Purpose
React.js Frontend framework for building interactive UI
Tailwind CSS Utility-first CSS framework for modern styling
Firebase Backend services (Authentication & Firestore Database)
Vercel Deployment and hosting platform

πŸ“‹ Prerequisites

Before running this project, make sure you have:

  • Node.js (v14 or higher)
  • npm or yarn package manager
  • Git

πŸƒβ€β™‚οΈ Getting Started

1. Clone the Repository

git clone https://github.com/Rajawialqhtani/read-n-rave.git
cd read-n-rave

2. Install Dependencies

npm install

3. Set Up Environment Variables

Create a .env.local file in the root directory and add your Firebase configuration:

REACT_APP_FIREBASE_API_KEY=your_api_key
REACT_APP_FIREBASE_AUTH_DOMAIN=your_auth_domain
REACT_APP_FIREBASE_PROJECT_ID=your_project_id
REACT_APP_FIREBASE_STORAGE_BUCKET=your_storage_bucket
REACT_APP_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id
REACT_APP_FIREBASE_APP_ID=your_app_id

4. Run the Development Server

npm run dev

Open http://localhost:3000 to view the application in your browser.

πŸ—οΈ Project Structure

read-n-rave/
β”œβ”€β”€ public/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ pages/
β”‚   β”œβ”€β”€ hooks/
β”‚   β”œβ”€β”€ services/
β”‚   β”œβ”€β”€ utils/
β”‚   └── App.js
β”œβ”€β”€ package.json
└── README.md

πŸ§ͺ Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run lint - Run ESLint

🎯 Agile Development Process

This project was developed using Agile methodologies, including:

  • βœ… Sprint Planning and Daily Standups
  • βœ… Product Backlog Creation and Management
  • βœ… Iterative Sprint Reviews and Retrospectives
  • βœ… Version Control using Git and GitHub
  • βœ… Continuous Integration and Deployment

πŸ‘₯ Team

This project was developed by students from Princess Nourah University as part of the CS 388 Agile Software Development course:

Name Role
Hala Alqhtani Product Owner
Ghaida Aldrees Scrum Master
Rajawi Alqhtani Developer
Khulud Alkenani Developer
Reem Awshan Developer

🀝 Contributing

We welcome contributions! 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.

πŸ™ Acknowledgments

  • Princess Nourah University CS Department
  • CS 388 Agile Software Development Course
  • Firebase for backend services
  • Vercel for hosting

πŸ“ž Contact

For questions or support, please reach out to the development team or create an issue in this repository.


Made with ❀️ by the Read'n'Rave Team at Princess Nourah University

About

A modern web-based bookstore built with React, Firebase, and Tailwind CSS. Features user authentication, book browsing, shopping cart, wishlist, and review system.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published