{"id":22928094,"url":"https://github.com/umarsaeedalam/cashflow-dojo","last_synced_at":"2025-05-13T01:52:12.034Z","repository":{"id":260233244,"uuid":"880384219","full_name":"umarsaeedalam/cashflow-dojo","owner":"umarsaeedalam","description":"Modern expense tracking application built with Next.js, featuring analytics, multi-currency support, and a sleek theme interface. Track, analyze, and master your financial habits. 💰","archived":false,"fork":false,"pushed_at":"2025-02-04T18:52:41.000Z","size":20024,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T13:35:59.776Z","etag":null,"topics":["authjs","mysql","nextjs","react","shadcn-ui","tailwind","typescript","vercel"],"latest_commit_sha":null,"homepage":"https://cashflowdojo.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/umarsaeedalam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-29T16:17:19.000Z","updated_at":"2025-02-04T18:52:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"d8be9676-0b96-48a3-b410-4e6d823d023e","html_url":"https://github.com/umarsaeedalam/cashflow-dojo","commit_stats":null,"previous_names":["umar-saeed-97/cashflow-dojo","umarsaeedalam/cashflow-dojo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umarsaeedalam%2Fcashflow-dojo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umarsaeedalam%2Fcashflow-dojo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umarsaeedalam%2Fcashflow-dojo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umarsaeedalam%2Fcashflow-dojo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/umarsaeedalam","download_url":"https://codeload.github.com/umarsaeedalam/cashflow-dojo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253856619,"owners_count":21974576,"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":["authjs","mysql","nextjs","react","shadcn-ui","tailwind","typescript","vercel"],"created_at":"2024-12-14T09:17:25.844Z","updated_at":"2025-05-13T01:52:12.019Z","avatar_url":"https://github.com/umarsaeedalam.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cashflow Dojo\n\nA personal portfolio project that delivers a modern, intuitive expense tracking application. Cashflow Dojo helps users take control of their finances through comprehensive expense monitoring, detailed spending analysis, and actionable insights into financial habits - all wrapped in a sleek, user-friendly interface.\n\n## 📸 Snippet\n\n![Cashflow Dojo Overview](/public/og-image.png)\n\n## ✨ Features\n\n### Comprehensive Expense Management\n- 🧾 Easy expense entry with detailed categorization\n- 📋 View, edit, and delete expense records\n- 🏷️ Diverse categorization system with 11 preset categories\n- 💼 Multi-currency support with 18 major currencies\n\n### Advanced Analytics\n- 📊 Interactive charts and visualizations\n- 📈 Monthly spending patterns analysis\n- 🎯 Category-wise expense breakdown\n- 💡 Smart insights on spending habits\n\n### User Experience\n- 🌙 Modern, clean interface\n- 📱 Fully responsive design for all devices\n- ⚡ Real-time updates and smooth transitions\n- 🔍 Advanced filtering and sorting capabilities\n\n### Security \u0026 Authentication\n- 🔒 Secure authentication via Google and GitHub\n- 🔐 Protected routes and data privacy\n- 👤 Personalized user profiles\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js 18.0 or higher\n- npm or yarn package manager\n- A modern web browser\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/umarsaeedalam/cashflow-dojo.git\n```\n2. Navigate to the project directory:\n```bash\ncd cashflow-dojo\n```\n3. Install dependencies\n```bash\nnpm install\n# or\nyarn install\n```\n4. Set up environment variables:\nCreate a `.env.local` file in the root directory and add the following variables:\n```bash\n# Auth Providers\nGOOGLE_CLIENT_ID=your_google_client_id\nGOOGLE_CLIENT_SECRET=your_google_client_secret\nGITHUB_CLIENT_ID=your_github_client_id\nGITHUB_CLIENT_SECRET=your_github_client_secret\n\n# Database\nDATABASE_URL=your_database_url\n\n# Auth\nNEXTAUTH_URL=http://localhost:3000\nNEXTAUTH_SECRET=your_nextauth_secret\n```\n5. Run the development server\n```bash\nnpm run dev\n# or\nyarn dev\n```\n6. Open http://localhost:3000 in your browser.\n\n## 🛠️ Tech Stack\n\n### Frontend\n- **Next.js** - React framework for production\n- **React** - UI library\n- **TypeScript** - Static typing\n- **Tailwind CSS** - Utility-first CSS framework\n- **shadcn/ui** - UI component library\n- **Recharts** - Chart library for data visualization\n- **React Hook Form** - Form handling\n- **Zod** - Schema validation\n\n### Authentication\n- **NextAuth.js** - Authentication solution\n- Support for Google and GitHub providers\n\n### Development Tools\n- ESLint - Code linting\n- Prettier - Code formatting\n- Husky - Git hooks\n- PostCSS - CSS processing\n\n## 📱 Responsive Design\n\nCashflow Dojo is built with a desktop-first approach, ensuring a seamless experience across all devices:\n\n## 🎨 Customization\n\n### Theme Configuration\n\nThe application uses a custom theme with the following color palette:\n\n```css\n:root {\n  --primary: #bde9c9;\n  --secondary: #2d8c47;\n  --accent: #ea5166;\n  --neutral: #fcf9e0;\n}\n```\n\n## 📝 Project Structure\n\n```\ncashflow-dojo/\n├── src/\n│   ├── app/                             # Next.js app directory\n│   ├── components/                      # React components\n│   │   ├── feature/                     # Feature-specific components\n│   │   │   ├── analytics/               # Analytics page components\n│   │   │   ├── expenses/                # Expenses page components\n│   │   │   └── overview/                # Overview page components\n│   │   ├── layout/                      # Layout components\n│   │   └── ui/                          # Reusable UI components\n│   │       ├── shadcn/                  # Shadcn UI components\n│   ├── fonts/                          # Custom font files\n│   ├── lib/                            # Core utility functions\n│   ├── styles/                         # Styling files\n│   └── utils/                          # Helper functions\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the repository\n2. Create your feature branch (git checkout -b feature/AmazingFeature)\n3. Commit your changes (git commit -m 'Add some AmazingFeature')\n4. Push to the branch (git push origin feature/AmazingFeature)\n5. Open a Pull Request\n\n## 📧 Contact\n\nIf you have any questions, feel free to reach out:\n\n- Email: umarsaeedalam@gmail.com\n- LinkedIn: www.linkedin.com/in/umarsaeedalam","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumarsaeedalam%2Fcashflow-dojo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumarsaeedalam%2Fcashflow-dojo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumarsaeedalam%2Fcashflow-dojo/lists"}