feat: Add Custom Category Management to Quick Replies

[Kritika200520]

🚀 Program

GSSoC

📝 Description

Add custom category management to the Quick Replies drawer. This allows users to add, manage, and delete custom categories (e.g., "Work", "Family", "Medical") beyond the hardcoded list (General, Social, Needs, Urgent).

• Active categories list is stored in localStorage under vf_quick_reply_categories.
• Added inline "+ Category" input/form next to the category tabs in QuickReplies.jsx that updates tabs immediately.
• Custom categories are selectable in phrase creation/edition forms.
• Deleting a category moves its existing replies back to the default General category.
• Integrated the custom categories key into the Backup & Restore configuration page.

🔗 Related Issue

Closes #765
Fixes #765

🔄 Type of Change

• 🐛 Bug fix
• ✨ New feature
• 🔍 SEO improvement
• 🎨 Style / UI improvement
• ♿ Accessibility improvement
• 📝 Documentation
• ⚙️ CI / configuration
• 🧹 Refactor / cleanup

🧪 How to Test

1. Start local dev server.
2. Under "Quick Replies", click "Customize" and then click the + Category button to add a new category.
3. Add a new phrase and assign it to the newly created category.
4. Try deleting the custom category; verify that the tab is removed and the phrase is successfully relocated back to the "General" category.
5. Export/import configuration and verify the custom categories list is successfully restored.

✅ Checklist

• I am contributing under GSSoC, NSOC, SSOC, or ELUSOC
• My code follows the project's existing style
• I have tested my changes in a browser
• My PR title follows Conventional Commits format (e.g. feat: Add Custom Category Management to Quick Replies)

---

Summary by cubic

Adds custom category management to Quick Replies so users can organize replies beyond the fixed set. Previously categories were hardcoded; now users can add and delete categories inline, with persistence and cross-tab sync. Deleting a category moves its replies to “General”; default categories can’t be deleted.

• Add/delete categories from the tabs in edit mode with validation (non-empty, unique, not “All”, max 20 chars).
• Persist categories under vf_quick_reply_categories and sync across tabs/windows; invalid stored categories fall back to “General”.
• Use custom categories in create/edit forms; deleting a category reassigns its replies to “General”.
• Include quick-reply categories and vf_history_retention in Settings Backup & Restore.

^{Written for commit 20cf19d. Summary will update on new commits.}

Summary by CodeRabbit

• New Features

  • Create, rename, delete, and manage custom quick-reply categories.
  • Organize replies with dynamic category tabs and category selection.
  • Category settings persist across sessions and synchronize across browser tabs.

• Backup & Restore

  • Backups now include quick-reply categories and history-retention settings.

• Bug Fixes

  • Deleting a category moves its replies to “General” automatically.
  • Invalid or outdated category assignments are handled safely.

[vercel]

@Kritika200520 is attempting to deploy a commit to the itzzavdhesh's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

✍️ DCO Sign-off Needed

Hey @Kritika200520! 👋 One or more commits in this PR are missing a Signed-off-by: line.

Warning

• 98625f7 feat: Add Custom Category Management to Quick Replies
• dda0360 Merge upstream/main into feat/quick-replies-categories and resolve conflicts in QuickReplies.jsx
• 20cf19d Merge branch 'main' into feat/quick-replies-categories

How to fix:

For the latest commit:

git commit --amend --signoff
git push --force-with-lease

For multiple commits, replace N with the number to update:

git rebase --signoff HEAD~N
git push --force-with-lease

This comment will update automatically after you push.

---

_{🤖 VoiceForge Automation · Updates automatically on edits}

[github-actions]

🎉 PR Ready for Mentor Review

Hey @Kritika200520! 👋 Your PR passed all checks and is now in the GSSoC review queue.

Note

🔗 Closing: #765 · 📐 272 lines across 2 file(s) · 📬 Already requested or no eligible reviewer found

@sabeenaviklar @Anushreebasics @itsdakshjain @snehkris @Mrigakshi-Rathore @Itzzavdheshh @Nitya-003 @4f4d @lovestaco, this PR is ready for your review — please confirm scope, check behavior and tests, then approve or request changes.

Important

This is not an approval. Please wait for mentor feedback before expecting a merge. If changes are requested, push them to this same branch and keep the PR focused on the linked issue.

---

_{🤖 VoiceForge Automation · Updates automatically on edits}

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 456f3767-8229-4bb1-ba57-fd207ce2e62f

📥 Commits

Reviewing files that changed from the base of the PR and between dda0360 and 20cf19d.

📒 Files selected for processing (2)

• client/src/components/QuickReplies.jsx
• client/src/pages/Settings.jsx

---

📝 Walkthrough

Walkthrough

Quick replies now support user-defined categories stored in localStorage. Category changes synchronize across events, deleted-category replies move to “General,” and reply forms use dynamic categories. Settings backups include category and history-retention data.

Changes

Quick-reply categories

Layer / File(s)	Summary
Category persistence and synchronization client/src/components/QuickReplies.jsx	Categories load from and save to localStorage. Invalid data falls back to defaults. Category updates synchronize through storage and custom events. Reply restoration validates categories against the current category list.
Category management and reply assignment client/src/components/QuickReplies.jsx	Users can add or delete categories. Deleted-category replies move to “General.” Tabs and reply selectors use the dynamic category list. Removed drag-and-drop state declarations are no longer used by the updated category controls.
Settings backup and restore client/src/pages/Settings.jsx	Backup export and import now handle quick_reply_categories and historyRetention.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant QuickReplies
  participant localStorage
  participant Settings
  User->>QuickReplies: add or delete category
  QuickReplies->>localStorage: save category list
  QuickReplies-->>User: update tabs and reply selectors
  User->>Settings: export or import backup
  Settings->>localStorage: read or restore category data

Loading

Possibly related PRs

• itzzavdhesh/VoiceForge#87: Extends quick-reply persistence with customizable category management.
• itzzavdhesh/VoiceForge#198: Also modifies QuickReplies.jsx for category state, persistence, and dynamic selectors.
• itzzavdhesh/VoiceForge#243: Also modifies Settings.jsx backup and restore handling.

Suggested reviewers: anushreebasics, sabeenaviklar, snehkris

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	⚠️ Warning	The Quick Replies changes are in scope, but adding history-retention settings to backup data is unrelated to issue #765.	Remove the history-retention backup change, or link it to a separate issue with matching requirements.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: custom category management for Quick Replies.
Linked Issues check	✅ Passed	The changes implement dynamic storage, creation, selection, deletion, reassignment, and rendering of Quick Replies categories required by issue #765.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Biome (2.5.6)

client/src/pages/Settings.jsx

File contains syntax errors that prevent linting: Line 374: expected > but instead found <; Line 365: Expected corresponding JSX closing tag for 'input'.; Line 363: Expected corresponding JSX closing tag for 'label'.; Line 802: Unexpected token. Did you mean {'}'} or }?; Line 803: expected < but instead the file ends

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cubic-dev-ai]

All reported issues were addressed across 2 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[itsdakshjain]

Issue number not mentioned in description

[Itzzavdheshh]

Hi @Kritika200520 please mention the issue number in PR Description

[github-actions]

🎊 PR Merged Successfully

Hey @Kritika200520! 👋 Congratulations and thank you for your contribution to VoiceForge!

Note

🔗 Linked issue(s): #765 · ✅ Marked as merged and complete

Maintainers may still handle final cleanup, release notes, or follow-up tracking after the merge.

---

_{🤖 VoiceForge Automation · Updates automatically on edits}