{"id":16222070,"url":"https://github.com/rajdip019/booklee","last_synced_at":"2025-07-24T02:33:39.999Z","repository":{"id":42998177,"uuid":"446064292","full_name":"Rajdip019/booklee","owner":"Rajdip019","description":"Booklee is a Web App, to sell and donate your second hand books at a minimal price or free of cost to help a needy learner, learn and grow more. This made it to the Finals of Microsoft Imagine Cup 2022","archived":false,"fork":false,"pushed_at":"2022-12-06T18:46:05.000Z","size":1819,"stargazers_count":22,"open_issues_count":5,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-03T02:35:06.046Z","etag":null,"topics":["azure","cognitive-services","cosmosdb","geocoding","geolocation","mapbox","mapbox-gl-js","next-auth","nextjs","react","sengrid","ssr","tailwind","tailwindcss","twillio","vercel"],"latest_commit_sha":null,"homepage":"https://booklee.vercel.app/","language":"JavaScript","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/Rajdip019.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}},"created_at":"2022-01-09T11:07:36.000Z","updated_at":"2025-02-22T16:21:41.000Z","dependencies_parsed_at":"2023-01-23T15:15:07.791Z","dependency_job_id":null,"html_url":"https://github.com/Rajdip019/booklee","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Rajdip019/booklee","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rajdip019%2Fbooklee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rajdip019%2Fbooklee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rajdip019%2Fbooklee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rajdip019%2Fbooklee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rajdip019","download_url":"https://codeload.github.com/Rajdip019/booklee/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rajdip019%2Fbooklee/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266785514,"owners_count":23983826,"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","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["azure","cognitive-services","cosmosdb","geocoding","geolocation","mapbox","mapbox-gl-js","next-auth","nextjs","react","sengrid","ssr","tailwind","tailwindcss","twillio","vercel"],"created_at":"2024-10-10T12:10:56.409Z","updated_at":"2025-07-24T02:33:39.971Z","avatar_url":"https://github.com/Rajdip019.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![image](https://user-images.githubusercontent.com/65490434/154921475-6b0b54ec-6268-48dd-bb97-619d3813b435.png)  \n\n# 0. Developer? Want to contribute?\n\nIf you want to contribute to Booklee then please click here. [Setup Guide in Local System](https://github.com/Rajdip019/booklee/blob/main/local_env_setup_guide.md)\n\nBut, before anything, We will highly suggest you to read what is Booklee. And what functionalities we have. And visit [Booklee](https://booklee.vercel.app/), and experience the web app once.\n\n# 1. What is Booklee ?  \n\nBooklee is a Web App, to sell and donate your second hand books at a minimal price or free of cost to help a needy learner, learn and grow more. \n\nYou can visit **_Booklee_** at [Booklee](https://booklee.vercel.app/)  \nWe have also added a **video guide**, on how to use Booklee [here](https://www.youtube.com/watch?v=ykNmo_W762E)  \n  \n \n# 2. All Features Available  \n\nWhen you land on the site, you'll see a lot of amazing features, ranging from the ability to login/sign-up , search for your favourite books, etc.  \nLet's go through them, one by one.\n\n## a. Sign-in / Sign-up  \n![image](https://user-images.githubusercontent.com/65490434/155150442-c0c9dbcb-5afe-4661-bb61-ee6c9f610786.png)  \n\nHere you can SignIn to our webiste or just Continue without Singing in. Even if you decide not to sign in, you can still continue and browse our awesome collection of books on the website.  \n\nThe website has sections like :  \n- Recently Added\n- Free Educational Books\n- Top Story Books\n  \nClick on the \"View All\" button, on any section to view _all_ the books in that section  \n\n## b. Searching  \n![image](https://user-images.githubusercontent.com/65490434/155150566-78d6c35d-0fa7-4749-ac4c-414547e1bef9.png)  \n\nYou also have the option of searching and filtering your search results according to (Category, Price, Condition \u0026 Location).  \nThis way you'll be able to find the correct book for you as fast as possible.\n\n## c. Product Details \n![image](https://user-images.githubusercontent.com/65490434/155150765-8c1c3747-72ec-44f2-a765-0bf2e2ec5d8a.png)  \n\nClick on any book, and you'll land on the product details page. Here, You'll see all the important and relevant details related to the book.  \n```diff\nYou need to be signed in to view all the seller details.  \n```\nYou can also see this Interactive Map, indicating the Location of the Book.  \n\n![image](https://user-images.githubusercontent.com/65490434/155151544-d9fbb30f-86ae-4eef-b5cc-8754ad70cf61.png)  \n\n# 3. Profile  \n\n## a. Donator / Seller Profile  \n![image](https://user-images.githubusercontent.com/65490434/155152543-d4d82ae8-d108-478d-b9c7-afc25c3d327b.png)  \n\nYou can visit the Profile of any of the Sellers and Donators on Booklee. You'll find all of books listed there. The books have also been filtered by the categories mentioned above.  \nYou can also see the books that have already been sold/donated by them in teh past.  \n\n## b. Signing In  \n\nYou'll be missing out on a lot if you're not signed in to the site. For example, you can't  \n- Send a direct mail to the Seller/Donator enquiring about any book.\n- Can't list any of your own books for selling/donating.\n- Can't Donate Books directly to an NGO.\n\n## \nSo, you chosen to sign in. Great!  \nWe offer you 3 easy options. You can choose to login from any of these accounts\n- Google\n- Twitter\n- Github  \n\n![image](https://user-images.githubusercontent.com/65490434/155153270-401de576-6a53-4815-accc-a2352b166734.png)  \n\n```diff\nDon't worry. We don't steal your data.  \nWe only require a username, email ID, and a profile photo.  \n```\nThis is what your homepage will now look like :-  \n\n![image](https://user-images.githubusercontent.com/65490434/155153464-00c1927a-d25c-49b7-818b-0c11a3f3a64b.png)  \n\n\n## Profle: Admin and Visitor  \nNow, in the Profile Section, you can control a lot of things. For example  \n- Managing the book that you've listed.\n- Get the 'Invoice' or 'Donation Proof' of all the books that you've donated/sold.\n- List books for selling/donating.\n- Edit your personal details (except email id 📫)  \n\n![image](https://user-images.githubusercontent.com/65490434/155155046-a676360d-8aee-4b41-9013-4a3b92a8ed27.png)  \n\n\n```diff\nIn Profile, there's also an Admin View and Visitor View Option. Using this, you can preview what your profile will look like to other visitors.\n```  \n\n# 4. Listing Books You want to Sell / Donate  \n\nIf you're already signed-in. You have the option to sell or donate your books using Booklee.  \nJust click on the 'Sell' or 'Donate' buttons on the Navbar from your homepage, or your profile page.  \n\n## a. Selling a Book  \n\n![image](https://user-images.githubusercontent.com/65490434/155155354-96ac20c8-7377-4349-9a03-2ab8f68f33da.png)  \n\nJust fill out the form, and click on SUBMIT to List your Book.  \n\n## b. Donating a Book  \n\n![image](https://user-images.githubusercontent.com/65490434/155155406-68812252-6fa1-455d-9dd9-527b4aac0b8e.png)  \n\nSame as sell. Just fill out the form, and click on SUBMIT to List your Book.  \n\n## c. Admin Panel  \n\nNow, after you've listed your book. You can also edit it.  \nJust go to your Profile Page, and Click on 'Manage Book'.  \nYou'll be directed to a page with the project details, and a Magical Admin Panel. Here, you can  \n- Edit the Book Details.\n- Mark it as Sold, and generate an Invoice / Donation Proof\n- Delete the Listed Book.\n- See the Book Details in 'Visitor View'  \n\n![image](https://user-images.githubusercontent.com/65490434/155155460-98df31f6-1bff-4f23-9695-229689a86dba.png)  \n\n\n## d. Marking a Book as Sold  \n If you are marking a book as sold, you need to follow the following steps :-  \n 1. Ask the Buyer/Donee to tell their email adress, which is registerd in Booklee and enter that in.  \n\n![image](https://user-images.githubusercontent.com/65490434/155659360-87130732-223c-4ddb-bf0b-4cc2ffee6d1d.png)  \n\n 2. Once the system checks the user is register or not, you will see a message according to that. If the User is not authenticated then you will see aa error message to Pop up as invalid User.  \n\n![image](https://user-images.githubusercontent.com/65490434/155659402-3d0e8ffd-b774-44db-a359-5639c3fa21e1.png)  \n\n\n 3. Or if the user is verified the system will pull the user data and show it on the modal with a verified mark!  \n 4. Now the Seller/Doner must click on “Get OTP” and ask the buyer/donee to tell the OTP Sent to their Email to get Verified and get a Invoice/Donation Proof.  \n\n![image](https://user-images.githubusercontent.com/65490434/155659438-e0e13d1f-2990-4ad4-953e-58924c1fb2f1.png)  \n\n\n 5. After entering the OTP click on Make Invoice to Make a invoice which the seller/Donator can get from his Profile in the Sold/Donated Section.  \n 6. And the Buyer/Donee will get the Invoice/Donation proof in Booklee Website in Your Orders Section. (*after sigining in with his email).  \n\n# 5. Favorites Section  \n\n![image](https://user-images.githubusercontent.com/65490434/155659476-c916a8dd-499a-4aab-bc55-3e6908af6fce.png)  \n\nYou can mark a book as your favourite book simply by clicking on the love icon on each card and can find them later in the Favorite Section.  \n\n# 6. Your Orders Section  \n\n![image](https://user-images.githubusercontent.com/65490434/155659778-39458164-1979-45eb-b96a-55cdda8361cc.png)  \n\nYou can find all of the Books you bought or got donated in the orders section.  \nFrom here you can get the invoice/donation proof by clicking on the “Get Invoice” and “Get Donation Proof” buttons respectively.  \n\n# 7. Invoice/Donation Proof  \n\n![image](https://user-images.githubusercontent.com/65490434/155659995-bf56a577-93c5-4736-8f49-82b2be6fcb4b.png)  \n\n On the invoice/Donation Proof Page you can save or print the Invoice/Donation Proof Directly from the Page.  \n\n # 8. Message  \n\n ![image](https://user-images.githubusercontent.com/65490434/155660041-0b429bf8-df33-4fd8-8bc1-dfa3c1695695.png)  \n\nIf you want to contact a seller regarding a doubt about the book, you can also do it here.  \nYou just have to enter the name of the book you have query about and write the query and the seller will receive an email about your query and can reply you back.  \n\n# 9. Donate to NGO  \n\nIf you decide to donate your old books to an NGO, you can click on “Donate To NGO” Button on the home Page or click on the Donate button on the Navbar and navigate to Donate to NGO then.  \n\nOnce you Click on Donate to NGO button, you will land on a Page where you can see the Total Books donated to NGO which is directly coming from the Azure Cosmos DB database.  \n\n![image](https://user-images.githubusercontent.com/65490434/155660120-12231948-601c-4886-b2c5-bc86a0204338.png)  \n\nNow on Clicking the Donate button you will be redirected to a form.  \n\n![image](https://user-images.githubusercontent.com/65490434/155660380-9c0ed499-ad8e-4b9d-8720-c855447dc15b.png)  \n\nNow After filling the form when you click on Submit, the System will find the Top 10 nearby NGO and will show the list with a interactive map which will point out the exact location of the NGO’s on the Map.  \n\n![image](https://user-images.githubusercontent.com/65490434/155660420-0387d23a-0024-48e0-86af-b1374ba13388.png)  \n\nNow after you choose your preffered NGO to donate book and click on Donate we will receive your info, The NGO, and the Book Details you want to Donate to the NGO.  \nThen, we will contact the NGO accordingly.  \n\n```diff\nThese are almost all the Features of the Website. There are still some features in the Website Which is pretty self explainatory so it’s not included here.  \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajdip019%2Fbooklee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frajdip019%2Fbooklee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajdip019%2Fbooklee/lists"}