{"id":26482848,"url":"https://github.com/cltxvz/favelib","last_synced_at":"2026-04-16T04:02:53.931Z","repository":{"id":269465996,"uuid":"907481137","full_name":"cltxvz/faveLib","owner":"cltxvz","description":"A user-friendly library app to manage, track, and enjoy your favorite books!","archived":false,"fork":false,"pushed_at":"2025-02-03T18:46:30.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-17T14:41:26.357Z","etag":null,"topics":["book-tracker","css","data-structures","github-pages","html","interactive-ui","javascript","library-management","local-storage","object-oriented-programming","responsive-design","search-filter","sorting","web-application"],"latest_commit_sha":null,"homepage":"https://cltxvz.github.io/faveLib/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cltxvz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-23T17:17:45.000Z","updated_at":"2025-02-03T18:46:34.000Z","dependencies_parsed_at":"2025-08-17T14:32:09.969Z","dependency_job_id":"67397bd2-b683-45f1-94a1-56c18e00e605","html_url":"https://github.com/cltxvz/faveLib","commit_stats":null,"previous_names":["cltxvz/library-management-system","cltxvz/favelib"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cltxvz/faveLib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FfaveLib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FfaveLib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FfaveLib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FfaveLib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cltxvz","download_url":"https://codeload.github.com/cltxvz/faveLib/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cltxvz%2FfaveLib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31870516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["book-tracker","css","data-structures","github-pages","html","interactive-ui","javascript","library-management","local-storage","object-oriented-programming","responsive-design","search-filter","sorting","web-application"],"created_at":"2025-03-20T04:49:55.263Z","updated_at":"2026-04-16T04:02:53.913Z","avatar_url":"https://github.com/cltxvz.png","language":"JavaScript","readme":"# 📚 faveLib\n\n\"Your personal library to manage, track, and enjoy your favorite books!\"\n\n---\n\n## 🚀 Description:\n\n**faveLib** is an interactive web-based library management system that allows users to manage their personal book collection efficiently. Whether you're an avid reader, a book collector, or someone who wants to keep track of their reading habits, faveLib offers an intuitive interface to add, edit, categorize, rate, search, and export/import your books with ease.\n\n---\n\n## 🛠️ Technologies Used:\n\n- **Stack:** HTML, CSS, JavaScript  \n- **Core Libraries/Tools:**  \n  - LocalStorage API  \n  - FileReader API  \n  - Blob API  \n\n- **Version Control:** Git \u0026 GitHub  \n\n---\n\n## 📚 Skills \u0026 Concepts Applied:\n\n- **Object-Oriented Programming (OOP):**  \n  Implemented with classes and objects for modular and reusable code.  \n\n- **Data Structures:**  \n  Arrays for managing the book collection and categories.  \n\n- **Algorithms:**  \n  Search and sort algorithms for efficient filtering and organization of the book list.  \n\n- **State Management:**  \n  - Dynamic UI updates via JavaScript DOM manipulation.  \n  - State persistence with the LocalStorage API to retain data across sessions.  \n\n- **Error Handling:**  \n  - JSON validation during library import.  \n  - User feedback for invalid inputs in forms.  \n\n### **UI/UX Design Skills:**\n- **Responsive Design:**  \n  - Adaptive layout using CSS Grid and Flexbox for a seamless experience across devices.  \n  - Mobile-friendly modals and form layouts to enhance usability.  \n\n---\n\n## 📖 Instructions on How to Use faveLib:\n\nThis app is hosted on GitHub Pages, so you can start using it directly via the provided link.\n\nFeel free to use the provided JSON file `sample_books.json` on this repo if you don't want to start with an empty library!\n\n### **Features \u0026 How to Use Them:**\n\n#### **Add a New Book:**\n1. Click the \"Add New Book\" button.  \n2. Fill out the form with the following details:  \n   - Title  \n   - Author  \n   - Category  \n   - Rating  \n   - Read Status  \n   - Favorite Status  \n3. Click \"Add Book\" to save it to your library.  \n\n#### **Edit a Book:**\n1. Click the \"Edit\" button on a book card.  \n2. Modify any fields as needed.  \n3. Click \"Edit Book\" to save the changes.  \n\n#### **Delete a Book:**\n1. Click on the \"Delete\" button to permanently remove a book.  \n\n#### **Search, Filter, \u0026 Sort:**\n- **Search:**  \n  Enter a title or author name in the search bar.  \n\n- **Filter:**  \n  Filter books by:  \n  - All  \n  - Read  \n  - Unread  \n  - Favorites  \n\n- **Sort:**  \n  Sort books by:  \n  - Name  \n  - Rating  \n  - Category  \n  - Date (Oldest/Newest)  \n\n#### **Import/Export Library:**\n- **Import:**  \n  Load a previously saved JSON file to restore your library.  \n\n- **Export:**  \n  Save your library as a JSON file for backup or sharing.  \n\n#### **Clear Library:**\n1. Click \"Empty Library\" to reset the library.  \n\n---\n\n## 📊 Features:\n\n- **Add/Edit/Delete Books**  \n- **Dynamic Filtering and Sorting**  \n- **Custom Categories**  \n- **LocalStorage Persistence**  \n- **Import/Export JSON**  \n- **Responsive Design**  \n- **Book Count Display**  \n\n---\n\n## 📈 Ideas for Future Improvements:\n\n- **User Authentication:**  \n  Personalized libraries for each user.  \n\n- **External API Integration:**  \n  Integration with book APIs such as Google Books API to fetch book details automatically.  \n\n- **Enhanced Analytics:**  \n  Provide insights into reading habits and trends.  \n\n- **Cloud Synchronization:**  \n  Enable cross-device synchronization with cloud storage.  \n\n---\n\n## 📜 How to Run the Project Locally:\n\n1. Clone the repository:  \n   ```bash\n   git clone https://github.com/cltxvz/favelib.git\n   ```  \n\n2. Navigate to the project folder:  \n   ```bash\n   cd favelib\n   ```  \n\n3. Open the `index.html` file in your browser to start managing your personal library!  \n\n---\n\n## 👤 Author:\n\n**Carlos A. Cárdenas**  \n\nFeel free to reach out for collaboration or feedback!  \n\nIf you like this project, ⭐ star the repository and contribute to its growth. 🚀  \n\n---\n\nThank you for checking out **faveLib**! 📖✨ ","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcltxvz%2Ffavelib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcltxvz%2Ffavelib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcltxvz%2Ffavelib/lists"}