mirror of
https://github.com/booklore-app/booklore.git
synced 2025-12-23 22:28:11 -05:00
Enhance README with Better Visual Appeal and Engagement (#141)
Co-authored-by: adityachandelgit <>
This commit is contained in:
49
README.md
49
README.md
@@ -1,15 +1,19 @@
|
||||
# BookLore
|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
BookLore is a self-hosted web app for organizing and managing your personal book collection. It provides an intuitive interface to browse, read, and track your progress across PDFs and eBooks. With robust metadata management, multi-user support, and a sleek, modern UI, BookLore makes it easy to build and explore your personal library.
|
||||
|
||||

|
||||

|
||||
|
||||
> ⚠️ **Warning:**
|
||||
> This project is in early development by a sole developer. Expect bugs, missing features, and frequent changes.
|
||||
> **Data Loss Risk:** Non-backwards compatible database changes may result in loss of metadata, such as book titles, authors, and reading progress. Your actual book files (PDFs and ePubs) are unlikely to be affected, but it's always a good idea to keep a backup of both your database and your book files.
|
||||
> **Limited Support:** As this is a one-person project, support may be slow, and features could be experimental or incomplete. Contributions and feedback are welcome!
|
||||
|
||||
## Key Features
|
||||
## ✨ Key Features
|
||||
- **Modern, Responsive UI** – A sleek, highly reactive, and fluent interface for a seamless reading experience.
|
||||
- **Organized Book Management** – Categorize books using Libraries and Shelves for better organization.
|
||||
- **Smart Metadata Handling** – Automatically fetch book details from sources like Goodreads, Amazon, and Google Books, or edit them manually.
|
||||
@@ -19,7 +23,7 @@ ## Key Features
|
||||
|
||||
BookLore is perfect for self-hosters who want complete control over their digital library. Stay tuned for updates!
|
||||
|
||||
## Video Guides & Tutorials
|
||||
## 🎥 Video Guides & Tutorials
|
||||
|
||||
For a step-by-step walkthrough, check out the official BookLore video guides on YouTube:
|
||||
|
||||
@@ -27,7 +31,7 @@ ## Video Guides & Tutorials
|
||||
|
||||
These videos cover deployment, configuration, and feature highlights to help you get started quickly.
|
||||
|
||||
## Deploy with Docker
|
||||
## 🐳 Deploy with Docker
|
||||
|
||||
You can quickly set up and run BookLore using Docker.
|
||||
|
||||
@@ -112,7 +116,7 @@ ### 5️⃣ First-Time Login
|
||||
> ⚠️ **Important:**
|
||||
> You’ll be prompted to change the default password upon your first login to ensure better security.
|
||||
|
||||
## Configuration
|
||||
## 🔧 Configuration
|
||||
|
||||
The following environment variables can be configured:
|
||||
|
||||
@@ -125,14 +129,37 @@ ## Configuration
|
||||
| DATABASE_USERNAME | Database username for app | `root` |
|
||||
| DATABASE_PASSWORD | Database password for app | **required** |
|
||||
|
||||
## Tech Stack
|
||||
## 🤝 Community & Support
|
||||
|
||||
- **Backend:** Spring Boot (Java)
|
||||
- **Frontend:** Angular (TypeScript)
|
||||
- **Database:** MariaDB
|
||||
- **Containerization:** Docker & Docker Compose
|
||||
- 🐞 Found a bug? [Open an issue](https://github.com/adityachandelgit/BookLore/issues)
|
||||
- ✨ Want to contribute? [Check out CONTRIBUTING.md](https://github.com/adityachandelgit/BookLore/blob/master/CONTRIBUTING.md)
|
||||
- 💬 Ask questions or share feedback: [Discussions](https://github.com/adityachandelgit/BookLore/discussions)
|
||||
|
||||
## License
|
||||
## 👨💻 Contributors & Developers
|
||||
|
||||
Thanks to all the amazing people who contribute to Booklore.
|
||||
|
||||
[](https://github.com/adityachandelgit/BookLore/graphs/contributors)
|
||||
|
||||
## ⭐ Star History
|
||||
|
||||
[](https://star-history.com/#adityachandelgit/BookLore&Date&theme=dark)
|
||||
|
||||
## 💖 Support the Project
|
||||
|
||||
If you find BookLore helpful, consider ⭐ starring the repo!
|
||||
|
||||
## 🧰 Tech Stack
|
||||
|
||||
<p align="left">
|
||||
<img src="https://img.shields.io/badge/Spring%20Boot-6DB33F?style=for-the-badge&logo=springboot&logoColor=white" alt="Spring Boot" style="margin-right: 10px;"/>
|
||||
<img src="https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white" alt="Angular" style="margin-right: 10px;"/>
|
||||
<img src="https://img.shields.io/badge/MariaDB-003545?style=for-the-badge&logo=mariadb&logoColor=white" alt="MariaDB" style="margin-right: 10px;"/>
|
||||
<img src="https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white" alt="Docker" style="margin-right: 10px;"/>
|
||||
</p>
|
||||
|
||||
## ⚖️ License
|
||||
|
||||
* [GNU GPL v3](http://www.gnu.org/licenses/gpl.html)
|
||||
* Copyright 2024-2025
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 612 KiB |
BIN
assets/demo.gif
Normal file
BIN
assets/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 10 MiB |
Reference in New Issue
Block a user