Books Store 📚

A FastAPI CRUD app where users can create an account and manage their favorite books.

📌 GitHub Repository

https://github.com/Prakashsaw/FastAPI-CRUD-App

🌍 Live Demo

https://fastapi-crud-app.netlify.app

---

📚 Description

Books Store is a full-stack CRUD application built with FastAPI, React.js, and MongoDB. Users can register, log in, and manage their favorite books securely. The app features JWT-based authentication, email verification, session management, and password recovery.

---

🛠 Tech Stack

Frontend

• JavaScript, React.js, Bootstrap, CSS

Backend

• Python, FastAPI, FastAPI-Mail

Database

• MongoDB

---

🚀 Getting Started

Step 1: Clone the Repository

git clone https://github.com/Prakashsaw/FastAPI-CRUD-App.git

Step 2: Navigate to the Project Directory

cd FastAPI-CRUD-App

Step 3: Install Dependencies for Frontend & Backend

Frontend Setup

cd frontend
npm install

Backend Setup

1️⃣ Create a virtual environment:

python -m venv your_virtual_env_name

2️⃣ Activate the virtual environment:

# Windows
your_virtual_env_name\Scripts\activate

# macOS/Linux
source your_virtual_env_name/bin/activate

3️⃣ Install dependencies:

pip install -r requirements.txt

---

Step 4: Configure Environment Variables

Create a .env file in the backend directory and add the following environment variables:

MONGO_URI = 
DB_NAME = 

JWT_SECRET_KEY = 
JWT_ALGORITHM = 
JWT_ACCESS_SECRET_KEY = 
JWT_ACCESS_EXPIRY_MINUTES = 
JWT_REFRESH_SECRET_KEY = 
JWT_REFRESH_EXPIRY_DAYS = 

USER_SESSION_EXPIRY_MINUTES = 

MAIL_USERNAME = 
MAIL_PASSWORD = 
MAIL_FROM = 
MAIL_FROM_NAME = 
MAIL_PORT = 
MAIL_SERVER = 
MAIL_STARTTLS = 
MAIL_SSL_TLS = 
USE_CREDENTIALS = 
VALIDATE_CERTS = 

FRONTEND_HOST = http://localhost:3000 or https://your-deployed-domain.com
APP_NAME = 

---

Step 5: Run the Application

Start the Backend Server

• If the virtual environment is not activated, activate it first:

# Windows
your_virtual_env_name\Scripts\activate

# macOS/Linux
source your_virtual_env_name/bin/activate

• Run the FastAPI server:

uvicorn main:app --reload

Start the Frontend React App

cd frontend
npm run start

📌 Now, the Books Store app should be running locally!

---

✨ Features

• User Registration & Login with complete validation.
• Email Verification: Users receive a confirmation link via email to verify their account.
• Secure Authentication & Authorization:
  • Middleware ensures protected routes using JWT tokens.
  • Refresh tokens allow users to renew access tokens without re-logging in.
• Forgot Password: Users can reset their password if forgotten.
• Session Expiry Handling:
  • If an access token expires, users can refresh it without logging in again.
• CRUD Operations:
  • Users can add, edit, delete, and manage their favorite books.
• User Profile Management:
  • Users can update their profile details and change their password.

---

📸 Screenshots

Feature	Screenshot
User #
Email Verification Link Sent
Email Verification Confirmation
User Login
Forgot Password
Reset Password Link Sent
Reset Password
User Dashboard
Session Expiry & Token Refresh

---

👨‍💻 Made By

• @Prakashsaw

---

🐜 License

This project is licensed under the MIT License.
You are free to use, modify, and distribute this software as long as you include the original license.

---

🌟 If you like this project, don't forget to star the repo! ⭐