Invoice Folder and Collection Grouping UI

[Kingsman-99]

Description

Users managing many invoices have no way to group or organize them beyond flat-list filtering. A folder/collection system lets users create named groups, assign invoices to one or more groups, and navigate the invoice list scoped to a selected group. This reduces cognitive overhead for teams that run concurrent projects or clients.

Technical Context

New route src/app/dashboard/folders/page.tsx and a FolderSidebar component in src/components/folders/. State managed via a Zustand slice or React Context in src/lib/store/foldersStore.ts. Invoice assignment stored in localStorage or a lightweight API route at src/app/api/folders/route.ts. The invoice list at src/app/dashboard/invoices/page.tsx gains a folderId query param to scope results. Tailwind accordion/disclosure pattern used for nested folder rendering.

Acceptance Criteria

• Users can create, rename, and delete named folders from the dashboard sidebar
• Any invoice can be assigned to one or more folders via a right-click context menu or an action in the multi-select toolbar
• Selecting a folder in the sidebar filters the invoice list to show only invoices in that group
• An "All Invoices" root item always shows the full unfiltered list
• Folder membership persists across page reloads
• All CI checks (npm test, npm run build, ESLint/TypeScript) pass and the branch has no merge conflicts

---

[Olamidepy]

@Olamidepy has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi Maintainer,

I would love to be assigned to this issue.

I’m a Full-Stack Developer and I also actively explore blockchain development and smart contracts, which has strengthened my problem-solving skills and attention to code quality.

After reviewing the issue, I believe I can contribute effectively and deliver a well-tested solution within the expected standards of the project.

ETA: 6 hours

Thank you for your consideration.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Olamidepy to this issue.

[Bayovictor]

@Bayovictor has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi, Please I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Bayovictor to this issue.

[unrealtim-tech]

@unrealtim-tech has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @unrealtim-tech to this issue.

[drips-wave]

Congratulations, @unrealtim-tech! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @unrealtim-tech: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@unrealtim-tech's PR #563 was approved and merged by @Kingsman-99.

🏆 @unrealtim-tech: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (341 total points). Track your full progress on GrantFox.

👏 Great work, @unrealtim-tech! Keep contributing to Stellar-split.

[drips-wave]

This issue has been completed by @unrealtim-tech as part of the Stellar Wave Program's 7th Wave 🥳

😎 @unrealtim-tech: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.