Skip to content

README.md

Latest commit

 

History

History
224 lines (161 loc) · 5.22 KB

README.md

File metadata and controls

224 lines (161 loc) · 5.22 KB
Raw

Laravel Logo

📚 Library Management System

A web-based library management system built with Laravel 10, Jetstream, and Livewire.
Easily and securely manage book collections, borrowing transactions, categories, and user management.

✨ Features

✅ User Authentication & Management (Jetstream + Roles)
✅ Book & Category CRUD Operations
✅ Book Borrowing & Return System
✅ Book Stock Validation & Notifications
✅ Search & Category Filtering
✅ Complete Admin Dashboard
✅ Responsive & Modern UI
✅ QR Code Book Identification

🛠️ Technologies Used

Technology Version
Laravel 10.x
PHP 8.1+
Livewire Jetstream Stack
TailwindCSS Jetstream Default
Bootstrap (For Home UI)
MySQL/MariaDB Latest
DOMPDF Latest
Endroid/QRCode Latest

⚠️ Prerequisites

Make sure the following software is installed on your machine:

Software Download
PHP 8.1+ https://www.php.net/downloads.php
Composer https://getcomposer.org/download/
Node.js & npm https://nodejs.org/en/download/
Git https://git-scm.com/downloads
MySQL/MariaDB Included with XAMPP/Laragon

📚 Learning Resources

The main reference for this project comes from the YouTube tutorial series. Special thanks to the content creator for sharing their knowledge.

🚀 Installation & Setup

Follow the steps below in order.

1️⃣ Clone the Repository

Open your terminal (CMD, PowerShell, or Git Bash) and run:

git clone https://github.com/pangeran-droid/Library-System.git
cd Library-System

2️⃣ Install Laravel Dependencies (PHP)

composer install

⚠️ If Composer is not recognized, make sure it has been installed correctly.

3️⃣ Install Frontend Dependencies (Node.js)

Install the frontend dependencies and build the assets:

npm install
npm run build

⚠️ If npm is not recognized, make sure Node.js has been installed.

4️⃣ Copy the Environment File

cp .env.example .env

5️⃣ Generate the Application Key

php artisan key:generate

6️⃣ Configure the Database

Update your .env file:

DB_DATABASE=library_system
DB_USERNAME=root
DB_PASSWORD=

7️⃣ Run Database Migration

php artisan migrate
php artisan db:seed

8️⃣ Start the Development Server

After everything is configured, start the Laravel development server:

php artisan serve

The application will be available at:

http://127.0.0.1:8000

Open the URL in your browser to access the application.

🔐 Default Login Credentials

Admin Account

Email: admin@gmail.com
Password: password

User Account

Email: user@gmail.com
Password: password

👁️ Preview

Home Login
Register Dashboard

📄 License

This project is open-source and available under the MIT License.

See the LICENSE file for more details.

👥 Contributors