📚 Book Review Hub - Frontend

This is the frontend for Book Review Hub, a modern and responsive web application where users can review, rate, and explore books.

It is built with scalability and maintainability in mind using React + TypeScript + Vite + TailwindCSS.

---

🗂️ Table of Contents

• 📚 Book Review Hub - Frontend
  • 🗂️ Table of Contents
  • 🚀 Features
  • 🧱 Tech Stack
  • 📂 Project Structure
  • ⚙️ Setup & Installation
    • 1. Clone the repository
    • 2. Install dependencies
  • ▶️ Run the Application
  • 📋 Planned Features (under evaluation)
  • 🧩 Features Implemented at MVP Stage
  • 📄 License

---

🚀 Features

• ✅ Authentication (login, register)
• ✅ Browse and search books
• ✅ Submit and view reviews
• ✅ Responsive and mobile-friendly layout
• ✅ API integration with secure token handling

---

🧱 Tech Stack

Purpose	Technology
UI Framework	React 19.0.0
Language	TypeScript 5.7.2
Bundler/Tooling	Vite 6.3.1
Styling	Tailwind CSS 4.1.5
State Management	React Context (MVP stage)
Routing	React Router DOM
API Handling	Axios
Linting	ESLint, Prettier
Deployment	(Coming soon)

---

📂 Project Structure

bookreviewhub-frontend/
├── public/                   # Static assets
├── src/
│   ├── assets/               # Static files (images, icons, etc.)
│   ├── components/           # Reusable components
│   ├── features/             # Feature-based folders (auth, books, etc.)
│   ├── hooks/                # Custom React hooks
│   ├── layouts/              # Layout components
│   ├── pages/                # Top-level route components
│   ├── routes/               # Routing configuration
│   ├── services/             # API clients
│   ├── types/                # TypeScript type definitions
│   ├── utils/                # Utility functions
│   ├── App.tsx
│   ├── main.tsx
│   └── index.css
├── .eslintrc.cjs             # ESLint config
├── tailwind.config.ts        # Tailwind config
├── tsconfig.json             # TypeScript config
└── vite.config.ts            # Vite config

---

⚙️ Setup & Installation

1. Clone the repository

git clone https://github.com/tlavu2004/bookreviewhub-frontend.git
cd bookreviewhub-frontend

2. Install dependencies

npm install
# or
yarn install

---

▶️ Run the Application

npm run dev
# or
yarn dev

The application will be available at: http://localhost:5173

---

📋 Planned Features (under evaluation)

No.	Feature Description	Priority	Complexity
1	Auth token handling (JWT)	High	Medium
2	Protected routes (auth guard)	High	Medium
3	Review voting	Medium	Medium
4	Book filters (genre, etc.)	Medium	Medium
5	Pagination	Medium	Easy
6	Admin/moderator UI	Low	Hard

---

🧩 Features Implemented at MVP Stage

• Login / Register flow
• JWT token persistence
• Home, login, register, and dashboard pages
• Book browsing (static for now)
• Review submission (initial version)

---

📄 License

This project is licensed under the MIT License.