{"id":29629009,"url":"https://github.com/juleskuy/spendsense","last_synced_at":"2026-04-15T19:36:11.963Z","repository":{"id":296728653,"uuid":"994286288","full_name":"juleskuy/SpendSense","owner":"juleskuy","description":"SpendSense is a React and Next.js app for managing personal finances. Track income and expenses, view charts, and get AI-powered budget advice with real-time Firebase data.","archived":false,"fork":false,"pushed_at":"2025-06-03T16:41:29.000Z","size":281,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-01T11:53:35.019Z","etag":null,"topics":["ai","budgeting","finance","firebase","firestore","nextjs","personal-finance","react","tailwindcss","typescript","webapp"],"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/juleskuy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-01T16:10:41.000Z","updated_at":"2025-06-03T16:41:31.000Z","dependencies_parsed_at":"2025-06-02T01:58:21.378Z","dependency_job_id":"28b8c092-b94f-4324-92ae-70b0f40d1936","html_url":"https://github.com/juleskuy/SpendSense","commit_stats":null,"previous_names":["juleeeeee/spendsense","juleskuy/spendsense"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/juleskuy/SpendSense","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juleskuy%2FSpendSense","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juleskuy%2FSpendSense/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juleskuy%2FSpendSense/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juleskuy%2FSpendSense/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juleskuy","download_url":"https://codeload.github.com/juleskuy/SpendSense/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juleskuy%2FSpendSense/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266276093,"owners_count":23903981,"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":["ai","budgeting","finance","firebase","firestore","nextjs","personal-finance","react","tailwindcss","typescript","webapp"],"created_at":"2025-07-21T09:32:31.395Z","updated_at":"2025-10-18T10:48:15.774Z","avatar_url":"https://github.com/juleskuy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SpendSense\n\nSpendSense is a personal finance management web application designed to help users track their income and expenses, visualize their financial data through charts and overviews, and receive AI-powered budget advice. The app leverages Firebase for authentication and data storage, and provides a user-friendly interface built with React, Next.js, and Tailwind CSS.\n\n## Features\n\n- User authentication with Firebase Auth\n- Real-time transaction tracking with Firestore\n- Record income and expenses with detailed categories\n- Monthly and year-to-date financial overviews\n- Interactive spending and income vs. expense charts\n- Recent transactions list with edit and delete functionality\n- AI-powered budget advisor for personalized financial insights\n- Responsive and accessible UI with dialogs and toast notifications\n\n## Technologies Used\n\n- React 18 with Next.js 13 (App Router)\n- TypeScript for type safety\n- Firebase Authentication and Firestore database\n- Tailwind CSS for styling\n- Lucide React icons\n- Custom UI components for dialogs, cards, buttons, charts, and forms\n\n## Project Structure\n\n- `src/app/` - Main application pages and layouts\n- `src/components/` - Reusable UI components, including specific components and layout components\n- `src/contexts/` - React context providers, including authentication context\n- `src/hooks/` - Custom React hooks for toast notifications and other utilities\n- `src/lib/` - Utility functions and Firebase configuration\n- `src/types/` - TypeScript type definitions\n- `src/ai/` - AI-related logic and budget advisor flows\n\n## Setup and Installation\n\n1. Clone the repository:\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd SpendSense\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Configure environment variables:\n   - Copy the `.env.local.example` file to `.env.local`:\n     ```bash\n     cp .env.local.example .env.local\n     ```\n   - Update the `.env.local` file with your Firebase and Gemini API credentials.\n\n4. Configure Firebase:\n   - Set up a Firebase project.\n   - Enable Authentication and Firestore.\n   - Add your Firebase config to `src/lib/firebase.ts`.\n\n5. Run the development server:\n   ```bash\n   npm run dev\n   ```\n\n6. Open [http://localhost:3000](http://localhost:3000) in your browser.\n\n## Usage\n\n- Register or log in to your account.\n- Add income and expense transactions using the provided forms.\n- View your financial overviews and charts.\n- Use the AI Budget Advisor for personalized tips.\n- Edit or delete transactions as needed.\n\n## Authentication\n\n- Uses Firebase Authentication to manage user sign-in and sign-out.\n- User preferences such as currency and budgets are stored in Firestore.\n\n## Data Storage\n\n- Transactions and user preferences are stored in Firestore under each user's document.\n- Real-time updates are reflected in the UI using Firestore's onSnapshot listener.\n\n## AI Budget Advisor\n\n- Provides AI-powered budget advice based on user transactions.\n- Implemented in the `src/components/budgetwise/ai-budget-advisor.tsx` and related AI flow files.\n\n## UI and Styling\n\n- Built with React and Next.js using the App Router.\n- Styled with Tailwind CSS and custom UI components.\n- Includes dialogs, toast notifications, charts, and responsive layouts.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Author\n\nCreated with care by jule.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuleskuy%2Fspendsense","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuleskuy%2Fspendsense","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuleskuy%2Fspendsense/lists"}