{"id":25031855,"url":"https://github.com/ysskrishna/libmate","last_synced_at":"2026-04-12T15:02:33.061Z","repository":{"id":254481432,"uuid":"832235523","full_name":"ysskrishna/libmate","owner":"ysskrishna","description":"A full stack application for a library book vending application built with NextJS, TailwindCSS, FastAPI, Postgres and Docker. It is designed to manage book inventories, and member management, ensuring a seamless experience for borrowing and returning books through automated vending machines.","archived":false,"fork":false,"pushed_at":"2025-01-31T14:21:04.000Z","size":14066,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T22:53:04.322Z","etag":null,"topics":["alembic","docker","fastapi","inventory-management","javascript","library-management-system","library-software","logger","logger-middleware","nextjs","postgres","postgresql","react","sql","sqlalchemy","sqlite","tailwind","tailwindcss","web-application"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ysskrishna.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-07-22T15:38:28.000Z","updated_at":"2025-01-28T16:21:03.000Z","dependencies_parsed_at":"2024-09-05T23:49:07.310Z","dependency_job_id":"860d1e1a-e5fc-430f-8a3b-68c9bd78ea93","html_url":"https://github.com/ysskrishna/libmate","commit_stats":null,"previous_names":["ysskrishna/library-management-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysskrishna%2Flibmate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysskrishna%2Flibmate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysskrishna%2Flibmate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysskrishna%2Flibmate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ysskrishna","download_url":"https://codeload.github.com/ysskrishna/libmate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246368217,"owners_count":20766006,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["alembic","docker","fastapi","inventory-management","javascript","library-management-system","library-software","logger","logger-middleware","nextjs","postgres","postgresql","react","sql","sqlalchemy","sqlite","tailwind","tailwindcss","web-application"],"created_at":"2025-02-05T22:45:21.989Z","updated_at":"2026-04-12T15:02:32.956Z","avatar_url":"https://github.com/ysskrishna.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Library Management System\n\nA full stack application for a library book vending application. It is designed to manage book inventories, and member management, ensuring a seamless experience for borrowing and returning books through automated vending machines.\n\n\n## Media - User Portal\n\n\u003cvideo width=\"320\" height=\"240\" controls\u003e\n  \u003csource src=\"./media/libmate_user_demo.mp4\" type=\"video/mp4\"\u003e\n\u003c/video\u003e\n\n\nhttps://github.com/user-attachments/assets/beebd49a-4143-4efb-a8ec-5e95c4675e0a\n\n#### User - Login Page\n\u003cimg src=\"./media/user_login.JPG\" alt=\"User Login Page\"/\u003e\n\n#### User - Register Page\n\u003cimg src=\"./media/register.JPG\" alt=\"User Register Page\"/\u003e\n\n#### User - Dashboard Page\n\u003cimg src=\"./media/user_dashboard.JPG\" alt=\"User Dashboard Page\"/\u003e\n\n#### User - Search Page\n\u003cimg src=\"./media/user_search.JPG\" alt=\"User Search Page\"/\u003e\n\n#### User - Add Book to Cart Page\n\u003cimg src=\"./media/user_add_book_to_cart.JPG\" alt=\"User Add Book to Cart Page\"/\u003e\n\n#### User - Cart Page\n\u003cimg src=\"./media/user_cart.JPG\" alt=\"User Cart Page\"/\u003e\n\n\n## Media - Admin Portal\n\n\u003cvideo width=\"320\" height=\"240\" controls\u003e\n  \u003csource src=\"./media/libmate_admin_demo.mp4\" type=\"video/mp4\"\u003e\n\u003c/video\u003e\n\n\nhttps://github.com/user-attachments/assets/245bd896-74c6-43ae-9126-12d275c7b481\n\n#### Admin - Login Page\n\u003cimg src=\"./media/admin_login.JPG\" alt=\"Admin Login Page\"/\u003e\n\n#### Admin - Dashboard Page\n\u003cimg src=\"./media/admin_dashboard.JPG\" alt=\"Admin Dashboard Page\"/\u003e\n\n#### Admin - Add Book Page\n\u003cimg src=\"./media/admin_create_book.JPG\" alt=\"Admin Add Book Page\"/\u003e\n\n#### Admin - Update Book Page\n\u003cimg src=\"./media/admin_update_book.JPG\" alt=\"Admin Update Book Page\"/\u003e\n\n\n\n\n## Techstack used\n- NextJS\n- Redux Toolkit\n- Redux Persist\n- Tailwindcss\n- FastAPI\n- Postgres\n- Alembic\n- SQLAlchemy\n- Docker\n\n\n## Features\n\n- User Authentication\n  - Admin and User login functionality\n  - Secure credential management\n\n- Book Management\n  - Add, edit, and remove books from the library catalog\n  - Track book availability and loan status\n\n- User Management\n  - Register new library Admins and Users\n\n- Loan Management\n  - Check out and return books\n\n\n\n\n## Installation\n\nPrerequisites: Docker\n\n1. Clone the repository\n2. Run `docker compose -f docker-compose-production.yml up` to start the all instances\n3. Run `docker compose -f docker-compose-production.yml down` to stop the all instances\n4. Run `docker compose -f docker-compose-production.yml up --build` to build and start the all instances\n5. Frontend will be running on `http://localhost:3000`\n6. Backend will be running on `http://localhost:8081`\n7. Database will be running on `http://localhost:5432`\n\n\n\n## Usage\n\n### Admin Access\n- Email: admin@gmail.com\n- Password: admin\n\n### User Access\n- Email: john@gmail.com\n- Password: demo\n\n\n# License\n\nCopyright (c) 2024 [Y. Siva Sai Krishna](https://github.com/ysskrishna)\n\nThis project is licensed under the AGPL-3.0 License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fysskrishna%2Flibmate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fysskrishna%2Flibmate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fysskrishna%2Flibmate/lists"}