Skip to content

Add Mood Book Recommender mini appFeature/book recommendation app - #11104

Open
ananyabajpai729-ctrl wants to merge 7 commits into
dhairyagothi:Mainfrom
ananyabajpai729-ctrl:feature/book-recommendation-app
Open

ananyabajpai729-ctrl wants to merge 7 commits into
dhairyagothi:Mainfrom
ananyabajpai729-ctrl:feature/book-recommendation-app

Conversation

@ananyabajpai729-ctrl

Copy link
Copy Markdown

📝 Pull Request Description

Related Issue

Closes #10810

Summary

Adds a Mood Book Recommender mini app — users select a mood and get personalized book recommendations with cover images, descriptions, and "why this book" notes, can save favorites to a localStorage-backed "My Shelf," and can search/filter results by title or author.

Type of Change

  • 🐛 Bug fix (non-breaking change which fixes an issue)
  • ✨ New project addition
  • 🚀 New feature or UI/UX enhancement
  • ♻️ Code refactoring / clean-up
  • 📝 Documentation update
  • ⚙️ GitHub Workflow automation or DX improvements

🛠️ Changes Made

  • Added public/MoodBookRecommender/ with index.html, style.css, script.js, and books.json (a 36-book dataset spanning 9 moods)
  • Implemented mood-based filtering, dynamic book card rendering, live search/filter by title or author, and a "My Shelf" feature with save/remove backed by localStorage
  • Added active mood button highlighting and a subtle card entrance animation for polish
  • Added a fallback for missing book cover images (Open Library occasionally returns a blank placeholder image instead of a 404)
  • Added the corresponding entry to projects.json (projectNo: 247)

🧪 Testing and Verification

Local Validation

  • I have run node scripts/validateProjects.js locally and it passed with zero errors related to this project (one unrelated pre-existing error was found for a different project's file path)

Browser Compatibility Check

  • Tested and verified in Google Chrome
  • Tested and verified in Mozilla Firefox
  • Tested and verified in Safari / Microsoft Edge

Responsive & Accessibility Checks

  • Verified responsive layout on Mobile viewports (using DevTools)
  • Verified responsive layout on Tablet viewports
  • Keyboard navigation and focus outlines checked
  • Semantic HTML and ARIA labels checked (aria-label added on each major section)

📷 Screenshots / Video Recording

Mood Picker
image

Recommendations
image

My Shelf
image


🤝 Contributor Checklist

  • My code follows the code style guidelines of this project.
  • I have performed a self-review of my own code.
  • I have commented my code, particularly in hard-to-understand areas.
  • I have updated the documentation / README files accordingly.
  • My changes generate no new warnings or console errors (aside from the expected Tailwind CDN "not for production" dev notice, which is expected).
  • There are no unrelated changes or formatter noise in this PR.

@vercel

vercel Bot commented Aug 29, 2026

Copy link
Copy Markdown

@ananyabajpai729-ctrl is attempting to deploy a commit to the Dhairya Gothi 's projects Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions

Copy link
Copy Markdown
Contributor

Thank you for submitting your pull request! 🙌 We'll review it as soon as possible. In the meantime, please ensure that your changes align with our CONTRIBUTING.md. If there are any specific instructions or feedback regarding your PR, we'll provide them here. Thanks again for your contribution! 😊

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: [New Project] Book Recommendation Mini App with Mood-Based Suggestions

1 participant