alfianchii/app-19-ukk

Welcome to Lidia! 👋

---

🤔 What is Lidia?

Library digital application with a modern and clean layout, this page features a striking hero section with a bold call-to-action, along with easy-to-scan service descriptions, reviews, and location sections.

🤨 What features are available in Lidia?

• Mazer Bootstrap Template
  • Dark and light mode
  • Dashboard UI
• Landing Page
  • Homepage
  • Feature
  • Service
  • Review
  • Location
  • Books
  • Book's genres
• Authentication
  • Registration
  • Login
• Multi User
  • Admin
    • Manageable users
    • Manageable books
    • Manageable book's genres
    • Overview all of data
    • Excel generator
  • Officer
    • Handling book receipts
    • Excel generator
  • Reader
    • Search books
    • Review books
    • Wishlist books
    • See their own receipts
  • All
    • Review to a book on Landing Page
    • Login
    • Logout
• Searchable Landing Page
  • Books
  • Book's genres

👤 Default account for testing

👨‍🏫 Admin

• Username: alfianchii
• Password: password

🧖 Officer

• Username: lolioverflow
• Password: password

🧗 Reader

• Username: moepoi
• Password: password

🏠 Demo page

The demo page is currently unavailable. Therefore, it is advisable for you to try it locally by following the installation steps below.

💾 Pre-requisite

Here are the prerequisites required for installing and running the application.

• PHP 8.2.8 & Web Server (Apache, Lighttpd, or Nginx)
• Database (MariaDB w/ v11.0.3 or PostgreSQL)
• Web Browser (Firefox, Safari, Opera, etc)

💻 Installation

🏃‍♂️ Develop by yourself

1. Clone repository

git clone https://github.com/alfianchii/assets-19-ukk
cd assets-19-ukk
composer install
npm install
cp .env.example .env

2. Database configuration through the .env file

APP_DEBUG=true
DB_DATABASE=db_19_ukk
DB_USERNAME=your-username
DB_PASSWORD=your-password

3. Migration and symlink

php artisan key:generate
php artisan storage:link
php artisan migrate --seed

4. Launch the website

npm run dev
# Run in different terminal
php artisan serve

🐳 Develop w/ Docker

• Clone the repository:

git clone https://github.com/alfianchii/assets-19-ukk
cd assets-19-ukk

• Copy .env.example file with cp .env.example .env and configure database:

APP_DEBUG=true
DB_HOST=mariadb
DB_DATABASE=db_19_ukk
DB_USERNAME=your-username
DB_PASSWORD=your-password

• Make sure you have Docker installed and run:

docker compose up --build -d

• Install dependencies:

docker compose run --rm composer install
docker compose run --rm npm install

• Laravel setups:

docker compose run --rm laravel-setup

• Run locally:

docker compose run --rm --service-ports npm run dev

• Pages
• • App: http://127.0.0.1
• • PhpMyAdmin: http://127.0.0.1:8888
• • MailHog: http://127.0.0.1:8025

🔐 Commands

• Composer

• • docker-compose run --rm composer install
• • docker-compose run --rm composer require laravel/breeze --dev
• • Etc

• NPM

• • docker-compose run --rm npm install
• • docker-compose run --rm --service-ports npm run dev
• • Etc

• Artisan

• • docker-compose run --rm artisan serve
• • docker-compose run --rm artisan route:list
• • Etc

🧍 Author

Lidia is created by Alfian.