{"id":24362159,"url":"https://github.com/francislagares/bookwise-app","last_synced_at":"2026-04-24T12:06:52.538Z","repository":{"id":272068466,"uuid":"915344259","full_name":"francislagares/bookwise-app","owner":"francislagares","description":"Production-Grade University Library Management System built with Next.js v15 and following industry-standard practices from rate-limiting, DDoS protection, caching, optimizations, multi-media uploads, complex db queries, and advanced error handling to automated workflows with custom notifications.","archived":false,"fork":false,"pushed_at":"2025-01-18T20:23:33.000Z","size":2824,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-18T22:49:25.002Z","etag":null,"topics":["drizzle-orm","nextjs15","postgresql","react19","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/francislagares.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":"2025-01-11T15:53:46.000Z","updated_at":"2025-01-18T20:23:35.000Z","dependencies_parsed_at":"2025-01-11T21:32:32.011Z","dependency_job_id":"2eb47de3-9a32-44d9-a012-9341aeb6e0d3","html_url":"https://github.com/francislagares/bookwise-app","commit_stats":null,"previous_names":["francislagares/bookwise-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/francislagares%2Fbookwise-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/francislagares%2Fbookwise-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/francislagares%2Fbookwise-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/francislagares%2Fbookwise-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/francislagares","download_url":"https://codeload.github.com/francislagares/bookwise-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243188237,"owners_count":20250457,"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":["drizzle-orm","nextjs15","postgresql","react19","typescript"],"created_at":"2025-01-18T22:50:00.030Z","updated_at":"2026-04-24T12:06:47.498Z","avatar_url":"https://github.com/francislagares.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv\u003e\n  \u003cbr /\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/7cff0964-6c02-4af5-aa0c-964b349cc9aa\" alt=\"Project Banner\"\u003e\n  \u003cbr /\u003e\n\n  \u003cdiv\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Next_JS-black?style=for-the-badge\u0026logoColor=white\u0026logo=nextdotjs\u0026color=000000\" alt=\"next.js\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-TypeScript-black?style=for-the-badge\u0026logoColor=white\u0026logo=typescript\u0026color=3178C6\" alt=\"TypeScript\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-PostgreSQL-black?style=for-the-badge\u0026logoColor=white\u0026logo=postgresql\u0026color=4169E1\" alt=\"postgresql\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Upstash-black?style=for-the-badge\u0026logoColor=white\u0026logo=upstash\u0026color=00E9A3\" alt=\"upstash\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Tailwind_CSS-black?style=for-the-badge\u0026logoColor=white\u0026logo=tailwindcss\u0026color=06B6D4\" alt=\"tailwindcss\" /\u003e\n  \u003c/div\u003e\n\n  \u003ch3 align=\"center\"\u003eA University Library Management System with Admin Panel\u003c/h3\u003e\n\n## Tech Stack\n\n- Next.js\n- PostgreSQL\n- Upstash\n- ImageKit\n- TypeScript\n- Resend\n- Tailwind CSS\n\n## \u003ca name=\"features\"\u003eFeatures\u003c/a\u003e\n\n### Features of the BookWise Library Management System Project\n\n👉 **Open-source Authentication**: Personalized onboarding flow with email\nnotifications.\n\n👉 **Home Page**: Highlighted books and newly added books with 3D effects.\n\n👉 **Library Page**: Advanced filtering, search, and pagination for book\ndiscovery.\n\n👉 **Book Detail Pages**: Availability tracking, book summaries, videos, and\nsuggestions for similar books.\n\n👉 **Profile Page**: Manage accounts, track borrowed books, and download\nreceipts.\n\n👉 **Onboarding Workflows**: Automated welcome emails when users sign up, with\nfollow-ups based on inactivity or activity dates.\n\n👉 **Borrow Book Reminder**: Customized email notifications sent before, on, and\nafter the due date, reminding users to return books or avoid charges.\n\n👉 **Borrow Book Receipt**: Automatically generates a customized PDF receipt\nwhen a book is successfully borrowed.\n\n👉 **Analytics Dashboard**: Statistics, new users, books, borrow requests, and\nmore.\n\n👉 **All Users Page**: View and manage users, including approving or revoking\naccess.\n\n👉 **Account Requests Page**: Admin approval for account requests, with email\nnotifications for user verification.\n\n👉 **All Books Page**: List and manage all library books with advanced search,\npagination, and filters.\n\n👉 **Book Management Forms**: Add new books and edit existing entries.\n\n👉 **Book Details Page**: Detailed book information for administrators.\n\n👉 **Borrow Records Page**: Complete borrow history with pagination and search.\n\n👉 **Role Management**: Change user roles to invite more admins, with email\nnotifications sent upon role updates.\n\n👉 **Advanced Functionalities**: Caching, rate-limiting, DDoS protection, and\ncustom notifications.\n\n👉 **Database Management**: Postgres with Neon for scalable and collaborative\ndatabase handling.\n\n👉 **Real-time Media Processing**: ImageKit for image and video optimization and\ntransformations.\n\n👉 **Efficient Caching**: Upstash Redis for caching, workflows, and triggers.\n\n👉 **Database ORM**: Drizzle ORM for simplified and efficient database\ninteractions.\n\n👉 **Modern UI/UX**: Built with TailwindCSS, ShadCN, and other cutting-edge\ntools.\n\n👉 **Technology Stack**: Next.js with TypeScript for scalable development, and\nNextAuth for robust authentication.\n\n👉 **Seamless Email Handling**: Resend for automated email communications,\nincluding notifications and updates.\n\n## \u003ca name=\"quick-start\"\u003eQuick Start\u003c/a\u003e\n\nFollow these steps to set up the project locally on your machine.\n\n**Prerequisites**\n\nMake sure you have the following installed on your machine:\n\n- [Git](https://git-scm.com/)\n- [Node.js](https://nodejs.org/en)\n- [pnpm](https://pnpm.io/) (Fast, disk space efficient package manager)\n\n**Cloning the Repository**\n\n```bash\ngit clone https://github.com/francislagares/bookwise-app.git\ncd bookwise-app\n```\n\n**Installation**\n\nInstall the project dependencies using pnpm:\n\n```bash\npnpm install\n```\n\n**Set Up Environment Variables**\n\nCreate a new file named `.env` in the root of your project and add the following\ncontent along with your accounts private keys:\n\n```env\nNEXT_PUBLIC_IMAGEKIT_PUBLIC_KEY=\nIMAGEKIT_PRIVATE_KEY=\nNEXT_PUBLIC_IMAGEKIT_URL_ENDPOINT=\n\nNEXT_PUBLIC_API_ENDPOINT=\nNEXT_PUBLIC_PROD_API_ENDPOINT=\n\nDATABASE_URL=\n\nUPSTASH_REDIS_URL=\nUPSTASH_REDIS_TOKEN=\n\nAUTH_SECRET=\n\n# Required for workflow\nQSTASH_URL=\nQSTASH_TOKEN=\n\n# RESEND_TOKEN=\nRESEND_TOKEN=\n```\n\nReplace the placeholder values with your actual ImageKit, NeonDB, Upstash, and\nResend credentials. You can obtain these credentials by signing up on the\n[ImageKit](https://bit.ly/49zmXkt), [NeonDB](https://fyi.neon.tech/1jsm),\n[Upstash](https://upstash.com/?utm_source=jsmastery1), and\n[Resend](https://resend.com/).\n\n**Running the Project**\n\n```bash\npnpm dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) in your browser to view the\nproject.\n\n# Author\n\nCreated by [@francislagares](https://www.linkedin.com/in/francislagares/) - feel\nfree to contact me!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrancislagares%2Fbookwise-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrancislagares%2Fbookwise-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrancislagares%2Fbookwise-app/lists"}