{"id":23360036,"url":"https://github.com/manuelalferez/flowinance","last_synced_at":"2025-10-30T22:20:37.139Z","repository":{"id":202746829,"uuid":"674908580","full_name":"manuelalferez/flowinance","owner":"manuelalferez","description":" An ultra-fast financial management app with automatic transaction categorization. ","archived":false,"fork":false,"pushed_at":"2024-12-16T19:29:05.000Z","size":488,"stargazers_count":30,"open_issues_count":27,"forks_count":34,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T09:21:12.574Z","etag":null,"topics":["chatgpt","finance","finance-management","hacktoberfest","hacktoberfest2024","nextjs","shadcn-ui","supabase","typescript"],"latest_commit_sha":null,"homepage":"https://flowinance.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manuelalferez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2023-08-05T06:08:28.000Z","updated_at":"2025-02-19T06:10:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"738cc586-d10d-4bb1-8c19-40d06f58fe5d","html_url":"https://github.com/manuelalferez/flowinance","commit_stats":null,"previous_names":["manuelalferez/flowinance"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalferez%2Fflowinance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalferez%2Fflowinance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalferez%2Fflowinance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalferez%2Fflowinance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manuelalferez","download_url":"https://codeload.github.com/manuelalferez/flowinance/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248199136,"owners_count":21063641,"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":["chatgpt","finance","finance-management","hacktoberfest","hacktoberfest2024","nextjs","shadcn-ui","supabase","typescript"],"created_at":"2024-12-21T11:12:52.794Z","updated_at":"2025-10-30T22:20:32.080Z","avatar_url":"https://github.com/manuelalferez.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flowinance\n\nA financial management app that uses AI for transaction categorization, helping users easily control and visualize their expenses, income, savings, and investments.\n\n\u003cimg width=\"1200\" alt=\"image\" src=\"https://github.com/user-attachments/assets/c2d40717-78e8-43e2-94d3-42b56fee8012\"\u003e\n\n## Getting Started\n\nFlowinance runs its database on Supabase. Supabase allows you to run a local instance, so you don’t have to worry about breaking the production database. First, we are going to configure Supabase locally, following the [documentation](https://supabase.com/docs/guides/local-development/cli/getting-started) that Supabase provides. In this example, **we will do it using a Mac**, but check their documentation for adapting it to your operating system.\n\n1. Install the Supabase CLI:\n   ```bash\n   brew install supabase/tap/supabase\n   ```\n2. The Supabase CLI uses Docker containers to manage the local development stack. [Install Docker](https://docs.docker.com/desktop/).\n3. Run Docker.\n4. Run Supabase locally:\n   ```bash\n   supabase start\n   ```\n5. Once all of the Supabase services are running, you'll see output containing your local Supabase credentials. Copy them into your `.env.local` file:\n\n   ```bash\n   Started supabase local development setup.\n\n           API URL: http://localhost:54321\n           DB URL: postgresql://postgres:postgres@localhost:54322/postgres\n       Studio URL: http://localhost:54323\n       Inbucket URL: http://localhost:54324\n           anon key: eyJh......\n   service_role key: eyJh......\n   ```\n\n6. You can check Supabase studio at http://localhost:54323\n   \u003cp align=\"center\"\u003e\n   \u003cimg src=\"https://supabase.com/docs/img/guides/cli/local-studio.png\" alt=\"Supabase Local Studio\" width=\"500\"\u003e\n   \u003c/p\u003e\n\n   When you are finished working on your Supabase project, you can stop the stack:\n\n   ```bash\n   supabase stop\n   ```\n\n7. Install dependencies:\n   ```bash\n   npm i\n   ```\n8. Flowinance uses [Prisma](https://www.prisma.io/) for handling the types and migrations of the database. If this is the first time you are setting up the project, generate the tables for your Supabase local instance:\n   ```bash\n   npx prisma migrate dev --name init\n   ```\n   \u003e You may get an error `Environment variable not found: DATABASE_URL`. To fix it, run:\n   ```bash\n   export DATABASE_URL=\"postgresql://postgres:postgres@localhost:54322/postgres\"\n   ```\n9. That's it! 🎉 Run Flowinance's development server and open [http://localhost:3000](http://localhost:3000):\n   ```bash\n   npm run dev\n   ```\n\n## Features\n- ✅ Display an overview of finances through a Dashboard\n- ✅ Artificial intelligence transaction categorization\n- ✅ Organized display of all transactions\n- ✅ End-to-end encryption\n- ✅ Multi-currency\n- ✅ Export all categorized transactions\n- Import all categorized transactions\n\n## Contributing\n\nWe would be really happy if you decide to contribute. Please read our [`CONTRIBUTING.md`](https://github.com/manuelalferez/flowinance/blob/main/CONTRIBUTING.md) guide before 😊\n\n## Join our community\n\nFeel free to join us: [Flowinance Discussions](https://github.com/manuelalferez/flowinance/discussions) for general questions, feature suggestions, or to engage with our community. \n\n## Ask me \n\nYou can always contact me via [Telegram](https://t.me/manuelalferez) if you want to talk more about the project 😊\n\n## License\n\n[GNU General Public License v3.0](https://github.com/manuelalferez/flowinance/blob/master/LICENSE.md)\n\n## Our Contributors\n\n\u003ca href=\"https://github.com/manuelalferez/flowinance/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=manuelalferez/flowinance\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanuelalferez%2Fflowinance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanuelalferez%2Fflowinance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanuelalferez%2Fflowinance/lists"}