{"id":23153773,"url":"https://github.com/hasnaintypes/Financely","last_synced_at":"2025-12-30T20:26:11.608Z","repository":{"id":264477084,"uuid":"893484470","full_name":"Nainee99/Financely","owner":"Nainee99","description":"Financely is a personal finance management application that helps users track their income, expenses, and investments. It is built using React for the frontend, Redux for state management, Firebase for authentication, and includes features for exporting and importing data in CSV format, as well as visualizing financial data through graphs.","archived":false,"fork":false,"pushed_at":"2024-11-24T15:21:51.000Z","size":319,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-10T02:14:58.781Z","etag":null,"topics":["csv","firebase","firebase-auth","firebase-database","reactjs","redux","redux-toolkit"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/Nainee99.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-11-24T15:12:23.000Z","updated_at":"2024-11-24T15:21:55.000Z","dependencies_parsed_at":"2024-11-24T16:26:53.843Z","dependency_job_id":"baeed1be-5338-4654-9001-4413e90409da","html_url":"https://github.com/Nainee99/Financely","commit_stats":null,"previous_names":["nainee99/financely"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nainee99%2FFinancely","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nainee99%2FFinancely/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nainee99%2FFinancely/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nainee99%2FFinancely/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nainee99","download_url":"https://codeload.github.com/Nainee99/Financely/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247214804,"owners_count":20902857,"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":["csv","firebase","firebase-auth","firebase-database","reactjs","redux","redux-toolkit"],"created_at":"2024-12-17T20:09:55.829Z","updated_at":"2025-12-30T20:26:11.524Z","avatar_url":"https://github.com/Nainee99.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Financely\n\nFinancely is a personal finance management application that helps users track their income, expenses, and investments. It is built using React for the frontend, Redux for state management, Firebase for authentication, and includes features for exporting and importing data in CSV format, as well as visualizing financial data through graphs.\n\n## Features\n\n- **User Authentication**: Secure login and registration using Firebase Authentication.\n- **Income and Expense Tracking**: Easily record and categorize your income and expenses.\n- **Investment Tracking**: Keep track of your investments and monitor their performance.\n- **Data Visualization**: View your financial data in intuitive graphs and charts.\n- **Export and Import**: Export your data to CSV files and import CSV files to update your records.\n- **Responsive Design**: Accessible on both desktop and mobile devices.\n\n## Technologies Used\n\n- **React**: A JavaScript library for building user interfaces.\n- **Redux**: A state management tool for JavaScript applications.\n- **Firebase Authentication**: A service that provides backend services, easy-to-use SDKs, and ready-made UI libraries to authenticate users.\n- **Chart.js**: A JavaScript library for creating beautiful charts.\n- **Papa Parse**: A powerful CSV parser that can handle large files.\n\n## Getting Started\n\nTo get a local copy of the project up and running, follow these steps:\n\n### Prerequisites\n\n- Node.js\n- npm or yarn\n\n### Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/Nainee99/financely.git\n   ```\n\n2. Navigate to the project directory:\n\n   ```bash\n   cd financely\n   ```\n\n3. Install dependencies:\n\n   ```bash\n   npm install\n   ```\n\n4. Create a `.env` file in the root of your project and add your Firebase configuration:\n\n   ```env\n   REACT_APP_API_KEY=your_api_key\n   REACT_APP_AUTH_DOMAIN=your_auth_domain\n   REACT_APP_PROJECT_ID=your_project_id\n   REACT_APP_STORAGE_BUCKET=your_storage_bucket\n   REACT_APP_MESSAGING_SENDER_ID=your_messaging_sender_id\n   REACT_APP_APP_ID=your_app_id\n   ```\n\n### Running the Application\n\n1. Start the development server:\n\n   ```bash\n   npm run dev\n   ```\n\n2. Open your browser and navigate to `http://localhost:3000`.\n\n## Usage\n\n- **Login/Register**: Use Firebase Authentication to create an account or log in.\n- **Dashboard**: View an overview of your financial status.\n- **Add Transactions**: Add your income, expenses, and investments.\n- **Visualize Data**: Use graphs and charts to get insights into your finances.\n- **Export Data**: Export your financial data to a CSV file.\n- **Import Data**: Import your financial data from a CSV file.\n\n## Demo\n\nHere are some screenshots of the **Financely** application:\n\n### Demo 1: Dashboard Overview\n![Demo 1](public/demo_1.png)\n\n### Demo 2: Income \u0026 Expense Tracker\n![Demo 2](public/demo_2.png)\n\n### Demo 3: Investment Tracker\n![Demo 3](public/demo_3.png)\n\n## Contributing\n\nContributions are welcome! Please fork the repository and use a feature branch. Pull requests are warmly welcome.\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for more details.\n\n## Contact\n\nIf you have any questions or suggestions, feel free to reach out to me at [nainee909@gmail.com](mailto:nainee909@gmail.com).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasnaintypes%2FFinancely","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasnaintypes%2FFinancely","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasnaintypes%2FFinancely/lists"}