The Book Nook – Full-Stack Library Management System

Author: Basera Farah Abdulle
A full-stack Library Management System built with Javascript, Node.js/Express, and a modern web UI, designed to manage borrowing, returns, notifications, and multi-user workflows. This project demonstrates end-to-end system design, business logic implementation, and automated testing skills.

---

Key Features

• Full library lifecycle management: book catalog, borrowing, returns, hold queues, and notifications.
• Business logic implemented in Javascript with BDD acceptance tests.
• Exposed via Node.js/Express REST API for web interactions.
• Automated end-to-end testing using Cypress, validating workflows, borrowing limits, and notifications.
• Multi-user workflow support with consistent handling of concurrent operations.

---

Tech Stack

• Backend: Javascript, Node.js, Express
• Frontend: HTML, CSS, JavaScript
• Testing: Cypress for end-to-end UI testing, BDD for business logic validation

---

Cypress Testing Demo

TheBookNook_CypressTestingDemo.mp4

---

Setup Instructions

1. Clone the repository:

git clone git@github.com:bfabdulle/The-Book-Nook.git
cd The-Book-Nook

2. Install dependencies:

npm install

3. Start the server:

npm start

4. Open the application in your browser:

http://localhost:3000

Running Cypress Tests

You can run Cypress tests in two ways: interactively or in headless mode for CI/CD.

Open Interactive Test Runner

To open the Cypress Test Runner and run tests interactively:

npm run cy:open

Run Tests in Headless Mode (CI/CD Ready)

To execute all tests in headless mode (suitable for CI/CD pipelines):

npm run cy:run